Yandex Cloud API (IAM, Resource Manager, Compute Cloud): GET /compute/v1/instances — Список виртуальных машин

Параметр	Где	Тип	Обяз.	Описание
folderId	query	string	да	ID каталога
pageSize	query	string	нет	Размер страницы
pageToken	query	string	нет	Токен следующей страницы
filter	query	string	нет	Фильтр: условия, объединённые AND
orderBy	query	string	нет	Сортировка, например createdAt desc; по умолчанию id asc

Базовые 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://yandex.cloud/ru/docs/api-design-guide/ Вся интеграция одним документом: https://mcp-everything.ru/integrations/yandex-cloud.md