Introduction to Aliyun SDK

The Aliyun SDK (Software Development Kit) provided by Alibaba Cloud allows developers to interact seamlessly with its vast array of cloud services including computing, storage, and networking. This guide introduces the Aliyun SDK and explains dozens of useful APIs with practical code snippets.

Getting Started

# Install the Aliyun SDK for Python
pip install aliyun-python-sdk-core-v3

API Examples

1. Initialize Client

Creating an instance of the client to interact with Aliyun services.

from aliyunsdkcore.client import AcsClient
client = AcsClient('your-access-key-id', 'your-access-key-secret', 'region-id')

2. Describe Instances

Fetch details of ECS instances.

from aliyunsdkecs.request.v20140526.DescribeInstancesRequest import DescribeInstancesRequest

request = DescribeInstancesRequest()
response = client.do_action_with_exception(request)
print(response)

3. Create an ECS Instance

Spin up a new ECS instance.

from aliyunsdkecs.request.v20140526.CreateInstanceRequest import CreateInstanceRequest

request = CreateInstanceRequest()
request.set_InstanceName('new_instance')
request.set_ImageId('image_id')
request.set_InstanceType('ecs.t5-lc2m1.nano')
response = client.do_action_with_exception(request)
print(response)

4. Delete an ECS Instance

Terminate an existing ECS instance.

from aliyunsdkecs.request.v20140526.DeleteInstanceRequest import DeleteInstanceRequest

request = DeleteInstanceRequest()
request.set_InstanceId('instance_id')
response = client.do_action_with_exception(request)
print(response)

App Example Using Aliyun SDK

Below is a simple application demonstrating various Aliyun SDK APIs.

import time
from aliyunsdkcore.client import AcsClient
from aliyunsdkecs.request.v20140526.DescribeInstancesRequest import DescribeInstancesRequest
from aliyunsdkecs.request.v20140526.CreateInstanceRequest import CreateInstanceRequest
from aliyunsdkecs.request.v20140526.DeleteInstanceRequest import DeleteInstanceRequest

def create_client():
    client = AcsClient('your-access-key-id', 'your-access-key-secret', 'region-id')
    return client

def create_instance(client):
    request = CreateInstanceRequest()
    request.set_InstanceName('new_instance')
    request.set_ImageId('image_id')
    request.set_InstanceType('ecs.t5-lc2m1.nano')
    response = client.do_action_with_exception(request)
    instance_id = json.loads(response)['InstanceId']
    print(f'Instance Created: {instance_id}')
    return instance_id

def describe_instances(client):
    request = DescribeInstancesRequest()
    response = client.do_action_with_exception(request)
    print(response)

def delete_instance(client, instance_id):
    request = DeleteInstanceRequest()
    request.set_InstanceId(instance_id)
    response = client.do_action_with_exception(request)
    print(f'Instance Deleted: {instance_id}')

if __name__ == "__main__":
    client = create_client()
    instance_id = create_instance(client)
    time.sleep(60)  # Wait for 60 seconds
    describe_instances(client)
    delete_instance(client, instance_id)

This example demonstrates the creation, description, and deletion of an ECS instance using Aliyun SDK.

Hash: 2a8c2656eb409a51d4985c889193b5ad857a4bd4f9af32c2a983ecf40a649182