Просмотр списка серверов

Запрос

Для того, чтобы получить список виртуальных серверов необходимо методом GET отправить запрос к /v1/reglets

curl \
-X GET \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
'https://api.cloudvps.reg.ru/v1/reglets'

Ответ

В результате запроса будет возращён JSON с массивом серверов, доступных по ключу reglets.

Каждый сервер представлен следующими параметрами:

Параметр

Значение

archived_at

дата удаления сервера

backups_enabled

подключено ли бекапирование (0 - нет, 1 - да)

created_at

дата создания сервера

disk

размер диска сервера, ГБ

hostname

хостнейм сервера

id

уникальный идентификатор сервера

image

данные об образе на сервере

image_id

уникальный идентификатор образа на сервере

ip

основной IP-адрес сервера

ipv6

IPv6-адрес сервера

locked

заблокирован ли сервер (0 - нет, 1 - да)

memory

объём памяти на сервере, МБ

name

имя сервера

ptr

PTR-запись

region_slug

уникальное читаемое имя региона

service_id

идентификатор услуги «Облачные VPS»

size

данные о тарифе на сервере

size_slug

читаемый идентификатор тарифа

status

статус сервера (см. ниже)

sub_status

подстатус сервера

vcpus

количество процессорных ядер

Примечание

В данный момент параметр service_id пользователями никак не используется, но в выводе присутствует. Он представляет собой уникальный идентификатор вашей панели управления

Статус сервера может принимать следующие значения:

Статус

Значение

new

сервер уже в базе, но еще не создан

active

сервер активен - создан и работает

off

сервер выключен (shutdown)

suspended

сервер приостановлен (недостаточно средств)

archive

архивный (удалён)

{
    "links": {
        "actions": []
    },
    "reglets": [
        {
            "archived_at": null,
            "created_at": "2018-07-12 02:40:27",
            "disk": 10,
            "hostname": "193-124-206-121.cloudvps.regruhosting.ru",
            "id": 6891,
            "image": {
                "created_at": "2017-10-31 10:55:48",
                "distribution": "ubuntu-16.04",
                "id": 3459,
                "min_disk_size": "10",
                "name": "Ubuntu 16.04 LTS",
                "private": 0,
                "region_slug":"msk1",
                "size_gigabytes": "2.4",
                "slug": "ubuntu-16-04-amd64",
                "type": "distribution"
            },
            "image_id": 3459,
            "ip": "193.124.206.121",
            "ipv6": "2a00:f40:2:4:2::1",
            "link_token":null,
            "locked": 0,
            "memory": 512,
            "name": "VNC",
            "ptr":"193-124-206-121.cloudvps.regruhosting.ru",
            "region_slug": "msk1",
            "service_id": 31386957,
            "size": {
                "archived":0,
                "disk": 10,
                "id": 5,
                "memory": 512,
                "name": "Cloud-1",
                "price":"0.00000",
                "price_month":"0.00000",
                "slug": "cloud-1",
                "vcpus": 1,
                "weight": 10
            },
            "size_slug": "cloud-1",
            "status": "active",
            "sub_status": null,
            "vcpus": 1
        }
    ]
}