SDK 获取和安装
进入阿里云 Python SDK 。
请注意,部分阿里云产品的 SDK 未收录到这个列表中,例如对象存储(OSS),表格存储(Table Store),请前往这些产品的详情页获取相应的 SDK。
要成功地调用一个产品的 SDK,您至少需要首先安装SDK 核心库。例如,对云服务器 SDK 的调用,您需要获取和安装 2 个 SDK,分别是SDK 核心库和云服务器的 SDK。
您可以通过以下几种方式来安装阿里云 Python SDK:
方式一:运行 pip 安装命令
pip install aliyun-python-sdk-core
//如果您使用的是python3.x,请将上述命令修改为 pip install aliyun-python-sdk-core-v3
pip install aliyun-python-sdk-ecs
pip install aliyun-python-sdk-rds
//等等
您可以在阿里云 Python SDK 列表中找到所有已经发布的 Python SDK,并通过 pip 命令安装。
温馨提示:
pip 是一个通用的 Python 包安装工具,您可以在PyPI 上的 pip 页面上知道如何安装这个工具和更多信息。
pip 安装命令必须在管理员权限中运行。
方式二:下载 SDK 源代码后安装
您可以从 GitHub 上下载 Python SDK 的源代码:
git clone https://github.com/aliyun/aliyun-openapi-python-sdk.git
或者从 PyPI 仓库中下载源码包,下载地址可以从Python SDK 发布列表 中找到。
下载了 Python SDK 源代码后,在相应的 SDK 文件夹中运行命令:
python setup.py install
开始调用
以下这个代码示例向您展示了调用阿里云 SDK 的 3 个主要步骤:
创建 AcsClient 实例并初始化;
创建 API 请求并设置参数;
发起请求并打印返回。
# -*- coding: utf8 -*-
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
在创建 DefaultAcsClient 实例并初始化时,您需要填写 3 个参数:Region ID、Access Key ID和Access Key Secret。Access Key ID和Access Key Secret可以从控制台获得;而Region ID可以从地域列表中获得