VDC

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

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

POST https://console.sbercloud.ru/api/vmware-bff-api/console/vcloud/v1/vdc
Аутентификация

См. Аутентификация

Параметры headers

Content-Type

application/json

Accept

application/json

Параметры body

Параметр

Тип

Обязательный/опциональный

Описание

service_instance_id

string

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

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

name

string

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

Название виртуального ЦОД

description

string

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

Описание виртуального ЦОД

cpu_sku_int_name

string

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

Название SKU. Можно получить в ответе на запрос доступных частот CPU

allocation_model

string

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

Модель тарификации:

  • VDC_ALLOCATION_MODEL_UNSPECIFIED

  • ALLOCATION_POOL

tags[]

array [string]

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

Перечень тегов виртуального ЦОД

cpu_quantity

string

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

Количество ядер CPU

ram_size_gb

string

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

Объем оперативной памяти в ГБ

storages[]

array [objects]

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

Перечень виртуальных дисков

storages[]. type

string

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

Тип виртуального диска:

  • SSD

  • SAS

storages[]. size_gb

string

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

Объем диска в ГБ

storages[]. swap_size_gb

string

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

Объем swap-памяти на диске в ГБ

storages[]. is_default

boolean

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

Если значение равно true, виртуальный диск используется по умолчанию в виртуальном ЦОД

labels[]

array [string]

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

Перечень меток

Пример запроса
curl -L -X POST 'https://console.sbercloud.ru/api/vmware-bff-api/console/vcloud/v1/vdc' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer eyJhb...' \
--data-raw '{
  "service_instance_id": "e6e39...",
  "name": "test-vdc",
  "description": "test-vdc",
  "cpu_sku_int_name": "up_to_3.0",
  "allocation_model": ALLOCATION_POOL,
  "tags": [
    "test",
    "min"
  ],
  "cpu_quantity": 1,
  "ram_size_gb": 16,
  "storages": [
      {
          "type": "SSD",
          "size_gb": 100,
          "swap_size_gb": 0,
          "is_default": true
      }
    ]
}'
Пример успешного ответа
{
  "task_id": "dfebe..."
}
Пример ответа с ошибкой 500
{
  "code": 13,
  "message": "internal error",
  "details": []
}

GET список виртуальных ЦОД

GET https://console.sbercloud.ru/api/vmware-bff-api/console/vcloud/v1/vdc?service_instance_id={service_instance_id}
Аутентификация

См. Аутентификация

Параметры headers

Accept

application/json

Параметры query

Параметр

Тип

Обязательный/опциональный

Описание

service_instance_id

string

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

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

Пример запроса
curl --location --request GET 'https://console.sbercloud.ru/api/vmware-bff-api/console/vcloud/v1/vdc?service_instance_id=id=863f4...' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer eyJhb...'
Пример успешного ответа
{
 "alias": "TEST-SS",
 "region": "pd12",
 "tenant": {
  "name": "TEST-SS-2TbVYS6HN",
  "vdc_list": [
   {
    "id": "fba9f...",
    "name": "TEST-SS_01",
    "description": "",
    "provider": {
     "id": "71b5c...",
     "name": "lab-pclu01"
    },
    "network": {
     "id": "5fa746...",
     "name": "lab01-gnp01"
    },
    "allocation_model": "ALLOCATION_POOL",
    "tags": [],
    "cpu_quantity": "1",
    "cpu_freq_ghz": "3",
    "ram_size_gb": "2",
    "storages": [
     {
      "id": "9892f...",
      "name": "Gold",
      "type": "SSD",
      "size_gb": "3",
      "swap_size_gb": "0",
      "is_default": true
     }
    ],
    "state": "Enabled"
   }
  ]
 }
}
Пример ответа с ошибкой 500
{
  "code": 13,
  "message": "internal error",
  "details": []
}

PUT изменение объема ресурсов виртуального ЦОД

PUT https://console.sbercloud.ru/api/vmware-bff-api/console/vcloud/v1/vdc
Аутентификация

См. Аутентификация

Параметры headers

Content-Type

application/json

Accept

application/json

Параметры body

Параметр

Тип

Обязательный/опциональный

Описание

service_instance_id

string

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

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

id

string

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

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

tags[]

array [string]

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

Перечень тегов виртуального ЦОД

cpu_quantity

string

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

Количество ядер CPU

ram_size_gb

string

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

Объем оперативной памяти в ГБ

storages[]

array [objects]

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

Перечень виртуальных дисков

storages[]. type

string

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

Тип виртуального диска:

  • SSD

  • SATA

storages[]. id

string

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

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

storages[]. size_gb

string

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

Объем диска в ГБ

storages[]. swap_size_gb

string

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

Объем swap-памяти на диске в ГБ

storages[]. is_default

boolean

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

Если значение равно true, виртуальный диск используется по умолчанию в виртуальном ЦОД

Пример запроса
curl -L -X PUT 'https://console.sbercloud.ru/api/vmware-bff-api/console/vcloud/v1/vdc' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer eyJhb...' \
--data-raw '{
  "service_instance_id": "d9fbb...",
  "id": "fba9f...",
  "tags": [
     "test",
     "min"
   ],
  "cpu_quantity": "2",
  "ram_size_gb": "20",
  "storages": [
      {
        "id": "9892f...",
        "size_gb": "200"
      }
  ]
}'
Пример успешного ответа
{
  "task_id": "a9fbb..."
}
Пример ответа с ошибкой 500
{
  "code": 13,
  "message": "internal error",
  "details": []
}

PUT изменение состояния виртуального ЦОД

PUT https://console.sbercloud.ru/api/vmware-bff-api/console/vcloud/v1/vdc-state
Аутентификация

См. Аутентификация

Параметры headers

Content-Type

application/json

Accept

application/json

Параметры body

Параметр

Тип

Обязательный/опциональный

Описание

service_instance_id

string

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

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

vdc_id

string

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

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

state

string

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

Состояние виртуального ЦОД:

  • Enabled

  • Disabled

labels[]

array [string]

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

Перечень меток

Пример запроса
curl -L -X PUT 'https://console.sbercloud.ru/api/vmware-bff-api/console/vcloud/v1/vdc' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer eyJhb...' \
--data-raw '{
  "service_instance_id": "d9fbb...",
  "vdc_id": "fba9f...",
  "state": "Disabled"
}'
Пример успешного ответа
{
  "task_id": "a9fbb..."
}
Пример ответа с ошибкой 500
{
  "code": 13,
  "message": "internal error",
  "details": []
}

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

Примечание

Состояние удаляемого виртуального ЦОД должно быть «Disabled». См. PUT изменение состояния виртуального ЦОД.

DELETE https://console.sbercloud.ru/api/vmware-bff-api/console/vcloud/v1/vdc?service_instance_id={service_instance_id}&id={id}
Аутентификация

См. Аутентификация

Параметры headers

Accept

application/json

Параметры query

Параметр

Тип

Обязательный/опциональный

Описание

service_instance_id

string

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

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

id

string

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

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

labels[]

array [string]

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

Перечень меток

Пример запроса
curl -L -X DELETE 'https://console.sbercloud.ru/api/vmware-bff-api/console/vcloud/v1/vdc?service_instance_id=863f4...&id=12345...&labels=test&labels=min' \
-H 'Accept: application/json' \
-H 'Authorization: Bearer eyJhb...'
Пример успешного ответа
{
  "task_id": "a6ffb..."
}
Пример ответа с ошибкой 500
{
  "code": 13,
  "message": "internal error",
  "details": []
}
Масштабная конференция
GoCloud 2024:
облачные грани будущего