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

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

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

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

Название Тип Описание
Type string Тип задания, которое необходимо выполнить. Может иметь следующие значения:
  1. PowerOn: включить питание сервера
  2. PowerOff: выключить питание сервера
  3. ShutDownGuestOS: выключение сервера средствами операционной системы (Внимание: для корректной работы данного метода необходимо, чтобы на сервере были установленны и корректно работали VMware Tools. Если VMware Tools не функционируют, тогда будет выполнено выключение сервера по питанию.)
  4. PowerReboot: перезагрузить сервер
  5. AddNetwork: подключить сервер к сети
  6. RemoveNetwork: отключить сервер от сети
  7. EditNetworkBandwidth: изменить ширину канала для сети (доступно только для сети Type=PublicShared, максимальное значение- 100 Мбит/с, шаг - 10) 
NetworkID int

Уникальный идентификатор Вашей сети, к которой необходимо подключить\отключить сервер. Для общей публичной (Type = PublicShared) сети параметр должен быть равен null

NetworkLinkID int

Уникальный идентификатор подключения к сети. Обязательно используется при изменении ширины канала

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

Название Тип Описание
ID number Уникальный идентификатор задачи.
Type string Тип созданного задания
State string Состояние выполнения задания. Может иметь следущие значения:
  1. InProgress: задача выполняется
  2. Completed: обработка задачи завершена
  3. Postponed: выполнение задачи отложено
StartDate DateTime Дата старта задачи
EndDate DateTime Дата завершения задачи

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

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", "StartDate": "2018-02-04T21:18:43.107", "EndDate": "2018-02-04T21:28:43.107" }