Виртуальный ЦОД на базе VMware

Виртуальные ЦОДы

На странице собраны методы для управления виртуальными ЦОДами.

Создание виртуального ЦОДа POST /vdcs

Для создания виртуального ЦОДа необходимы следующие параметры:

Параметры headers

idempotency-key — ключ идемпотентности в формате UUID-4, обязательный. Сгенерировать ключ можно через любой сервис, например Online UUID Generator.

Параметры body

Параметр

Тип

Опциональность

Описание

service_instance_id

string($uuid)

Обязательный

Идентификатор тенанта

allocation_model

string[enum]

Обязательный

Тип тарификации:

  • VDC_ALLOCATION_MODEL_UNSPECIFIED

  • PAY_AS_YOU_GO

  • ALLOCATION_POOL

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:

  • 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

ram_size_gb

string($int64)

Опциональный

Объем RAM, ГБ

storages.type

string[enum]

Обязательный

Тип хранилища:

  • STORAGE_TYPE_UNSPECIFIED

  • SSD

  • SAS

  • SATA

  • ENCRYPTED_SSD

  • ENCRYPTED_SATA

  • DR_SSD

  • DR_SATA

  • FAST_SSD

  • ENCRYPTED_FAST_SSD

  • DR_FAST_SSD

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}

Для запроса используются:

Запрос
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

idempotency-key — ключ идемпотентности в формате UUID-4, обязательный. Сгенерировать ключ можно через любой сервис, например Online UUID Generator.

Параметры body

Параметр

Тип

Опциональность

Описание

service_instance_id

string($uuid)

Обязательный

Идентификатор тенанта

resource_id

string

Обязательный

Идентификатор виртуального ЦОДа

allocation_model

string

Обязательный

Тип тарификации, который нужно применить:

  • PAY_AS_YOU_GO

  • ALLOCATION_POOL
Запрос
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

idempotency-key — ключ идемпотентности в формате UUID-4, обязательный. Сгенерировать ключ можно через любой сервис, например Online UUID Generator.

Параметры body

Параметр

Тип

Опциональность

Описание

service_instance_id

string($uuid)

Обязательный

Идентификатор тенанта

resource_id

string

Обязательный

Идентификатор виртуального ЦОДа

vdc_state

string

Обязательный

Статус, который нужно применить:

  • Enabled

  • Disabled
Запрос
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

idempotency-key — ключ идемпотентности в формате UUID-4, обязательный. Сгенерировать ключ можно через любой сервис, например Online UUID Generator.

Параметры body

Параметр

Тип

Опциональность

Описание

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

idempotency-key — ключ идемпотентности в формате UUID-4, обязательный. Сгенерировать ключ можно через любой сервис, например Online UUID Generator.

Параметры body

Параметр

Тип

Опциональность

Описание

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

idempotency-key — ключ идемпотентности в формате UUID-4, обязательный. Сгенерировать ключ можно через любой сервис, например Online UUID Generator.

Параметры body

Параметр

Тип

Опциональность

Описание

service_instance_id

string($uuid)

Обязательный

Идентификатор тенанта

resource_id

string

Обязательный

Идентификатор виртуального ЦОДа

storages.type

string[enum]

Обязательный

Тип хранилища:

  • STORAGE_TYPE_UNSPECIFIED

  • SSD

  • SAS

  • SATA

  • ENCRYPTED_SSD

  • ENCRYPTED_SATA

  • DR_SSD

  • DR_SATA

  • FAST_SSD

  • ENCRYPTED_FAST_SSD

  • DR_FAST_SSD

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

idempotency-key — ключ идемпотентности в формате UUID-4, обязательный. Сгенерировать ключ можно через любой сервис, например Online UUID Generator.

Параметры body

Параметр

Тип

Опциональность

Описание

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

idempotency-key — ключ идемпотентности в формате UUID-4, обязательный. Сгенерировать ключ можно через любой сервис, например Online UUID Generator.

Параметры body

Параметр

Тип

Опциональность

Описание

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

idempotency-key — ключ идемпотентности в формате UUID-4, обязательный. Сгенерировать ключ можно через любой сервис, например Online UUID Generator.

Параметры body

Параметр

Тип

Опциональность

Описание

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'
Была ли статья полезной ?
Предыдущая статья
Тенанты
Следующая статья
Вспомогательные методы
/ DOCS
Облако VMware