このドキュメントはバージョン 1 の AWS CLI のみを対象としています。AWS CLI のバージョン 2 に関連するドキュメントについては、バージョン 2 用ユーザーガイドを参照してください。
次のコード例では、AWS IoT data で AWS Command Line Interface を使用してアクションを実行し、一般的なシナリオを実装する方法を示しています。
アクションはより大きなプログラムからのコードの抜粋であり、コンテキスト内で実行する必要があります。アクションは個々のサービス機能を呼び出す方法を示していますが、コンテキスト内のアクションは、関連するシナリオで確認できます。
各例には完全なソースコードへのリンクが含まれており、コードの設定方法と実行方法に関する手順を確認できます。
トピック
アクション
次の例は、delete-thing-shadow を使用する方法を説明しています。
- AWS CLI
-
デバイスのシャドウドキュメントを削除するには
次の
delete-thing-shadowの例では、MyRPiという名前のデバイスのシャドウドキュメント全体を削除します。aws iot-data delete-thing-shadow \ --thing-nameMyRPi\"output.txt"このコマンドではディスプレイに何も出力されませんが、
output.txtには削除したシャドウドキュメントのバージョンとタイムスタンプを確認する情報が含まれています。{"version":2,"timestamp":1560270384}詳細については、「AWS IoT デベロッパーガイド」の「シャドウの使用」を参照してください。
-
API の詳細については、「AWS CLI コマンドリファレンス」の「DeleteThingShadow
」を参照してください。
-
次の例は、get-thing-shadow を使用する方法を説明しています。
- AWS CLI
-
モノのシャドウドキュメントを取得するには
次の
get-thing-shadowの例では、指定された IoT のモノに関するモノのシャドウドキュメントを取得します。aws iot-data get-thing-shadow \ --thing-nameMyRPi\output.txtこのコマンドではディスプレイに何も出力されませんが、
output.txtの内容を以下に示します。{ "state":{ "reported":{ "moisture":"low" } }, "metadata":{ "reported":{ "moisture":{ "timestamp":1560269319 } } }, "version":1,"timestamp":1560269405 }詳細については、「AWS IoT デベロッパーガイド」の「Device Shadow サービスのデータフロー」を参照してください。
-
API の詳細については、「AWS CLI コマンドリファレンス」の「GetThingShadow
」を参照してください。
-
次の例は、update-thing-shadow を使用する方法を説明しています。
- AWS CLI
-
モノのシャドウを更新するには
次の
update-thing-shadowの例では、指定されたモノのデバイスシャドウの現在の状態を変更して、ファイルoutput.txtに保存します。aws iot-data update-thing-shadow \ --thing-nameMyRPi\ --payload "{"state":{"reported":{"moisture":"okay"}}}" \"output.txt"このコマンドではディスプレイに何も出力されませんが、
output.txtの内容を以下に示します。{ "state": { "reported": { "moisture": "okay" } }, "metadata": { "reported": { "moisture": { "timestamp": 1560270036 } } }, "version": 2, "timestamp": 1560270036 }詳細については、「AWS IoT デベロッパーガイド」の「Device Shadow サービスのデータフロー」を参照してください。
-
API の詳細については、「AWS CLI コマンドリファレンス」の「UpdateThingShadow
」を参照してください。
-
