yandexcloud 0.388.0

The Yandex Cloud official SDK

Yandex.Cloud SDK (Python)

Need to automate your infrastructure or use services provided by Yandex.Cloud? We've got you covered.

Installation:

pip install yandexcloud

Getting started

There are several options for authorization your requests - Metadata Service (if you're executing your code inside VMs or Cloud Functions running in Yandex.Cloud), Service Account Keys and externally created IAM tokens.

Metadata Service

Don't forget to assign Service Account for your Instance or Function and grant required roles.

sdk = yandexcloud.SDK()

Service Account Keys

# you can store and read it from JSON file
sa_key = {
    "id": "...",
    "service_account_id": "...",
    "private_key": "..."
}

sdk = yandexcloud.SDK(service_account_key=sa_key)

IAM tokens

sdk = yandexcloud.SDK(iam_token="t1.9eu...")

Check examples directory for more examples.

Override service endpoint

Supported services

Service Name	Alias
yandex.cloud.ai.foundation_models	ai-foundation-models
yandex.cloud.ai.llm	ai-llm
yandex.cloud.ai.ocr	ai-vision-ocr
yandex.cloud.ai.stt	ai-stt
yandex.cloud.ai.translate	ai-translate
yandex.cloud.ai.tts	ai-speechkit
yandex.cloud.ai.vision	ai-vision
yandex.cloud.apploadbalancer	alb
yandex.cloud.billing	billing
yandex.cloud.cdn	cdn
yandex.cloud.certificatemanager.v1.certificate_content_service	certificate-manager-data
yandex.cloud.certificatemanager	certificate-manager
yandex.cloud.compute	compute
yandex.cloud.containerregistry	container-registry
yandex.cloud.dataproc.manager	dataproc-manager
yandex.cloud.dataproc	dataproc
yandex.cloud.datasphere	datasphere
yandex.cloud.datatransfer	datatransfer
yandex.cloud.dns	dns
yandex.cloud.endpoint	endpoint
yandex.cloud.iam	iam
yandex.cloud.iot.devices	iot-devices
yandex.cloud.k8s	managed-kubernetes
yandex.cloud.kms.v1.symmetric_crypto_service	kms-crypto
yandex.cloud.kms	kms
yandex.cloud.loadbalancer	load-balancer
yandex.cloud.loadtesting	loadtesting
yandex.cloud.lockbox.v1.payload_service	lockbox-payload
yandex.cloud.lockbox	lockbox
yandex.cloud.logging.v1.log_ingestion_service	log-ingestion
yandex.cloud.logging.v1.log_reading_service	log-reading
yandex.cloud.logging	logging
yandex.cloud.marketplace	marketplace
yandex.cloud.mdb.clickhouse	managed-clickhouse
yandex.cloud.mdb.elasticsearch	managed-elasticsearch
yandex.cloud.mdb.greenplum	managed-greenplum
yandex.cloud.mdb.kafka	managed-kafka
yandex.cloud.mdb.mongodb	managed-mongodb
yandex.cloud.mdb.mysql	managed-mysql
yandex.cloud.mdb.opensearch	managed-opensearch
yandex.cloud.mdb.postgresql	managed-postgresql
yandex.cloud.mdb.redis	managed-redis
yandex.cloud.mdb.sqlserver	managed-sqlserver
yandex.cloud.operation	operation
yandex.cloud.organizationmanager	organization-manager
yandex.cloud.resourcemanager	resource-manager
yandex.cloud.serverless.apigateway.websocket	apigateway-connections
yandex.cloud.serverless.apigateway	serverless-apigateway
yandex.cloud.serverless.containers	serverless-containers
yandex.cloud.serverless.functions	serverless-functions
yandex.cloud.serverless.triggers	serverless-triggers
yandex.cloud.spark	managed-spark
yandex.cloud.storage	storage-api
yandex.cloud.trino	trino
yandex.cloud.vpc	vpc
yandex.cloud.ydb	ydb

Override in client

from yandex.cloud.vpc.v1.network_service_pb2_grpc import NetworkServiceStub
from yandexcloud import SDK

sdk = SDK(iam_token="t1.9eu...")
new_network_client_endpoint = "example.new.vpc.very.new.yandex:50051"
insecure = False # by default is False, but if server does not support verification can be set to True
network_client = sdk.client(NetworkServiceStub, endpoint=new_network_client_endpoint, insecure=False)

Override in sdk config

To override endpoints provide dict in format {alias : new-endpoint}

from yandex.cloud.vpc.v1.network_service_pb2_grpc import NetworkServiceStub
from yandexcloud import SDK
new_network_client_endpoint = "example.new.vpc.very.new.yandex:50051"
sdk = SDK(iam_token="t1.9eu...", endpoints={"vpc": new_network_client_endpoint})
insecure = False # by default is False, but if server does not support verification can be set to True
network_client = sdk.client(NetworkServiceStub, insecure=False)

Notice: if both overrides are used for same endpoint, override by client has priority

Switch SDK region

from yandexcloud import SDK, set_up_yc_api_endpoint
kz_region_endpoint = "api.yandexcloud.kz"
# this will make SDK list endpoints from KZ yc installation
sdk = SDK(iam_token="t1.9eu...", endpoint="api.yandexcloud.kz")
# or you can use global function
set_up_yc_api_endpoint(kz_region_endpoint)

Retries

SDK provide built-in retry policy, that supports exponential backoff and jitter, and also retry budget. It's necessary to avoid retry amplification.

import grpc
from yandexcloud import SDK, RetryPolicy

sdk = SDK(retry_policy=RetryPolicy())

SDK provide different modes for retry throttling policy:

• persistent is suitable when you use SDK in any long-lived application, when SDK instance will live long enough for manage budget;
• temporary is suitable when you use SDK in any short-lived application, e.g. scripts or CI/CD.

By default, SDK will use temporary mode, but you can change it through throttling_mode argument.

Contributing

Dependencies

We use uv to manage dependencies and run commands in Makefile. Install it with official standalone installer: curl -LsSf https://astral.sh/uv/install.sh | sh

Installing dependencies

Use make deps command to install library, its production and development dependencies.

Adding new project dependency with uv

uv add cryptography

Adding new optional dependency with uv

add to dev extras section uv add pre-commit --group dev

add to genproto extras section uv add grpcio-tools --group genproto

Git hooks

Setup pre-commit and commit-msg hooks with make git-hooks command.

Formatting

Use make format to autoformat code with black tool.

Tests

• make test to run tests for current python version
• make lint to run only linters for current python version
• make tox-current to run all checks (tests + code style checks + linters + format check) for current python version
• make tox to run all checks for all supported (installed in your system) python versions
• make test-all-versions to run all checks for all supported python versions in docker container

Run Github Actions locally

Use https://github.com/nektos/act

Maintaining

If pull request consists of several meaningful commits, that should be preserved, then use "Rebase and merge" option. Otherwise use "Squash and merge".

New release (changelog, tag and pypi upload) will be automatically created on each push to master via Github Actions workflow.