Создать сервер

Для того, чтобы создать новый сервер, необходимо отправить POST запрос по адресу https://api.1cloud.ru/server.

Ответом будет JSON объект, данный объект будет содержать все атрибуты созданного сервера.

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

Название Тип Описание
NamestringПользовательское название сервера, заданное при создании сервера
CPUnumberКоличество ядер процессора, выделенных на данный сервер (в шт.). Минимальное значение: 1. Максимальное значение для базового пула 8, для высокопроизводительного - 24. Шаг увеличения значений: 1.
RAMnumberКоличество оперативной памяти, выделенной на данный сервер (в Mb). Минимальное значение: 512 (для Linux образов) и 1024 (для Windows образов). Максимальное значение для базового пула 16384, для высокопроизводительного - 131072. Шаг увеличения значений: до 1024 шаг 256, после 1024 шаг составляет 1024.
HDDnumberКоличество дискового пространства, выделенного на данный сервер (в Gb). Минимальное значение: 10 (для Linux образов) и 40 (для Windows образов). Максимальное значение: 250. Шаг увеличения значений: 10.
NetworkIDNumber (Необязательно) Идентификатор сети, к которой необходимо подключить сервер при создании. По умолчанию подключается к произвольной внешней общей сети
NetworkBandwidthNumber(Необязательно) Ширина канала для данного сервера в подключенной сети
ImageIDstringУникальный идентификатор образа сервера, из которого необходимо создать данный сервер. Идентификатор образа можно получить в результате выполения запроса: "Получить список доступных образов"
HDDTypestringТип диска сервера, может быть одним из следующих значений "SAS" или "SSD"
isHighPerformanceboolTrue - если необходим сервер в высокопроизводительном пуле, false - если нужен сервер в базовом пуле.
DCLocationstringТехническое наименование локации (ЦОД), в которой необходимо создать сервер (см. Метод "Список всех доступных локаций (ЦОД)". Если значение не указано, тогда сервер будет создан в локации СПБ.
isBackupActiveboolПодключено ли резервное копирование
BackupPeriodNumberГлубина хранения копий (7, 14, 21, 28 дней)
SshKeyslistСписок идентификаторов существующих SSH-ключей Список публичных SSH-ключей

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

Название Тип Описание
IDnumberУникальный идентификатор сервера
NamestringПользовательское название сервера, заданное при создании сервера
StatestringСтатус сервера на момент обработки запроса. Может содержать следующие значения:
  1. New: сервер создается
  2. Active: сервер создан
  3. Blocked: сервер заблокирован по причине отрицательного баланса на счете Клиента
  4. NeedMoney: сервер не создан, требуется иметь больше средств на счете для запуска процедуры создания сервера.
IsPowerOnboolСостояние питания сервера на момент выполнения запроса. Может содержать следующие значения:
  1. true: питание сервера включено
  2. false: питание сервера выключено
CPUnumberКоличество ядер процессора, выделенных на данный сервер (в шт.).
RAMnumberКоличество оперативной памяти, выделенной на данный сервер (в Mb).
HDDnumberКоличество дискового пространства, выделенного на данный сервер (в Gb).
IPstringВнешний IPv4 адрес данного сервера.
AdminUserNamestringИмя пользователя с правами администратора данного сервера. Внимание: Клиент вправе самостоятельно изменить имя пользователя средствами операционной системы и информация в данном параметре перестанет быть актуальной.
AdminPasswordstringПароль пользователя с правами администратора данного сервера. Внимание: Клиент вправе самостоятельно изменить пароль средствами операционной системы и информация в данном параметре перестанет быть актуальной.
ImagestringОбраз сервера, из которого был изначально создан данный сервер.
IsHighPerformanceboolTrue - если сервер в высокопроизводительном пуле, false - если сервер в базовом пуле.
HDDTypestringТип диска сервера, может быть одним из следующих значений "SAS" или "SSD"
LinkedNetworkslistСписок сетей, к которым подключен данный сервер. Содержит список объектов, каждый из которых имеет следующие атрибуты:
  1. LinkID: уникальный идентификатор подключения
  2. NetworkID: уникальный идентификатор сети
  3. LinkState: статус подключения
  4. NetworkType: тип сети (PublicShared, PrivateClient, PublicClient)
  5. NetworkName: название сети
  6. IP: IP адрес сервера в данной сети
  7. MAC: MAC адрес сервера в данной сети
  8. Mask: маска подсети
  9. Gateway: шлюз
  10. Bandwidth: ширина канала
DCLocationstringНаименование центра обработки данных, в котором размещен сервер.
ImageFamilystringТип операционной системы сервера, может быть одним из следующих значений "Linux", "Windows" или "Bsd"
LinkedSshKeyslistСписок с информацией по подключенным ssh-ключам:
  1. ID - идентификатор
  2. Title - наименование ключа
  3. PublicKey - содержимое ключа
  4. IsActive - активен ли ключ

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

    curl -X POST -H 'Content-Type: application/json' -H 'Authorization: Bearer 75bb9805c018b1267b2cf599a38b95a3a811e2ef7ad9ca5ed838ea4c6bafaf50' "https://api.1cloud.ru/Server" -d '{ "Name": "testapi1", "CPU": 8, "RAM": 16384, "HDD": 50, "ImageID": "3", "HDDType":"SSD", "isHighPerfomance":"true", "isBackupActive":"true", "BackupPeriod":"28", "SshKeys":[ 39 ] }'

    Request Header

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

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

    {
      "ID": 111111,
      "Name": "testapi1",
      "State": "New",
      "IsPowerOn": false,
      "CPU": 8,
      "RAM": 16384,
      "HDD": 50,
      "IP": null,
      "AdminUserName": null,
      "AdminPassword": null,
      "Image": "WinServer2012R2x64En",
      "IsHighPerformance": false,
      "HDDType": "SSD",
      "LinkedNetworks": [],
      "DCLocation": "SdnSpb",
      "ImageFamily": "Windows",
      "LinkedSshKeys": [
        {
          "ID": 39,
          "Title": "APISSH",
          "PublicKey": "AAAAB3NzaC1yc2EAAAABJQAAAQEAgSjJKQdYyhTFJyCkdZZXWcsdyjhBEsc1WsyaO/peXPnFMZqZ5cPrdE+Y5wATZibxFqS6+WguNjrSsg88uF/HPs9AS2fM2uLv7uP78XEqTshe4RpVF+N5Y5jzO1mt/uYvEK30yV1Q+oXwVrUL0wd/3EGc/qPKxoxluuWuSSQP9Mb/pEVClDECg0XyZIr9khbLAz79GfnnqHy59qf6UAz8VSYAOTGSnqlBCktJl1bEtAN4RIK2Qetz+3Rv9Iq55H+hI7b/FWOnFObB0AtJ6jFIslF1A9B3SgNPPgVZxZ2RDIsCkqrBvaS5azG4sG3owZbfwCyuFQ0+vSbcK/vASMAY5Q==",
          "IsActive": true
        }
      ]
    }