ورود به پنل ثبت‌ نام
مستندات

سرور

در این صفحه

توضیحات

پایانه های مربوط به سرور در این قسمت قابل مشاهده‌اند.


لیست سرورها

از این پایانه می‌توانید لیست سرورهای خود را از ابر سپهر دریافت کنید.

اطلاعات درخواست

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 پیام سیستمی - نتیجه درخواست