Методы в API

Для управления ресурсами в API Яндекс.Облака определен набор методов. Каждому gRPC-методу ставится в соответствие HTTP-глагол. Например, методу List соответствует глагол GET, а методу Create — глагол POST. Соответствия HTTP-запросам задаются в описании методов, в аннотации google.api.http.

В API есть два набора методов:

• Стандартные методы API позволяют выполнять CRUD-операции: создавать, получать, изменять и удалять ресурсы. Стандартные методы имеют одинаковую сигнатуру и работают одинаково для всех API.
• Дополнительные методы API расширяют функциональность стандартных методов. С их помощью можно выполнить такие операции, как подключить диск, перезапустить виртуальную машину и др. Сигнатура дополнительных методов отличается от сигнатуры стандартных методов.