Yandex Cloud
Search
Contact UsGet started
  • Blog
  • Pricing
  • Documentation
  • All Services
  • System Status
    • Featured
    • Infrastructure & Network
    • Data Platform
    • Containers
    • Developer tools
    • Serverless
    • Security
    • Monitoring & Resources
    • ML & AI
    • Business tools
  • All Solutions
    • By industry
    • By use case
    • Economics and Pricing
    • Security
    • Technical Support
    • Customer Stories
    • Cloud credits to scale your IT product
    • Gateway to Russia
    • Cloud for Startups
    • Education and Science
    • Yandex Cloud Partner program
  • Blog
  • Pricing
  • Documentation
© 2025 Direct Cursus Technology L.L.C.
Yandex DataSphere
  • Getting started
    • All guides
      • Creating a node
      • Updating a node
      • Deleting a node
      • Configuring a node environment
      • Sending a request to a node
      • Suspending or resuming a node
      • Creating an alias
      • Updating an alias
      • Deleting an alias
      • Sending a request to an alias
    • Migrating a workflow to a new version
  • Terraform reference
  • Audit Trails events
  • Access management
  • Pricing policy
  • Public materials
  • Release notes

In this article:

  • Sample gRPC API call
  • Sample REST API request
  1. Step-by-step guides
  2. DataSphere Inference
  3. Sending a request to a node

Sending requests to nodes

Written by
Yandex Cloud
Updated at October 28, 2024
  • Sample gRPC API call
  • Sample REST API request

Send a test request to a node from the DataSphere interface:

  1. Select the relevant project in your community or on the DataSphere homepage in the Recent projects tab.

  2. Under Project resources, select Node.
  3. Select the node to send a request to.
  4. Go to the Request tab.
  5. Under Create test request, in the Input field, enter the request input variables in {"a":2,"b":3} format and click Execute.
  6. View the request processing results under Response.

Note

The cURL section contains sample requests to a node for the cURL and gRPCurl utilities.

The Server response section provides sample code and node response descriptions.

To send requests to nodes, you must have the datasphere.user or datasphere.admin role for the folder where the project and node were created.

Sample gRPC API callSample gRPC API call

grpcurl \
  -H "Authorization: Bearer <IAM_token>" \
  -d '{
  "folder_id": "<folder_ID>",
  "node_id": "<node_ID>",
  "input": { <input_variables> } \
  }' \
  datasphere.api.cloud.yandex.net:443
yandex.cloud.datasphere.v1.NodeService/Execute

Where:

  • <IAM_token>: IAM token used for authentication.
  • <folder_ID>: ID of the folder the project and node are created in.
  • <node_ID>: Node ID.
  • <input_variables>: Object where keys match input variables.

In a successful response, the object is returned:

{
   "output": {
      <output_variables>
   }
}

Where <output_variables> is the object in which keys match output variables.

Sample REST API requestSample REST API request

You can use the cURL utility to send REST requests.

curl https://datasphere.api.cloud.yandex.net/datasphere/v1/nodes/<node_ID>:execute \
   --request POST \
   --header "Authorization: Bearer <IAM_token>"
   --data '{
      "folder_id": "<folder_ID>",
      "node_id": "<node_ID>",
      "input": { <input_variables> }
   }'

Where:

  • <IAM_token>: IAM token used for authentication.
  • <folder_ID>: ID of the folder the project and node are created in.
  • <node_ID>: Node ID.
  • <input_variables>: Object where keys match input variables.

The response returns a JSON object with output variables.

Was the article helpful?

Previous
Configuring a node environment
Next
Suspending or resuming a node
© 2025 Direct Cursus Technology L.L.C.