Yandex Cloud SDK for Python

0.383.0 · active · verified Sat Mar 28

The official SDK for Yandex Cloud, enabling Python developers to manage Yandex Cloud resources. Current version: 0.383.0, released on March 23, 2026. The SDK is actively maintained with regular updates, primarily focusing on regenerating protocol buffers and supporting newer Python versions.

Warnings

breaking Regenerating protocol buffers may introduce breaking changes in the SDK.
Fix: Review the changelog for specific changes and update your code accordingly.
gotcha Ensure that the IAM token used has sufficient permissions to list clouds.
Fix: Verify IAM token permissions in the Yandex Cloud console.

Install

pip install yandexcloud Install yandexcloud

Imports

SDK
```
from yandexcloud import SDK
```
Ensure correct import path to access the SDK class.

ListCloudsRequest

from yandex.cloud.resourcemanager.v1.cloud_service_pb2 import ListCloudsRequest

Correct import path for ListCloudsRequest.

CloudServiceStub

from yandex.cloud.resourcemanager.v1.cloud_service_pb2_grpc import CloudServiceStub

Correct import path for CloudServiceStub.

Quickstart

A simple script to list and print the names of all clouds in your Yandex Cloud account using the SDK.

import os
import yandexcloud
from yandex.cloud.resourcemanager.v1.cloud_service_pb2 import ListCloudsRequest
from yandex.cloud.resourcemanager.v1.cloud_service_pb2_grpc import CloudServiceStub

# Initialize the SDK with IAM token
sdk = yandexcloud.SDK(iam_token=os.environ.get('YC_IAM_TOKEN'))

# Create a client for the CloudServiceStub
cloud_service = sdk.client(CloudServiceStub)

# List clouds
clouds = cloud_service.List(ListCloudsRequest()).clouds

# Print cloud names
for cloud in clouds:
    print(cloud.name)

view raw JSON →