Методы в API
Для управления ресурсами в API Yandex.Cloud определен набор методов. Каждому gRPC-методу ставится в соответствие HTTP-глагол. Например, методу List
соответствует глагол GET
, а методу Create
— глагол POST
. Соответствия HTTP-запросам задаются в описании методов, в аннотации google.api.http.
В API есть два набора методов:
- Стандартные методы API позволяют выполнять CRUD-операции: создавать, получать, изменять и удалять ресурсы. Стандартные методы имеют одинаковую сигнатуру и работают одинаково для всех API.
- Дополнительные методы API расширяют функциональность стандартных методов. С их помощью можно выполнить такие операции, как подключить диск, перезапустить виртуальную машину и др. Сигнатура дополнительных методов отличается от сигнатуры стандартных методов.
Примечание
Справочники gRPC API находятся в разработке.