[Unofficial] Yandex.Cloud REST API Client

ALPHA VERSION

Warning: Some features may be unavailable or unstable. The client is developed by one developer in his spare time. If you are not satisfied with this, you can always add or change the client by creating a pull request.

Probably, this REST API Client will make your life with Yandex.Cloud a little easier.

Installing

• Installing with pip:

pip3 install yandex-cloud-client

• Also, you can install from source with:

git clone https://github.com/akimrx/python-yc-client  --recursive
cd python-yc-client 
make install

or

git clone https://github.com/akimrx/python-yc-client  --recursive
cd python-yc-client 
python3 setup.py install

Getting started

Client and authorization

The first step is to import required client of the Yandex.Cloud Services.
Each client of a Yandex.Cloud service inherits authorization from the base client, which supports three methods:

• OAuth token

from yandex_cloud_client import ComputeClient

client = ComputeClient(oauth_token='YOUR_OAUTH_TOKEN')

• IAM token

from yandex_cloud_client import ComputeClient

client = ComputeClient(iam_token='YOUR_IAM_TOKEN')

• Service account key

import json
from yandex_cloud_client import ComputeClient

with open('/path/to/key.json', 'r') as infile:
    credentials = json.load(infile)

client = ComputeClient(service_account_key=credentials)

You can get key.json from Yandex Cloud CLI:

yc iam key create --service-account-name my-robot -o my-robot-key.json

Basic example for Instance from Compute Cloud Service

from yandex_cloud_client import ComputeClient

compute = ComputeClient(oauth_token='YOUR_OAUTH_TOKEN')


def show_instance_and_restart(instance_id):
    instance = compute.instance(instance_id, metadata=True)
    print('Name:', instance.name)
    print('Cores:', instance.resources.cores)
    print('Memory:', instance.resources.memory)
    print('SSH-keys:', instance.metadata.ssh_keys)

    if instance.running:
        operation = instance.restart()
        if operation.completed:
            print(f'Instance {instance.name} restarted!')

    print('Current instance state:', instance.status)


def boot_disk_snapshot(instance_id):
    instance = compute.instance(instance_id)

    if not instance.stopped:  # also, you can use instance.status != 'STOPPED'
        print('Stopping instance..')
        instance.stop()

    print('Creating snapshot for boot disk..')
    instance.boot_disk.create_snapshot()
    print('Starting instance without awaiting complete.')
    instance.start(await_complete=False)



if __name__ == '__main__':
    show_instance_and_restart('YOUR_INSTANCE_ID')
    boot_disk_snapshot('YOUR_INSTANCE_ID')

See more examples here

Logging

This library uses the logging module.

Example of usage:

import logging

logging.basicConfig(level=logging.INFO,
                    format='[%(levelname)s] %(message)s')
logger = logging.getLogger(__name__)

Borrowed arch design

The client was written under the inspiration of architecture design:

• python-telegram-bot
• yandex-music-api