# Yandex Cloud API (IAM, Resource Manager, Compute Cloud): POST /compute/v1/instances — Создание виртуальной машины

Асинхронная операция; её можно отменить, пока она выполняется.

| Параметр | Где | Тип | Обяз. | Описание |
|---|---|---|---|---|
| `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 | нет | Сервисный аккаунт для аутентификации изнутри ВМ |

## Базовые URL

- IAM: `https://iam.api.cloud.yandex.net`
- Resource Manager: `https://resource-manager.api.cloud.yandex.net`
- Compute Cloud: `https://compute.api.cloud.yandex.net`
- Операции: `https://operation.api.cloud.yandex.net`

## Авторизация

Тип: Bearer-токен

Все запросы, кроме получения токена, передают IAM-токен в заголовке:

IAM-токен получают методом `POST /iam/v1/tokens` в обмен на OAuth-токен аккаунта на Яндексе или JWT сервисного аккаунта.

```
Authorization: Bearer <IAM-токен>
```

## Нюансы

- Каждая операция, изменяющая ресурс, возвращает объект Operation: `id`, `created_at`, `created_by`, `modified_at`, `done`, `metadata` и одно из полей `response`/`error`. Отслеживайте статус по `id`.
- `done: true` означает завершение операции, в том числе с ошибкой. Поле `error` может появиться раньше — пока сервис откатывает изменения.
- Для `Create`/`Update` поле `response` содержит созданный или изменённый ресурс.
- Числа int64 (`pageSize`, `memory`, `cores`) передаются строками.
- Пагинация: `pageSize` и `pageToken`, следующая страница — по `nextPageToken` из ответа.

## Сценарии с этим методом

- [Создать виртуальную машину и дождаться готовности](https://mcp-everything.ru/integrations/yandex-cloud/scenarios/sozdat-virtualnuyu-mashinu-i-dozhdatsya.md)

---

Если этого недостаточно — официальная документация: https://yandex.cloud/ru/docs/api-design-guide/
Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandex-cloud.md