Методы в API

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

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

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

    Примечание

    Справочники gRPC API находятся в разработке и будут опубликованы в ближайшее время.