IoT Platform Python SDK - インストール、設定、およびクラウド API の呼び出し - IoT Platform

IoT Platform は、Python 用のクラウド SDK を提供します。Python SDK をインストール、設定、および使用してクラウド API を呼び出す方法について説明します。

SDK のインストール

Python をインストールします。

Python 公式サイトから Python をダウンロードします。SDK は Python 2.7.x および 3.x をサポートしています。
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 モジュールをインポートします。

from aliyunsdkcore import client
from aliyunsdkiot.request.v20180120 import RegisterDeviceRequest
from aliyunsdkiot.request.v20180120 import PubRequest
...

SDK の初期化

次の例は、IoT Platformサービスが中国 (上海) リージョンにある場合にSDKを初期化する方法を示しています。

client.AcsClient(accessKeyId, accessKeySecret, 'cn-shanghai') を使用して SDK クライアントを初期化します。

import os
accessKeyId = os.getenv('ACCESS_KEY_ID')
accessKeySecret = os.getenv('ACCESS_KEY_SECRET')
clt = client.AcsClient(accessKeyId, accessKeySecret, 'cn-shanghai')

パラメーター

説明

clt

SDK クライアントを初期化します。cn-shanghai は、IoT Platform サービスのリージョンコードです。

IoT Platform コンソールの左上隅でサービスリージョンを確認してください。

リージョンコード：「サポートされているリージョン」をご参照ください。

API の呼び出し

SDK は、各 API リクエストを ${API name}Request クラスとしてカプセル化します。set_${request parameter name} でリクエストパラメーターを設定し、SDK クライアント clt で do_action_with_exception(request) を呼び出してレスポンスを取得します。

IoT PlatformのAPI操作の詳細については、「関数別の操作のリスト」をご参照ください。各API操作のrequestおよびresponseパラメーターの詳細については、APIのドキュメントをご参照ください。

次の例は、Pub操作を呼び出してメッセージをトピックに公開する方法を示しています。リクエストパラメーターの詳細については、「Pub」をご参照ください。

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')  # メッセージの送信先トピックのフルネーム。
request.set_MessageContent('aGVsbG8gd29ybGQ=')  # hello world の Base64 文字列
request.set_Qos(0)
result = clt.do_action_with_exception(request)
print('result : ' + result)

付録: サンプルコード

のAPI操作のサンプルコードを表示またはダウンロードできます。 IoT Platform SDKサンプルセンター Java、Python、PHPなどのSDKのサンプルコード。NETおよびGoが提供されます。

Alibaba Cloud OpenAPI Explorerは、API操作用のオンラインデバッグツールを提供します。 [APIデバッグ] ページでは、API操作の検索、API操作の呼び出し、およびさまざまなSDKのAPI操作のサンプルコードの生成ができます。ページの右側で、SDKのサンプルコードを [サンプルコード] タブに表示できます。 [デバッグ結果] タブでは、実際のリクエストURLとレスポンスをJSON形式で表示できます。