Elastic Compute Service:ECS Python V2.0 SDK call example

Requisitos previos

1. El AccessKey de una cuenta de Alibaba Cloud otorga acceso total a sus recursos, lo que representa un alto riesgo de seguridad si se filtra. Se recomienda crear un usuario de Resource Access Management (RAM) y concederle únicamente los permisos obligatorios. Posteriormente, utilice el AccessKey del usuario RAM para llamar a las operaciones de la API. Para obtener más información, consulte Create an AccessKey.

2. Ha otorgado al usuario RAM permisos para gestionar recursos de ECS. El código de ejemplo en este tema muestra una operación de consulta. En este caso, se emplea la política de sistema AliyunECSReadonlyAccess. Puede otorgar permisos personalizados según sea necesario.

   1. Utilice políticas personalizadas.

      Para obtener más información sobre cómo crear políticas personalizadas, consulte Create a custom policy y Authorization information.

      ECS ofrece ejemplos de políticas personalizadas basados en mejores prácticas. Puede utilizar estos ejemplos para crear rápidamente políticas que satisfagan sus necesidades empresariales. Para obtener más información, consulte Custom policies.

   2. Utilice políticas de sistema.

      Para obtener información sobre todas las políticas de sistema compatibles con ECS y sus descripciones de permisos, consulte System policies for ECS.

3. Configure el AccessKey mediante variables de entorno. Para obtener más información, consulte Configure environment variables on Linux, macOS, and Windows systems.

pip install alibabacloud_ecs20140526

import os

from alibabacloud_tea_openapi.models import Config
from alibabacloud_ecs20140526.client import Client as Ecs20140526Client

class Sample:
    def __init__(self):
        pass

    @staticmethod
    def create_client() -> Ecs20140526Client:
        config = Config(
            # Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is configured.
            access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
            # Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is configured.
            access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET'],
            endpoint='ecs.cn-hangzhou.aliyuncs.com'
        )
        return Ecs20140526Client(config)

# Construct the request object.
describe_instances_request = ecs_20140526_models.DescribeInstancesRequest(
    region_id='cn-hangzhou'
)

# Specify runtime parameters.
runtime = util_models.RuntimeOptions()
# Call the DescribeInstances operation.
describe_instances_response = client.describe_instances_with_options(describe_instances_request, runtime)

import os

from Tea.exceptions import UnretryableException, TeaException
from alibabacloud_tea_openapi.models import Config
from alibabacloud_ecs20140526.client import Client as Ecs20140526Client
from alibabacloud_tea_util import models as util_models
from alibabacloud_ecs20140526 import models as ecs_20140526_models

class Sample:
    def __init__(self):
        pass

    @staticmethod
    def create_client() -> Ecs20140526Client:
        config = Config(
            # Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_ID environment variable is configured.
            access_key_id=os.environ['ALIBABA_CLOUD_ACCESS_KEY_ID'],
            # Required. Make sure that the ALIBABA_CLOUD_ACCESS_KEY_SECRET environment variable is configured.
            access_key_secret=os.environ['ALIBABA_CLOUD_ACCESS_KEY_SECRET'],
            endpoint='ecs.cn-hangzhou.aliyuncs.com'
        )
        return Ecs20140526Client(config)

    @staticmethod
    def main():
        client = Sample.create_client()
        # Create a request object.
        describe_instances_request = ecs_20140526_models.DescribeInstancesRequest(
            region_id='cn-hangzhou'
        )
        # Specify runtime parameters.
        runtime = util_models.RuntimeOptions()
        try:
            # Call the DescribeInstances operation.
            describe_instances_response = client.describe_instances_with_options(describe_instances_request, runtime)
            print(describe_instances_response.body)
        except UnretryableException as e:
            # Network exceptions. Handle exceptions with caution in actual business scenarios and do not ignore exceptions in your project. In this example, exceptions are provided only for reference.
            print(e)
        except TeaException as e:
            # Business exceptions. Handle exceptions with caution in actual business scenarios and do not ignore exceptions in your project. In this example, exceptions are provided only for reference.
            print(e)
        except Exception as e:
            # Other exceptions. Handle exceptions with caution in actual business scenarios and do not ignore exceptions in your project. In this example, exceptions are provided only for reference.
            print(e)

if __name__ == '__main__':
    Sample.main()

Ejemplos por escenario

• Create multiple ECS instances

• Query a list of ECS instances

• Renew an ECS instance

• Release an ECS instance

• Query available resources for instance type changes

• Query spot instance inventory

• Query the current price of spot instances

• Create a spot instance

• Add a security group rule

• Create a security group and add a resource to it

• Create an elastic network interface (ENI)

• Attach an ENI

• Detach an ENI

• Delete an ENI

• Change an ECS instance type

• Modify the instance type and public bandwidth of an instance

• Obtain one or more alternative instance types for a specified instance type

• Best practices for creating an ECS instance using an alternative instance type