Отправить запрос в алиас

Тип запроса в алиас зависит от вашей ноды. Вы можете отправить тестовый запрос в интерфейсе, если в ответе ожидаете получить простые данные, например числа или строковые переменные.

Отправьте тестовый запрос в алиас из интерфейса DataSphere:

1. Выберите нужный проект в своем сообществе или на главной странице DataSphere во вкладке Недавние проекты.

2. В блоке Ресурсы проекта выберите Алиас.
3. Выберите алиас, к которому нужно отправить запрос.
4. Перейдите на вкладку Запрос.
5. В блоке Создать тестовый запрос:
   • В поле Method выберите тип запроса.
   • В поле Входные значения введите входные переменные запроса в формате {"a":2,"b":3} и нажмите кнопку Выполнить.
6. Посмотрите результат обработки запроса в блоке Ответ.

Для отправки запросов в алиасы необходимо иметь роль datasphere.user или datasphere.admin на каталог, в котором созданы проект и алиас.

Пример вызова gRPC APIПример вызова gRPC API

Для отправки вызовов gRPC можно воспользоваться утилитой gRPCurl.

grpcurl \
  -H "Authorization: Bearer <IAM-токен>" \
  -d '{
  "folder_id": "<идентификатор_каталога>",
  "alias_name": "<имя_алиаса>",
  "input": { <входные_переменные> } \
  }' \
  datasphere.api.cloud.yandex.net:443
yandex.cloud.datasphere.v1.NodeService/ExecuteAlias

Где:

• <IAM-токен> — IAM-токен для аутентификации.
• <идентификатор_каталога> — идентификатор каталога, в котором созданы проект и алиас.
• <имя_алиаса> — имя алиаса.
• <входные_переменные> — объект в формате {"a":2,"b":3}, в котором ключи соответствуют входным переменным.

В успешном ответе будет возвращен объект:

{
   "output": {
      <выходные_переменные>
   }
}

Пример запроса REST APIПример запроса REST API

Для отправки REST-запросов можно воспользоваться утилитой cURL.

curl \
   --header "x-node-alias: datasphere.user.<имя_алиаса>" \
   --header "Authorization: Bearer <IAM-токен>" \
   --header "x-folder-id: <идентификатор_каталога>" \
   --request <тип_запроса> \
   --data '<входные_переменные>' \
   https://node-api.datasphere.yandexcloud.net/

Где:

• <имя_алиаса> — имя алиаса.
• <IAM-токен> — IAM-токен для аутентификации.
• <идентификатор_каталога> — идентификатор каталога, в котором созданы проект и алиас.
• <тип_запроса> — тип запроса в алиас.
• <входные_переменные> — объект в формате {"a":2,"b":3}, в котором ключи соответствуют входным переменным.

В ответ возвращается JSON-объект с выходными переменными.