Обращения к API сервиса «Виртуальные машины» по gRPC

Перед началом работы

1. Установите Git.

2. Установите Python.

3. Установите Postman.

4. Скачайте proto-файл с методами.

5. Получите токен доступа к API.

6. Клонируйте репозиторий API Google для работы с gRPC-конфигурациями:

   git clone https://github.com/googleapis/googleapis.git
   
   

Отправьте gRPC-запрос в Postman

1. Войдите в учетную запись Postman.

2. В интерфейсе Postman, напротив названия рабочего пространства, нажмите New → gRPC.

   Откроется окно для создания gRPC-запроса.

3. В поле Enter URL укажите эндпоинт для запросов — https://compute.api.cloud.ru.

4. Слева от адреса нажмите .

5. Перейдите на вкладку Authorization.

6. В поле Auth Type выберите Bearer Token.

7. В поле Token укажите значение параметра access_token из файла token.json, полученного перед началом работы.

   Внимание

   Не указывайте токен доступа напрямую в параметре запросов, для безопасности используйте переменные.

8. В поле Select a method выберите Import a .proto file → Choose a File.

   Откроется окно с файлами на вашем рабочем столе.

9. Выберите файл vms_api.proto, скачанный перед началом работы.

10. Укажите путь до директории googleapis со склонированным репозиторием API Google.

    После обработки файла в поле Select a method появятся методы для обращения к сервису «Виртуальные машины»:

    

11. В сервисе VirtualMachineService выберите метод List.

12. Откройте вкладку Message.

13. Нажмите Use Example Message.

    На вкладке Message появится шаблон запроса.

14. (Опционально) Чтобы посмотреть описание параметров выбранного метода, на панели справа нажмите .

15. Отредактируйте шаблон запроса и замените значения на свои, например:

    {
       "project_id": "example-aaaa-bbbb-cccc-724497bef515"
    }
    
    

    Где project_id — идентификатор вашего проекта.

16. Справа от выбора метода нажмите Invoke.

Результат