Работать с сервисом «Виртуальные машины» можно при помощи gRPC — системы удаленного вызова процедур на основе протокола RPC.
RPC — это форма взаимодействия «клиент-сервер», в которой используется вызов функции вместо вызова HTTP.
В статье показан пример отправки gRPC-запроса на получение списка виртуальных машин в Postman.
Перед началом работы
Скачайте proto-файл с методами.
Получите токен доступа к API.
Клонируйте репозиторий API Google для работы с gRPC-конфигурациями:
git clone https://github.com/googleapis/googleapis.git
Отправьте gRPC-запрос в Postman
Войдите в учетную запись Postman.
В интерфейсе Postman, напротив названия рабочего пространства, нажмите New → gRPC.
Откроется окно для создания gRPC-запроса.
В поле Enter URL укажите эндпоинт для запросов — https://compute.api.cloud.ru.
Слева от адреса нажмите
.Перейдите на вкладку Authorization.
В поле Auth Type выберите Bearer Token.
В поле Token укажите значение параметра access_token из файла token.json, полученного перед началом работы.
ВниманиеНе указывайте токен доступа напрямую в параметре запросов, для безопасности используйте переменные.
В поле Select a method выберите Import a .proto file → Choose a File.
Откроется окно с файлами на вашем рабочем столе.
Выберите файл vms_api.proto, скачанный перед началом работы.
Укажите путь до директории googleapis со склонированным репозиторием API Google.
После обработки файла в поле Select a method появятся методы для обращения к сервису «Виртуальные машины»:
В сервисе VirtualMachineService выберите метод List.
Откройте вкладку Message.
Нажмите Use Example Message.
На вкладке Message появится шаблон запроса.
(Опционально) Чтобы посмотреть описание параметров выбранного метода, на панели справа нажмите
.Отредактируйте шаблон запроса и замените значения на свои, например:
{"project_id": "example-aaaa-bbbb-cccc-724497bef515"}Где project_id — идентификатор вашего проекта.
Справа от выбора метода нажмите Invoke.
Результат
При успешном выполнении запроса вернется ответ с кодом 0 OK.