Просмотр списка серверов¶
Запрос¶
Для того, чтобы получить список виртуальных серверов необходимо методом 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 } ] }