سرور
در این صفحه
توضیحات
پایانه های مربوط به سرور در این قسمت قابل مشاهدهاند.
لیست سرورها
از این پایانه میتوانید لیست سرورهای خود را از ابر سپهر دریافت کنید.
اطلاعات درخواست
GET https://sepehr.cloud/api/v1/server/list
نمونه پارامترهای درخواست
برای دریافت لیست فیلتر شده، میتوانید پارامترهای مورد نظر را به پایانه مورد نظر اضافه کنید.
GET https://sepehr.cloud/api/v1/server/list?ip=192.168.1.1&geo=pnk
| پارامتر | نوع | توضیحات |
|---|---|---|
| ip | string | آیپی سرور (اختیاری) |
| geo | string | موقعیت فیزیکی سرور (اختیاری) |
نمونه بدنه پاسخ
[
{
"id": "uT6k92b",
"ip": "192.168.1.100",
"geo": "pnk",
},
{
"id": "i8GbJ52",
"ip": "192.168.1.101",
"geo": "mld",
},
]
پاسخ دریافت شده از نوع Array میباشد
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
| ip | string | آیپی سرور |
| geo | string | موقعیت فیزیکی سرور |
| status | string | وضعیت سرور |
اطلاعات سرور
از این پایانه میتوانید اطلاعات سرور خود را از ابر سپهر دریافت کنید.
اطلاعات درخواست
POST https://sepehr.cloud/api/v1/server/status
نمونه بدنه درخواست
{
"id": "uT6k92b"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
نمونه بدنه پاسخ
{
"id": "uT6k92b",
"ip": "192.168.1.100",
"geo": "pnk",
"status": "on",
"os": "ubuntu24",
"ipv6": "2001:db8:130f::9c0:876a:130b",
"port": "6658",
"user": "root",
"mac": "00:1A:2B:3C:4D:5E",
"ram": "2",
"cpu": "1",
"disk": "50",
"backup": "0",
"traffic_usage": "5.2",
"rescue_disk": true
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
| ip | string | آیپی سرور |
| geo | string | موقعیت سرور |
| status | string | وضعیت سرور |
| os | string | سیستم عامل |
| ipv6 | string | شناسه ipv6 |
| port | int | پورت |
| user | string | نام کاربری |
| mac | string | آدرس MAC |
| ram | int | حافظه |
| cpu | int | پردازنده |
| disk | int | فضای ذخیرهسازی |
| backup | int | بکآپ |
| traffic_usage | string | ترافیک مصرف شده |
| rescue_disk | boolean | true/false |
وضعیت سرور
از این پایانه میتوانید وضعیت سرور خود را به خاموش یا روشن تغییر دهید و یا دستور Reboot برای سرور ارسال کنید.
اطلاعات درخواست
POST https://sepehr.cloud/api/v1/server/action
نمونه بدنه درخواست
{
"id": "uT6k92b",
"action": "on|off|reboot"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
| action | string | وضعیت سرور |
نمونه بدنه پاسخ
{
"message": "درخواست شما ثبت شد"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| message | string | پاسخ سیستم به درخواست |
درخواست VNC
از این پایانه میتوانید برای اتصال به سرور از طریق VNC درخواست ارسال کنید.
اطلاعات درخواست
POST https://sepehr.cloud/api/v1/server/vnc
نمونه بدنه درخواست
{
"id": "uT6k92b"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
نمونه بدنه پاسخ
{
"hostname" : "examplevnc.sepehr.cloud"
"port": "8456",
"password": "kasfgas9fsgfbh"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| port | string | پورت |
| password | string | رمز عبور |
تغییر سیستم عامل
از این پایانه میتوانید برای تغییر سیستم عامل درخواست ارسال کنید.
اطلاعات درخواست
POST https://sepehr.cloud/api/v1/server/os
نمونه بدنه درخواست
{
"id": "uT6k92b",
"os": "ubuntu24"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
| os | string | شناسه سیستم عامل |
نمونه بدنه پاسخ
{
"password": "kasfgas9fsgfbh"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| password | string | رمز عبور |
تغییر رمز عبور
از این پایانه میتوانید برای تغییر رمز عبور درخواست ارسال کنید.
اطلاعات درخواست
POST https://sepehr.cloud/api/v1/server/password
نمونه بدنه درخواست
{
"id": "uT6k92b",
"password": "jlas74yaSfjb"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
| new_password | string | رمز عبور جدید |
نمونه بدنه پاسخ
{
"password": "jlas74yaSfjb"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| password | string | رمز عبور |
تغییر SSH KEY
از این پایانه میتوانید برای تغییر SSH KEY درخواست ارسال کنید.
اطلاعات درخواست
POST https://sepehr.cloud/api/v1/server/ssh-key
نمونه بدنه درخواست
{
"id": "uT6k92b",
"new_ssh_key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAABgQDNyA3OL4VONA2fHe1GetJP0k5pdQ35hM8lMj/riG/9ZD1RFfKHCO/ZRC8CHiEFEM7sOFcxHuqmwrdTfIy8jbafVRgZJi4n/crCnQK6sFMIFEx1VAF+JCA5q74Sa1l1Z6lu1r0kvn747idOnKxME9MGmkS+EN4QhJHOHPfEmT/cDBY4i0qnpBqkTDGCneMizkFJ9+SSymgbFAgdWd0s3JKAOTUAkDthVbF8r14mDttvLNEt4PBwIAFbD6LX5PCFd35Bqz8c+yMeju3EYTbIM/gSUM4JWGIVKYTg0ec0O28JIt0M2L02fNI1zrMmWJY7RQo9IebeDTG5qyWQyHTFmJgOPe1kn1NoFZ7koDMnP5Mjazq43ZMISdgeAelRmeymS2J33C980VMR+ezGR23RDY9TcTRYM5tKxD5Yw8k87Bls7sGUgfGjNSIMavN7GNFWXjFL3aExqgR1Ns9fZv+ZlI86g2FcyrVQB0nWmtVjd+Iwh76QldAp1cSUzct7MArWvqc= email@domain.com"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
| new_ssh_key | text | SSH KEY جدید |
نمونه بدنه پاسخ
{
'success' : true
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| new_ssh_key | text | SSH KEY جدید |
اسنپ شات
از این پایانه میتوانید برای ایجاد، ریستور، و مدیریت اسنپشاتها اقدام کنید.
اطلاعات درخواست
دریافت لیست اسنپشاتها
GET https://sepehr.cloud/api/v1/server/snapshot
نمونه بدنه درخواست
{
"id": "uT6k92b"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
نمونه بدنه پاسخ
[
{
"id": "uT6k92b",
"name": "snapshot-1"
},
{
"id": "uT6k92b",
"name": "snapshot-2"
},
]
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
| name | string | نام اسنپشات |
ایجاد اسنپشات
POST https://sepehr.cloud/api/v1/server/snapshot
نمونه بدنه درخواست
{
"id": "uT6k92b",
"name": "custom-snapshot-2"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | پیام سیستم |
| name | string | نام اسنپشات |
نمونه بدنه پاسخ
{
"message": "درخواست شما ثبت شد"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| message | string | پیام سیستم |
ریستور اسنپشات
PUT https://sepehr.cloud/api/v1/server/snapshot
نمونه بدنه درخواست
{
"id": "uT6k92b",
"name": "my-snapshot-2"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
| name | string | نام اسنپشات |
نمونه بدنه پاسخ
{
"message": "درخواست شما ثبت شد"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| message | string | پیام سیستم |
حذف اسنپشات
DELETE https://sepehr.cloud/api/v1/server/snapshot
نمونه بدنه درخواست
{
"id": "uT6k92b",
"name": "my-snapshot-2"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
| name | string | نام اسنپشات |
نمونه بدنه پاسخ
{
"message": "درخواست شما ثبت شد"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| message | string | پیام سیستم |
بکآپ
از این پایانه میتوانید برای ایجاد، ریستور، و مدیریت بکآپها اقدام کنید.
اطلاعات درخواست
دریافت لیست بکآپها
GET https://sepehr.cloud/api/v1/server/backup
نمونه بدنه درخواست
{
"id": "uT6k92b"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
نمونه بدنه پاسخ
[
{
"volume_id": "2025-11-30T14:04:58Z",
"date": "1404:09:09",
"size": "24075"
},
{
"volume_id": "2025-11-30T14:04:58Z",
"date": "1404:09:09",
"size": "24075"
},
]
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
| name | string | نام بکآپ |
ایجاد بکآپ
POST https://sepehr.cloud/api/v1/server/backup
نمونه بدنه درخواست
{
"id": "uT6k92b"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | پیام سیستم |
نمونه بدنه پاسخ
{
"message": "درخواست شما ثبت شد"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| message | string | پیام سیستم |
ریستور بکآپ
PUT https://sepehr.cloud/api/v1/server/backup
نمونه بدنه درخواست
{
"id": "uT6k92b",
"volume_id": "2025-11-30T14:04:58Z"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
| volume_id | string | نام بکآپ |
نمونه بدنه پاسخ
{
"message": "درخواست شما ثبت شد"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| message | string | پیام سیستم |
حذف بکآپ
DELETE https://sepehr.cloud/api/v1/server/backup
نمونه بدنه درخواست
{
"id": "uT6k92b",
"volume_id": "2025-11-30T14:04:58Z"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
| volume_id | string | نام بکآپ |
نمونه بدنه پاسخ
{
"message": "درخواست شما ثبت شد"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| message | string | پیام سیستم |
کاهش منابع
از این پایانه میتوانید برای کاهش منابع سرور درخواست ارسال کنید.
اطلاعات درخواست
POST https://sepehr.cloud/api/v1/server/downgrade
نمونه بدنه درخواست
{
"id": "jf78faSjm",
"ram": 3,
"cpu": 4,
"disk": 150,
"backup": 2
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
| ram | int | حافظه به گیگابایت |
| cpu | int | تعداد هسته پردازنده |
| disk | int | فضای ذخیره سازی به گیگابایت |
| backup | int | بکآپ |
نمونه بدنه پاسخ
{
"message": "درخواست شما ثبت شد"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| message | string | پیام سیستمی - نتیجه درخواست |
دیسک نجات
از این پایانه میتوانید برای قرار دادن دیسک های نجات درخواست ایجاد بفرمایید. طی این فرایند سرور شما ریبوت خواهد شد
اطلاعات درخواست
POST https://sepehr.cloud/api/v1/server/rescue
نمونه بدنه درخواست
{
"id": "jf78faSjm",
"name": "finnix"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
| name | string | finnix,systemrescue |
نمونه بدنه پاسخ
{
"message": "درخواست شما ثبت شد"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| message | string | پیام سیستمی - نتیجه درخواست |
از این پایانه میتوانید برای خارج کردن دیسک های نجات درخواست ایجاد بفرمایید. طی این فرایند سرور شما ریبوت خواهد شد
اطلاعات درخواست
POST https://sepehr.cloud/api/v1/server/eject
نمونه بدنه درخواست
{
"id": "jf78faSjm"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
نمونه بدنه پاسخ
{
"message": "درخواست شما ثبت شد"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| message | string | پیام سیستمی - نتیجه درخواست |
گراف منابع
از این پایانه میتوانید برای دریافت اطلاعات گراف درخواست ایجاد بفرمایید.
اطلاعات درخواست
POST https://sepehr.cloud/api/v1/server/graph
نمونه بدنه درخواست
{
"id": "jf78faSjm",
"period": "hour"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
| period | string | hour,day,week,month,year |
نمونه بدنه پاسخ
{
"message": "درخواست شما ثبت شد"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| message | string | پیام سیستمی - نتیجه درخواست |
| data | json | منابع به همراه زمان |
حذف سرور
از این پایانه میتوانید سرور را به طور کامل حذف بفرمایید. دقت بفرمایید بعد از اجرا سرور دیگر قابل بازیابی نخواهد بود اطلاعات درخواست
POST https://sepehr.cloud/api/v1/server/terminate
نمونه بدنه درخواست
{
"id": "jf78faSjm"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| id | string | شناسه سرور |
نمونه بدنه پاسخ
{
"message": "درخواست شما ثبت شد"
}
| پارامتر | نوع | توضیحات |
|---|---|---|
| message | string | پیام سیستمی - نتیجه درخواست |