Выполнение действий над сервером

Для того, чтобы выполнить действие над сервером, необходимо отправить POST запрос по адресу https://api.1cloud.ru/server/{id}/action, где {id} - уникальный идентификатор сервера, над которым необходимо выполнить операцию.

Ответом будет JSON объект. Данный объект будет содержать атрибуты созданного задания. По данным атрибутам Вы сможете отслеживать состояние выполнения данной задачи.

Входные параметры

Название Тип Описание
TypestringТип задания, которое необходимо выполнить. Может иметь следующие значения:
  1. PowerOn: включить питание сервера
  2. PowerOff: выключить питание сервера
  3. ShutDownGuestOS: выключение сервера средствами операционной системы (Внимание: для корректной работы данного метода необходимо, чтобы на сервере были установленны и корректно работали VMware Tools. Если VMware Tools не функционируют, тогда будет выполнено выключение сервера по питанию.)
  4. PowerReboot: перезагрузить сервер
  5. AddNetwork: подключить сервер к сети
  6. RemoveNetwork: отключить сервер от сети
NetworkIDint?Уникальный идентификатор Вашей сети, к которой необходимо подключить\отключить сервер. Для общей публичной (Type = PublicShared) сети параметр должен быть равен null

Выходные параметры

Название Тип Описание
IDnumberУникальный идентификатор задания.
TypestringТип созданного задания. Для данного метода может быть равен "PowerOn", "PowerOff" или "PowerReboot".
StatestringСостояние выполнения задания. Может иметь следущие значения:
  1. InProgress: задача выполняется
  2. Completed: обработка задачи завершена
  3. Postponed: выполнение задачи отложено

Пример запроса

curl -X POST -H 'Content-Type: application/json' -H 'Authorization: Bearer 75bb9805c018b1267b2cf599a38b95a3a811e2ef7ad9ca5ed838ea4c6bafaf50' "https://api.1cloud.ru/Server/777/Action" -d '{"Type":"PowerOff"}'

Request Header

Content-Type: application/json Authorization: Bearer 75bb9805c018b1267b2cf599a38b95a3a811e2ef7ad9ca5ed838ea4c6bafaf50

Пример ответа

{
  "ID":777,
  "Type":"PowerOff",
  "State":"InProgress"
}