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
    • Start testing with double trial credits
    • 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 Cloud API concepts
  • Basic principles

Basic principles

Written by
Yandex Cloud
Updated at April 23, 2025

Yandex Cloud APIs are based on the gRPC mechanism. The API methods and data structures are described using Protocol Buffers (proto 3).

Yandex Cloud services provide a JSON REST interface that you can access directly. REST is supported via the gRPC-JSON transcoder. Yandex Cloud services use this mechanism to translate incoming HTTP requests into gRPC calls. The service translates the results of request handling into an HTTP response and returns it to the client.

Resource-based approachResource-based approach

APIs of most Yandex Cloud services use a resource-based approach. How it works:

  • In APIs, resources are VMs, disks, images, etc. Each resource has a unique ID.

  • Two sets of methods are defined for managing resources in APIs:

    • Standard API methods allow you to perform CRUD operations: create, retrieve, update, and delete resources. Standard methods have the same signature and work in the same way for all APIs they are used in.
    • Additional API methods enhance the functionality of standard methods. You can use them to attach a disk, restart a VM, and perform other operations. The signature of additional methods differs from that of standard ones.
  • All operations that change the state of a resource are asynchronous signature operations. When these operations are called, the server returns the Operation object. This object contains the state of the operation and the ID of the resource the operation is being performed on.

  • Operations for creating, updating, and deleting resources support idempotency.

Exceptions for the resource-based approachExceptions for the resource-based approach

  • Yandex Object Storage API. Its architecture is compatible with the Amazon S3 API, so the Object Storage API operating principles do not always match those of the resource-based approach. For more information, see the documentation on the service.
  • Yandex Foundation Models, Yandex SpeechKit, Yandex Translate, and Yandex Vision OCR AI service API. The API of these services does not use Yandex Cloud resources and API requests are not idempotent.

See alsoSee also

  • Link to the .proto specifications of the Yandex Cloud API

Was the article helpful?

Next
Resource identification
© 2025 Direct Cursus Technology L.L.C.