物聯網平臺提供Python語言的云端SDK供開發人員使用。本文介紹云端Python SDK的安裝和配置及使用Python SDK調用云端API的示例。
安裝SDK
安裝Python開發環境。
訪問Python官網，下載Python安裝包，并完成安裝。目前，Python SDK支持Python的2.7.x和3.x版本。
安裝Python的包管理工具pip。（如果您已安裝pip，請忽略此步驟。）
訪問 pip 官網，下載pip安裝包，并完成安裝。
以管理員權限執行以下命令，安裝IoT Python SDK。
該SDK使用說明，請參見新版aliyun-python-sdk-iot信息。
sudo pip install aliyun-python-sdk-core sudo pip install aliyun-python-sdk-iot將IoT Python SDK相關文件引入Python文件。
from aliyunsdkcore import client from aliyunsdkiot.request.v20180120 import RegisterDeviceRequest from aliyunsdkiot.request.v20180120 import PubRequest ...
初始化SDK
以調用華東2（上海）地域的API為例，初始化代碼如下。
通過client.AcsClient(accessKeyId, accessKeySecret, 'cn-shanghai')方法，加載SDK信息，完成SDK客戶端初始化。
import os
accessKeyId = os.getenv('ACCESS_KEY_ID')
accessKeySecret = os.getenv('ACCESS_KEY_SECRET')
clt = client.AcsClient(accessKeyId, accessKeySecret, 'cn-shanghai')參數 | 說明 |
clt | 初始化SDK客戶端，其中 您可在物聯網平臺控制臺左上方，查看當前服務所在地域。 地域代碼的表達方法，請參見支持的地域。 |
發起調用
物聯網平臺云端SDK為每個API封裝了一個類，命名為${API名稱}+"Request"，用于API的調用請求。通過該類的對象實例request，使用"set_"+${請求參數的名稱}方法，設置請求參數值。通過初始化SDK的對象實例clt，使用do_action_with_exception(request)方法，承載API調用結果。
物聯網平臺云端API，請參見API列表。有關request中請求參數說明，及response中返回參數說明，請參見對應API文檔。
本文以調用Pub接口發布消息到Topic為例。請求參數信息，請參見Pub。
以下代碼中${iotInstanceId}為實例ID值。您可在物聯網平臺控制臺的實例概覽頁面，查看當前實例的ID值。
若有ID值，必須傳入該ID值，否則調用API會失敗。
若無實例概覽頁面或ID值，則無需傳入。您需刪除IotInstanceId相關的請求代碼，或傳入空值
""，否則調用API會失敗。
實例的詳細內容，請參見實例概述。購買實例方法，請參見購買企業版實例。常見問題，請參見物聯網平臺實例相關問題。
request = PubRequest.PubRequest()
request.set_accept_format('json') #設置返回數據格式，默認為XML，此例中設置為JSON
request.set_IotInstanceId('iotInstanceId')
request.set_ProductKey('productKey')
request.set_TopicFullName('/productKey/deviceName/user/get') #消息發送到的Topic全名
request.set_MessageContent('aGVsbG8gd29ybGQ=') #hello world Base64 String
request.set_Qos(0)
result = clt.do_action_with_exception(request)
print('result : ' + result)附錄：示例代碼
前往物聯網平臺云端SDK示例中心查看或下載API調用的示例代碼。示例代碼中包含Java、Python、PHP、.NET和Go版本SDK示例。
阿里云OpenAPI開發者門戶提供API在線調試工具。在API調試頁面，您可以快速檢索和體驗調用API。系統會根據您輸入的參數同步生成各語言SDK的代碼示例。各語言SDK代碼示例顯示在頁面右側SDK示例頁簽下供您參考。在調用結果頁簽下，可查看API調用的真實請求URL和JSON格式的返回結果。