Yandex Cloud
Документация
ПрезентацияСвязаться с намиНачать бесплатно
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»
Концепции API Yandex Cloud
KZ
  • Основные принципы
    • Обзор
    • Эндпоинты API
    • Стандартные методы
    • Дополнительные методы
    • Пагинация
    • Обработка ошибок
  1. Методы API
  2. Дополнительные методы

Дополнительные методы

Статья создана
Yandex Cloud
Обновлена 7 апреля 2025 г.
Открыть в Markdown

Дополнительные методы API позволяют выполнять операции, которые нельзя выполнить средствами стандартных методов. Например, запустить или остановить виртуальную машину.

Для каждого сервиса доступен свой набор дополнительных методов. Списки методов приведены в справочниках к соответствующим API.

Дополнительным методам ставится в соответствие HTTP-метод POST. Сигнатура дополнительных методов отличается от стандартной сигнатуры HTTP-методов. Название дополнительного метода указывается в URL ресурса, после знака :.

Пример gRPC-описания метода AttachDisk:

 rpc AttachDisk (AttachInstanceDiskRequest) returns (operation.Operation) {
   option (google.api.http) = {
     post: "/compute/v1/instances/{instance_id}:attachDisk" body: "*"
   };
   // В поле `metadata` объекта Operation
   // содержится представление `AttachInstanceDiskMetadata`.
   // В случае успешного завершения операции
   // в поле `response` объекта Operation
   // содержится представление измененной виртуальной машины.
   option (yandex.api.operation) = {
     metadata: "AttachInstanceDiskMetadata"
     response: "Instance"
   };
 }
 message AttachInstanceDiskRequest {
   // Идентификатор виртуальной машины, к которой
   // требуется подключить диск.
   string instance_id = 1;

   // Подключаемый диск.
   AttachedDiskSpec attached_disk_spec = 2;
 }

 message AttachInstanceDiskMetadata {
   // Идентификатор виртуальной машины,
   // к которой подключается диск.
   string instance_id = 1;

   // Идентификатор подключаемого диска.
   string disk_id = 2;
 }

Пример подключения диска в REST:

POST https://compute.api.yandexcloud.kz/compute/v1/instances/e0m97h0gbq0foeuis03:attachDisk

 {
   "attachedDiskSpec": {
     ...
   }
 }

Была ли статья полезна?

Предыдущая
Стандартные методы
Следующая
Пагинация
Создавайте контент и получайте гранты!Готовы написать своё руководство? Участвуйте в контент-программе и получайте гранты на работу с облачными сервисами!
Подробнее о программе
Проект Яндекса
© 2026 ТОО «Облачные Сервисы Казахстан»