Need to automate your infrastructure or use services provided by Yandex.Cloud? We've got you covered.
Installation:
pip install yandexcloud
There are several options for authorization your requests - OAuth Token, 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.
sdk = yandexcloud.SDK(token='AQAD-.....')
Don't forget to assign Service Account for your Instance or Function and grant required roles.
sdk = yandexcloud.SDK()
# 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)
sdk = yandexcloud.SDK(iam_token="t1.9eu...")
Check examples
directory for more examples.
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.storage | storage-api |
yandex.cloud.vpc | vpc |
yandex.cloud.ydb | ydb |
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)
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
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)
Use make deps
command to install library, its production and development dependencies.
Use make format
to autoformat code with black tool.
make test
to run tests for current python versionmake lint
to run only linters for current python versionmake tox-current
to run all checks (tests code style checks linters format check) for current python versionmake tox
to run all checks for all supported (installed in your system) python versionsmake test-all-versions
to run all checks for all supported python versions in docker container
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.