Виртуальные ЦОДы
На странице собраны методы для управления виртуальными ЦОДами.
Создание виртуального ЦОДа POST /vdcs
Для создания виртуального ЦОДа необходимы следующие параметры:
- Параметры headers
- Параметры body
VDC_ALLOCATION_MODEL_UNSPECIFIED
PAY_AS_YOU_GO
ALLOCATION_POOL
CPU_RANGE_UNSPECIFIED
CPU_RANGE_2_1_MHZ
CPU_RANGE_2_4_MHZ
CPU_RANGE_2_6_MHZ
CPU_RANGE_2_9_MHZ
CPU_RANGE_OVER_2_6_MHZ
CPU_RANGE_OVER_3_5_MHZ
CPU_RANGE_UPTO_3_0_MHZ
STORAGE_TYPE_UNSPECIFIED
SSD
SAS
SATA
ENCRYPTED_SSD
ENCRYPTED_SATA
DR_SSD
DR_SATA
FAST_SSD
ENCRYPTED_FAST_SSD
DR_FAST_SSD
- Запрос
idempotency-key — ключ идемпотентности в формате UUID-4, обязательный. Сгенерировать ключ можно через любой сервис, например Online UUID Generator.
Параметр |
Тип |
Опциональность |
Описание |
---|---|---|---|
service_instance_id |
string($uuid) |
Обязательный |
Идентификатор тенанта |
allocation_model |
string[enum] |
Обязательный |
Тип тарификации: |
name |
string (mask: ^[a-zA-Z0-9_\-]{1,6}$) |
Обязательный |
Название виртуального ЦОДа |
user_comment |
string |
Опциональный |
Свободное поле |
description |
string |
Обязательный |
Описание виртуального ЦОДа |
cpu.quantity |
string($int64) minimum: 1 |
Обязательный |
Количество CPU, шт |
cpu.range |
string[enum] |
Обязательный |
Частота CPU: |
ram_size_gb |
string($int64) |
Опциональный |
Объем RAM, ГБ |
storages.type |
string[enum] |
Обязательный |
Тип хранилища: |
storages.size_gb |
string($int64) |
Обязательный |
Объем хранилища, ГБ |
storages.is_default |
boolean |
Обязательный |
Хранилище по умолчанию |
curl -- location 'https://vmware.api.cloud.ru/api/vmware-public/v1beta/vdcs' \-- header 'content-type: application/json' \-- header 'idempotency-key: 545b2fcc-8004-42ff-831b-3584978cabe2' \-- header 'Authorization: Bearer TOKEN' \-- data '{"service_instance_id" : "7e4c2391-25e1-47a3-b70f-20e2176dab2b" ,"name" : "vdc1" ,"description" : "test-description" ,"allocation_model" : "ALLOCATION_POOL" ,"cpu_range" : "CPU_RANGE_UPTO_3_0_MHZ" ,"cpu_quantity" : "1" ,"ram_size_gb" : "2" ,"storages" : [{"type" : "SSD" ,"size_gb" : "2" ,"is_default" : true}} '"user_comment" : "test-user-comment"} '
Получение списка виртуальных ЦОДов vdc GET /vdcs{service_instance_id}
Для запроса используются:
токен, полученный при аутентификации;
project_id, полученный со списком проектов.
- Запрос
curl --location 'https://vmware.api.cloud.ru/api/vmware-public/v1beta/vdcs?service_instance_id=7e4c2391-25e1-47a3-b70f-20e2176dab2b' \--header 'content-type: application/json' \--header 'Authorization: Bearer TOKEN'
Изменение типа тарификации PUT /vdcs/allocation-model
Для услуги виртуального ЦОДа доступно изменение типа тарификации. Для запроса необходимы следующие параметры:
- Параметры headers
- Параметры body
PAY_AS_YOU_GO
ALLOCATION_POOL
- Запрос
idempotency-key — ключ идемпотентности в формате UUID-4, обязательный. Сгенерировать ключ можно через любой сервис, например Online UUID Generator.
Параметр |
Тип |
Опциональность |
Описание |
---|---|---|---|
service_instance_id |
string($uuid) |
Обязательный |
Идентификатор тенанта |
resource_id |
string |
Обязательный |
Идентификатор виртуального ЦОДа |
allocation_model |
string |
Обязательный |
Тип тарификации, который нужно применить: |
curl --location --request PUT 'https://vmware.api.cloud.ru/api/vmware-public/v1beta/vdcs/allocation-model' \--header 'content-type: application/json' \--header 'idempotency-key: 7a0509fa-1001-4e16-ab81-c5b5a6ac9692' \--header 'Authorization: Bearer TOKEN' \--data '{"service_instance_id": "7e4c2391-25e1-47a3-b70f-20e2176dab2b","resource_id": "704c7c7d-df62-4d67-bfc8-ae747d958613","allocation_model": "PAY_AS_YOU_GO"}'
Изменение статуса виртуального ЦОДа PUT /vdcs/state
Доступно изменение статуса витруального ЦОДа — включен или выключен. Для запроса необходимы следующие параметры:
- Параметры headers
- Параметры body
Enabled
Disabled
- Запрос
idempotency-key — ключ идемпотентности в формате UUID-4, обязательный. Сгенерировать ключ можно через любой сервис, например Online UUID Generator.
Параметр |
Тип |
Опциональность |
Описание |
---|---|---|---|
service_instance_id |
string($uuid) |
Обязательный |
Идентификатор тенанта |
resource_id |
string |
Обязательный |
Идентификатор виртуального ЦОДа |
vdc_state |
string |
Обязательный |
Статус, который нужно применить: |
curl --location --request PUT 'https://vmware.api.cloud.ru/api/vmware-public/v1beta/vdcs/state' \--header 'content-type: application/json' \--header 'idempotency-key: 7a0509fa-1001-4e16-ab81-c5b5a6ac9692' \--header 'Authorization: Bearer TOKEN' \--data '{"service_instance_id": "7e4c2391-25e1-47a3-b70f-20e2176dab2b","resource_id": "704c7c7d-df62-4d67-bfc8-ae747d958613","state": "DISABLED"}'
Изменение количества CPU PUT /vdcs/cpu
Для запроса необходимы следующие параметры:
- Параметры headers
- Параметры body
- Запрос
idempotency-key — ключ идемпотентности в формате UUID-4, обязательный. Сгенерировать ключ можно через любой сервис, например Online UUID Generator.
Параметр |
Тип |
Опциональность |
Описание |
---|---|---|---|
service_instance_id |
string($uuid) |
Обязательный |
Идентификатор тенанта |
resource_id |
string |
Обязательный |
Идентификатор виртуального ЦОДа |
cpu_quantity |
string($int64) minimum: 1 |
Обязательный |
Новое значение количества CPU |
curl --location --request PUT 'https://vmware.api.cloud.ru/api/vmware-public/v1beta/vdcs/cpu' \--header 'content-type: application/json' \--header 'idempotency-key: 7a0509fa-1001-4e16-ab81-c5b5a6ac9693' \--header 'Authorization: Bearer TOKEN' \--data '{"service_instance_id": "7e4c2391-25e1-47a3-b70f-20e2176dab2b","resource_id": "704c7c7d-df62-4d67-bfc8-ae747d958613","cpu_quantity": "2"}'
Изменение объема RAM PUT /vdcs/ram
Для запроса необходимы следующие параметры:
- Параметры headers
- Параметры body
- Запрос
idempotency-key — ключ идемпотентности в формате UUID-4, обязательный. Сгенерировать ключ можно через любой сервис, например Online UUID Generator.
Параметр |
Тип |
Опциональность |
Описание |
---|---|---|---|
service_instance_id |
string($uuid) |
Обязательный |
Идентификатор тенанта |
resource_id |
string |
Обязательный |
Идентификатор виртуального ЦОДа |
ram_size_gb |
string($int64) |
Обязательный |
Новое значение объема RAM |
curl --location --request PUT 'https://vmware.api.cloud.ru/api/vmware-public/v1beta/vdcs/cpu' \--header 'content-type: application/json' \--header 'idempotency-key: 7a0509fa-1001-4e16-ab81-c5b5a6ac9693' \--header 'Authorization: Bearer TOKEN' \--data '{"service_instance_id": "7e4c2391-25e1-47a3-b70f-20e2176dab2b","resource_id": "704c7c7d-df62-4d67-bfc8-ae747d958613","ram_size_gb": "2"}'
Добавление хранилища PUT /vdcs/storages/add
Чтобы установить добавляемое хранилище как хранилище по-умолчанию, нужно выполнить отдельный запрос.
Для запроса на добавление хранилища необходимы следующие параметры:
- Параметры headers
- Параметры body
STORAGE_TYPE_UNSPECIFIED
SSD
SAS
SATA
ENCRYPTED_SSD
ENCRYPTED_SATA
DR_SSD
DR_SATA
FAST_SSD
ENCRYPTED_FAST_SSD
DR_FAST_SSD
- Запрос
idempotency-key — ключ идемпотентности в формате UUID-4, обязательный. Сгенерировать ключ можно через любой сервис, например Online UUID Generator.
Параметр |
Тип |
Опциональность |
Описание |
---|---|---|---|
service_instance_id |
string($uuid) |
Обязательный |
Идентификатор тенанта |
resource_id |
string |
Обязательный |
Идентификатор виртуального ЦОДа |
storages.type |
string[enum] |
Обязательный |
Тип хранилища: |
storages.size_gb |
string($int64) |
Обязательный |
Объем хранилища, ГБ |
curl --location --request PUT 'https://vmware.api.cloud.ru/api/vmware-public/v1beta/vdcs/storages/add' \--header 'content-type: application/json' \--header 'idempotency-key: 3a0509fa-1001-4e16-ab81-c5b5a6ac9693' \--header 'Authorization: Bearer TOKEN' \--data '{"service_instance_id": "7e4c2391-25e1-47a3-b70f-20e2176dab2b","resource_id": "704c7c7d-df62-4d67-bfc8-ae747d958613","type": "SATA","size_gb": "2"}'
Изменение объема хранилища PUT /vdcs/storages/size
Для запроса необходимы следующие параметры:
- Параметры headers
- Параметры body
- Запрос
idempotency-key — ключ идемпотентности в формате UUID-4, обязательный. Сгенерировать ключ можно через любой сервис, например Online UUID Generator.
Параметр |
Тип |
Опциональность |
Описание |
---|---|---|---|
service_instance_id |
string($uuid) |
Обязательный |
Идентификатор тенанта |
resource_id |
string |
Обязательный |
Идентификатор виртуального ЦОДа |
storage_id |
string |
Обязательный |
Идентификатор хранилища |
size_gb |
string($int64) minimum: 1 |
Обязательный |
Новое значение размера хранилища |
curl --location --request PUT 'https://vmware.api.cloud.ru/api/vmware-public/v1beta/vdcs/storages/size' \--header 'content-type: application/json' \--header 'idempotency-key: 7a0509fa-1001-4e16-ab81-c5b5a6ac9693' \--header 'Authorization: Bearer TOKEN' \--data '{"service_instance_id": "7e4c2391-25e1-47a3-b70f-20e2176dab2b","resource_id": "704c7c7d-df62-4d67-bfc8-ae747d958613","storage_id": "6220b3ad-1bbb-47cc-8bd7-bc030332daf3","size_gb": "2"}'
Установка хранилища по-умолчанию PUT /vdcs/storages/default
Если в виртуальном ЦОДе подключено только одно хранилище, оно всегда является хранилищем по-умолчанию.
Для запроса необходимы следующие параметры:
- Параметры headers
- Параметры body
- Запрос
idempotency-key — ключ идемпотентности в формате UUID-4, обязательный. Сгенерировать ключ можно через любой сервис, например Online UUID Generator.
Параметр |
Тип |
Опциональность |
Описание |
---|---|---|---|
service_instance_id |
string($uuid) |
Обязательный |
Идентификатор тенанта |
resource_id |
string |
Обязательный |
Идентификатор виртуального ЦОДа |
storage_id |
string |
Обязательный |
Идентификатор хранилища |
curl --location --request PUT 'https://vmware.api.cloud.ru/api/vmware-public/v1beta/vdcs/storages/size' \--header 'content-type: application/json' \--header 'idempotency-key: 7a0509fa-1001-4e16-ab81-c5b5a6ac9693' \--header 'Authorization: Bearer TOKEN' \--data '{"service_instance_id": "7e4c2391-25e1-47a3-b70f-20e2176dab2b","resource_id": "704c7c7d-df62-4d67-bfc8-ae747d958613","storage_id": "6220b3ad-1bbb-47cc-8bd7-bc030332daf3","size_gb": "2"}'
Удаление хранилища PUT /vdcs/storages/remove
Если в виртуальном ЦОДе подключено только одно хранилище или хранилище выбрано хранилищем по-умолчанию, удаление недоступно.
Для запроса необходимы следующие параметры:
- Параметры headers
- Параметры body
- Запрос
idempotency-key — ключ идемпотентности в формате UUID-4, обязательный. Сгенерировать ключ можно через любой сервис, например Online UUID Generator.
Параметр |
Тип |
Опциональность |
Описание |
---|---|---|---|
service_instance_id |
string($uuid) |
Обязательный |
Идентификатор тенанта |
resource_id |
string |
Обязательный |
Идентификатор виртуального ЦОДа |
storage_id |
string |
Обязательный |
Идентификатор хранилища |
curl --location --request PUT 'https://vmware.api.cloud.ru/api/vmware-public/v1beta/vdcs/storages/remove' \--header 'content-type: application/json' \--header 'idempotency-key: 4a0509fa-1001-4e16-ab81-c5b5a6ac9693' \--header 'Authorization: Bearer TOKEN' \--data '{"service_instance_id": "7e4c2391-25e1-47a3-b70f-20e2176dab2b","resource_id": "704c7c7d-df62-4d67-bfc8-ae747d958613","storage_id": "b4e548f2-8390-431e-a7b4-c53c4be95912"}'
Удаление виртуального ЦОДа DELETE /tenants{tenant_id}&{vdc_id}
Перед удалением виртуальный ЦОД нужно перевести в статус «Disabled».
Для запроса удаления необходимы следующие параметры:
- Параметры headers
- Запрос
Параметр |
Тип |
Опциональность |
Описание |
---|---|---|---|
service_instance_id |
string($uuid) |
Обязательный |
Идентификатор тенанта |
resource_id |
string |
Обязательный |
Идентификатор виртуального ЦОДа |
idempotency-key |
string |
Обязательный |
Ключ идемпотентности в формате UUID-4. Сгенерировать ключ можно через любой сервис, например Online UUID Generator |
curl --location --request DELETE 'https://vmware.api.cloud.ru/api/vmware-public/v1beta/tenants?service_instance_id=211d549f-0fd8-445a-a7e7-d8fdef19865f&resource_id=704c7c7d-df62-4d67-bfc8-ae747d958613' \--header 'accept: application/json' \--header 'idempotency-key: 124e2dd0-f4b2-4586-827c-3025f8930250' \--header 'Content-Type: application/json' \--header 'Authorization: Bearer TOKEN'
- Создание виртуального ЦОДа POST /vdcs
- Получение списка виртуальных ЦОДов vdc GET /vdcs{service_instance_id}
- Изменение типа тарификации PUT /vdcs/allocation-model
- Изменение статуса виртуального ЦОДа PUT /vdcs/state
- Изменение количества CPU PUT /vdcs/cpu
- Изменение объема RAM PUT /vdcs/ram
- Добавление хранилища PUT /vdcs/storages/add
- Изменение объема хранилища PUT /vdcs/storages/size
- Установка хранилища по-умолчанию PUT /vdcs/storages/default
- Удаление хранилища PUT /vdcs/storages/remove
- Удаление виртуального ЦОДа DELETE /tenants{tenant_id}&{vdc_id}