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

Запрос¶

Примечание

Хотя тарифы plans и образы images доступны в v2 API, для фактического создания услуг серверов необходимо использовать только v1 API.

Получите актуальные данные через /v2/plans, /v2/images

Используйте их параметры в запросах к /v1/reglets

Для того, чтобы создать сервер, необходимо отправить запрос типа POST к /v1/reglets. В теле запроса нужно передать JSON-словарь со следующими параметрами:

Параметр	Тип	Значение
name	опциональный	имя сервера, может быть автоматически сгенерировано
size	обязательный	уникальный идентификатор тарифа, т.е. `slug` (см. Тарифы)
image	обязательный	уникальный идентификатор образа, т.е. `slug` (см. Образы)
ssh_keys	опциональный	массив с идентификаторами загруженных SSH-ключей
backups	опциональный	включить бэкапирование `true` (см. бэкапирование сервера)
isp_license_size	опциональный	тариф ISPmanager для заказа

Тариф ISPmanager может принимать следующие значения:

Статус	Значение
isp_lite6	до 10 доменов
isp_pro6	от 11 до 50 доменов
isp_host6	неограниченное число доменов

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

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"], "backups": "true"}' \
'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,
        "backups_enabled": "1",
        "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'