/DOCS
Облачная платформаОблако 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'
Поддержка Юридические документы
© 2026 Cloud.ru