Асинхронная операция; её можно отменить, пока она выполняется.
| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
folderId |
body | string | да | ID каталога |
zoneId |
body | string | да | Зона доступности |
platformId |
body | string | да | Аппаратная платформа |
resourcesSpec.memory |
body | string | да | Объём памяти в байтах |
resourcesSpec.cores |
body | string | да | Число ядер |
resourcesSpec.coreFraction |
body | string | нет | Гарантированная доля vCPU: 0, 5, 20, 50, 100 |
resourcesSpec.gpus |
body | string | нет | Число GPU: 0, 1, 2, 4 |
bootDiskSpec |
body | object | да | Загрузочный диск: diskSpec (size, imageId, typeId) или diskId |
networkInterfaceSpecs |
body | array | да | Сетевые интерфейсы |
name |
body | string | нет | Имя ВМ |
description |
body | string | нет | Описание, до 256 символов |
labels |
body | object | нет | Метки ключ:значение |
metadata |
body | object | нет | Метаданные (в том числе пользовательские ключи) |
secondaryDiskSpecs |
body | array | нет | Дополнительные диски, до 3 |
hostname |
body | string | нет | Имя хоста |
schedulingPolicy |
body | object | нет | Политика планирования |
serviceAccountId |
body | string | нет | Сервисный аккаунт для аутентификации изнутри ВМ |
https://iam.api.cloud.yandex.nethttps://resource-manager.api.cloud.yandex.nethttps://compute.api.cloud.yandex.nethttps://operation.api.cloud.yandex.netТип: Bearer-токен
Все запросы, кроме получения токена, передают IAM-токен в заголовке:
IAM-токен получают методом POST /iam/v1/tokens в обмен на OAuth-токен аккаунта на Яндексе или JWT сервисного аккаунта.
Authorization: Bearer <IAM-токен>
id, created_at, created_by, modified_at, done, metadata и одно из полей response/error. Отслеживайте статус по id.done: true означает завершение операции, в том числе с ошибкой. Поле error может появиться раньше — пока сервис откатывает изменения.Create/Update поле response содержит созданный или изменённый ресурс.pageSize, memory, cores) передаются строками.pageSize и pageToken, следующая страница — по nextPageToken из ответа.Если этого недостаточно — официальная документация: https://yandex.cloud/ru/docs/api-design-guide/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandex-cloud.md