欢迎使用阿里开发者工具套件(SDK)。阿里云Python SDK让您不用复杂编程即可访问云服务器、云数据库RDS、云监控等多个阿里云服务。本操作介绍如何获取阿里云Python SDK并开始调用。

如果您在使用SDK的过程中遇到任何问题,欢迎前往阿里云SDK问答社区提问,提问前请阅读提问引导提交反馈

在线调试和生成SDK示例

OpenAPI 开发者门户提供在线调用云产品API、动态生成SDK示例代码和快速检索接口等功能,能显著降低使用API的难度,推荐您使用。

环境准备

  • 使用阿里云Python SDK,您需要一个RAM账号以及一对AccessKey ID和AccessKey Secret。 请在阿里云控制台中的AccessKey管理页面上创建和查看您的AccessKey,或联系您的系统管理员。
  • 使用阿里云SDK调用某个产品的API前,确保您已经在阿里云控制台开通了该产品。

安装阿里云Python SDK

完成以下操作安装Python SDK:
  1. 安装SDK核心库。

    推荐使用 pip 命令,安装阿里云SDK核心库:

    pip install aliyun-python-sdk-core
  2. 安装云产品的SDK。
    以下是安装云服务器ECS的SDK示例:
    pip install aliyun-python-sdk-ecs

如果您在使用 pip 时,遇到网络导致的安装问题时,请尝试配置镜像来加速安装过程。PyPI 镜像设置参见:https://developer.aliyun.com/mirror/pypi

您也可以在GitHub下载各产品的SDK。

使用阿里云Python SDK

以下这个代码示例展示了调用阿里云Python SDK的3个主要步骤:

  1. 创建Client实例。在创建Client实例时,您需要获取Region ID、AccessKey ID和AccessKey Secret。
  2. 创建API请求并设置参数。
  3. 发起请求并处理应答或异常。
    from aliyunsdkcore.client import AcsClient
    from aliyunsdkcore.acs_exception.exceptions import ClientException
    from aliyunsdkcore.acs_exception.exceptions import ServerException
    from aliyunsdkecs.request.v20140526 import DescribeInstancesRequest
    from aliyunsdkecs.request.v20140526 import StopInstanceRequest
    # 创建AcsClient实例
    client = AcsClient(
       "<your-access-key-id>", 
       "<your-access-key-secret>",
       "<your-region-id>"
    );
    # 创建request,并设置参数
    request = DescribeInstancesRequest.DescribeInstancesRequest()
    request.set_PageSize(10)
    # 发起API请求并显示返回值
    response = client.do_action_with_exception(request)
    print response