Создание сервера

Запрос

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

В теле запроса нужно передать JSON-словарь со следующими параметрами:

Параметр Тип Значение
name опциональный имя сервера, может быть автоматически сгенерировано
size обязательный уникальный идентификатор тарифа, т.е. slug (см. Тарифы)
image обязательный уникальный идентификатор образа, т.е. slug (см. Образы)
ssh_keys опциональный массив с идентификаторами загруженных SSH-ключей
curl \
-X POST \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "Sandbox", "size": "cloud-1", "image": "docker-18.03ce", "ssh_keys":["50:8c:26:58:b0:3c:96:24:14:e7:39:cb:2e:d8:5e:cd"]}' \
'https://api.cloudvps.reg.ru/v1/reglets'

Ответ

Ответ состоит из двух частей:

  • информация о добавленном сервере в ранее описанном формате

  • информация о задании (см. Очередь задач)

    {
        "links": {
            "actions": [
                {
                    "completed_at": "2018-07-12 02:33:09",
                    "id": 119153,
                    "region_slug": "msk1",
                    "resource_id": 6889,
                    "resource_type": "reglet",
                    "started_at": "2018-07-12 02:33:09",
                    "status": "in-progress",
                    "type": "create"
                }
            ]
        },
        "reglet": {
            "archived_at": null,
            "created_at": "2018-07-12 02:33:09",
            "disk": 10,
            "hostname": "193-124-206-117.cloudvps.regruhosting.ru",
            "id": 6889,
            "image": {
                "created_at": "2018-04-18 12:51:18",
                "distribution": "ubuntu-16.04",
                "id": 4597,
                "min_disk_size": 5,
                "name": "Docker 18.03.0-ce",
                "private": 0,
                "size_gigabytes": "1.7",
                "slug": "docker-18.03ce",
                "type": "application"
            },
            "image_id": 4597,
            "ip": "193.124.206.117",
            "ipv6": "2a00:f940:2:4:2::1",
            "locked": 1,
            "memory": 512,
            "name": "Sandbox",
            "old_id": null,
            "region_slug": "msk1",
            "resource_id": 6889,
            "service_id": 31386957,
            "size": {
                "disk": 10,
                "id": 5,
                "memory": 512,
                "name": "Cloud-1",
                "slug": "cloud-1",
                "vcpus": 1,
                "weight": 10
            },
            "size_slug": "cloud-1",
            "status": "new",
            "sub_status": null,
            "type": "reglet",
            "vcpus": 1
        }
    }
    

Создание сервера из снэпшота

Как уже говорилось ранее (см. Образы), с точки зрения внутреннего представления снэпшоты являются образами наравне с шаблонами операционных систем и приложений, поэтому создание сервера из снэпшота мало чем отличается от создания сервера из шаблона операционной системы.

Единственное различие - в параметре image необходимо передать уникальный идентификатор снэпшота, например:

curl \
-X POST \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{"name": "Sandbox", "size": "cloud-1", "image": 6655, "ssh_keys":["50:8c:26:58:b0:3c:96:24:14:e7:39:cb:2e:d8:5e:cd"]}' \
'https://api.cloudvps.reg.ru/v1/reglets'