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 的源代碼:
或者從 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可以從地域列表中獲得