使用Python SDK

安装SDK

阿里云Python SDK支持 Python 2.6.x, 2.7.x 和 3.x及以上环境，并提供pip和Github两种安装方式。

方式一：使用pip安装(推荐)

执行以下命令，通过pip安装SDK。

pip install aliyun-python-sdk-core # 安装阿里云 SDK 核心库
pip install aliyun-python-sdk-ecs # 安装管理 ECS 的库
pip install aliyun-python-sdk-rds # 安装管理 RDS 的库

说明：如果您使用的是 python3.x，请将pip install aliyun-python-sdk-core修改为pip install aliyun-python-sdk-core-v3

方式二：使用Github安装

执行以下命令，通过Github安装Python SDK。

git clone https://github.com/aliyun/aliyun-openapi-python-sdk.git
# 安装阿里云 SDK 核心库
cd aliyun-python-sdk-core
python setup.py install
# 安装阿里云 ECS SDK
cd aliyun-python-sdk-ecs
python setup.py install

您还可以通过访问阿里云SDK频道来获取Python SDK。

设置身份验证凭据

当使用阿里云 SDK 访问阿里云服务时，您需要提供阿里云账号进行身份验证。目前，Python SDK 支持以下几种身份验证方式。本操作中以AccessKey为例进行介绍。

• AccessKey
• STS Token
• STS RoleArn
• Ecs无AK访问
• RSA非对称加密

注意： 为了保证您的账号安全，建议您使用RAM账号来访问阿里云服务。阿里云账号的AccessKey对拥有的资源有完全的权限。RAM账号由阿里云账号授权创建，仅有对特定资源限定的操作权限。

步骤一 获取AccessKey

从AccessKey管理控制台获取访问阿里云API所需的AccessKey ID以及AccessKey Secret。

步骤二 设置访问凭证

如果您使用AccessKey作为访问凭据，我们提供了一个便捷的入口来设置访问凭证。

注意：请务必确保包含AccessKey的代码不会泄漏（例如提交到外部公开的GitHub项目），否则将会危害您的阿里云账号的信息安全。

client = AcsClient(
   "<access-key-id>", 
   "<access-key-secret>",
   "<region-id>"
);

发起调用

使用阿里云Python SDK发起请求时，需要以下几个步骤，本操作中以ECS为例。

1. 导入相关产品的SDK。

   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

2. 新建一个AcsClient。

   client = AcsClient(
      "<your-access-key-id>", 
      "<your-access-key-secret>",
      "<your-region-id>"
   );

3. 创建Request对象，并对其中参数赋值。

   request = DescribeInstancesRequest.DescribeInstancesRequest()
   request.set_PageSize(10)

4. 发起调用并处理返回。

   response = client.do_action_with_exception(request)
   print response