翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
予約済みトピック
ドル記号 ($) で始まるトピックは、 で使用するために予約されています AWS IoT。これらの予約済みトピックは、許可されているとおりにサブスクライブおよび発行できます。ただし、ドル記号で始まる新しいトピックを作成することはできません。予約済みトピックへのサポートされていないパブリッシュまたはサブスクライブオペレーションにより、接続が終了することがあります。
アセットモデルのトピック
トピック | クライアントオペレーションを許可する | 説明 |
---|---|---|
$aws/sitewise/asset-models/ |
Subscribe |
AWS IoT SiteWise は、このトピックにアセットプロパティ通知を発行します。詳細については、「 ユーザーガイド」の「他の AWS サービスとの対話」を参照してください。 AWS IoT SiteWise |
AWS IoT Device Defender トピック
これらのメッセージは、topic. AWS IoT Device Defender topics payload-format
の に応じて、簡潔なバイナリオブジェクト表現 (CBOR) 形式と JavaScript Object Notation (JSON) MQTT 形式のレスポンスバッファをサポートします。トピックはパブリッシュのみをサポートします。
payload-format |
レスポンス形式のデータ型 |
---|---|
cbor | 簡潔なバイナリオブジェクト表現 (CBOR) |
json | JavaScript オブジェクト表記 (JSON) |
詳細については、「デバイスからのメトリクスの送信」を参照してください。
トピック | 許可されている操作 | 説明 |
---|---|---|
$aws/things/ |
公開 |
AWS IoT Device Defender エージェントは、このトピックにメトリクスを発行します。詳細については、「デバイスからのメトリクスの送信」を参照してください。 |
$aws/things/ |
Subscribe |
AWS IoT は、 AWS IoT Device Defender エージェントが成功したメッセージを $aws/things//defender |
$aws/things/ |
Subscribe |
AWS IoT は、 AWS IoT Device Defender エージェントが失敗したメッセージを $aws/things//defender |
AWS IoT Core Device Location のトピック
AWS IoT Core Device Location は、デバイスからの測定データを解決し、IoT デバイスの推定位置を提供できます。デバイスからの測定データには、GNSS、Wi-Fi、セルラー、IP アドレスを含めることができます。次に、 AWS IoT Core Device Location は、最適な精度を提供する測定タイプを選択し、デバイスの位置情報を解決します。詳細については、AWS IoT Core Device LocationおよびAWS IoT Core デバイスロケーション MQTT トピックを使用したデバイス位置の解決を参照してください。
トピック | 許可されている操作 | 説明 |
---|---|---|
$aws/device_location/ |
公開 |
デバイスはこのトピックに発行し、スキャンされた未加工の測定データを取得して AWS IoT Core Device Location で解決します。 |
$aws/device_location/ |
Subscribe |
AWS IoT Core Device Location は、デバイスの位置が正常に解決された後に、このトピックに発行されます。 |
$aws/device_location/ |
Subscribe |
AWS IoT Core Device Location は、4xx エラーが原因でデバイスの位置を正常に解決できない場合に、このトピックに発行されます。 |
イベントのトピック
イベントメッセージは、特定のイベントが発生したときにを発行されます。例えば、モノが追加、更新、または削除されると、イベントがレジストリによって生成されます。この表は、さまざまな AWS IoT イベントとその予約済みトピックを示しています。
トピック | クライアントオペレーションを許可する | 説明 |
---|---|---|
$aws/events/certificates/registered/ |
Subscribe |
AWS IoT は、 が証明書 AWS IoT を自動的に登録し、クライアントが |
$aws/events/job/ |
Subscribe |
AWS IoT は、ジョブがキャンセルされたときにこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/job/jobID /cancellation_in_progress |
Subscribe |
AWS IoT は、ジョブのキャンセルが進行中のときにこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/job/ |
Subscribe |
AWS IoT は、ジョブが完了するとこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/job/jobID /deleted |
Subscribe |
AWS IoT は、ジョブが削除されたときにこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/job/jobID /deletion_in_progress |
Subscribe |
AWS IoT は、ジョブの削除が進行中のときにこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/jobID /キャンセル済み |
Subscribe |
AWS IoT は、ジョブ実行がキャンセルされたときにこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/jobID /deleted |
Subscribe |
AWS IoT は、ジョブ実行が削除されたときにこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/jobID /failed |
Subscribe |
AWS IoT は、ジョブの実行が失敗したときにこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/jobID /rejected |
Subscribe |
AWS IoT は、ジョブの実行が拒否されたときにこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/jobID /removed |
Subscribe |
AWS IoT は、ジョブ実行が削除されたときにこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/jobID /succeeded |
Subscribe |
AWS IoT は、ジョブの実行が成功したときにこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/jobID /timed_out |
Subscribe |
AWS IoT は、ジョブ実行がタイムアウトしたときにこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/presence/connected/ |
Subscribe |
AWS IoT は、指定されたMQTTクライアント ID を持つ クライアントが接続するときに、このトピックに発行します AWS IoT。詳細については、「接続/切断イベント」を参照してください。 |
$aws/events/presence/disconnected/ |
Subscribe |
AWS IoT は、指定されたMQTTクライアント ID を持つ クライアントが切断されると、このトピックに発行します AWS IoT。詳細については、「接続/切断イベント」を参照してください。 |
$aws/events/subscriptions/subscribed/ |
Subscribe |
AWS IoT は、指定されたMQTTクライアント ID を持つ クライアントが トピックにサブスクライブするときに、このMQTTトピックに発行します。詳細については、「サブスクライブ/サブスクライブ解除イベント」を参照してください。 |
$aws/events/subscriptions/unsubscribed/ |
Subscribe |
AWS IoT は、指定されたMQTTクライアント ID を持つ クライアントが トピックへのサブスクリプションを解除すると、このMQTTトピックに発行します。詳細については、「サブスクライブ/サブスクライブ解除イベント」を参照してください。 |
$aws/events/thing/ |
Subscribe |
AWS IoT は、 |
$aws/events/thing/ |
Subscribe |
AWS IoT は、 |
$aws/events/thing/ |
Subscribe |
AWS IoT は、 |
$aws/events/thingGroup/ |
Subscribe |
AWS IoT は、モノのグループの作成時にこのトピックに発行 |
$aws/events/thingGroup/ |
Subscribe |
AWS IoT は、モノのグループが更新されると、このトピックに発行 |
$aws/events/thingGroup/ |
Subscribe |
AWS IoT モノのグループが削除されると、 |
$aws/events/thingType/ |
Subscribe |
AWS IoT は、 |
$aws/events/thingType/ |
Subscribe |
AWS IoT は、 |
$aws/events/thingType/ |
Subscribe |
AWS IoT は、 |
$aws/events/thingTypeAssociation/thing/ |
Subscribe |
AWS IoT は、モノ |
$aws/events/thingGroupMembership/thingGroup/ |
Subscribe |
AWS IoT は、モノ |
$aws/events/thingGroupMembership/thingGroup/ |
Subscribe |
AWS IoT は、モノ |
$aws/events/thingGroupHierarchy/thingGroup/ |
Subscribe |
AWS IoT は、モノのグループ がモノのグループ に追加されると |
$aws/events/thingGroupHierarchy/thingGroup/ |
Subscribe |
AWS IoT は、モノのグループ からモノのグループ が削除されると |
フリートプロビジョニングのトピック
注記
この表で「受信」と記載されているクライアントオペレーションは、クライアントがトピックをサブスクライブしているかどうかにかかわらず、リクエストしたクライアントに直接 AWS IoT 発行するトピックを示しています。クライアントは、応答メッセージにサブスクライブしていない場合でも、それらを受信する場合があることを想定する必要があります。これらの応答メッセージはメッセージブローカーを通過せず、他のクライアントまたはルールによってサブスクライブする事はできません。
これらのメッセージは、トピックの に応じて、簡潔なバイナリオブジェクト表現 (CBOR) 形式と JavaScript オブジェクト表記 (JSON) payload-format
のレスポンスバッファをサポートします。
payload-format |
レスポンス形式のデータ型 |
---|---|
cbor | 簡潔なバイナリオブジェクト表現 (CBOR) |
json | JavaScript オブジェクト表記 (JSON) |
詳細については、「デバイスプロビジョニング MQTT API」を参照してください。
トピック | クライアントオペレーションを許可する | 説明 |
---|---|---|
$aws/certificates/create/ |
公開 |
このトピックに発行して、証明書署名リクエスト () から証明書を作成しますCSR。 |
$aws/certificates/create/ |
サブスクライブ、受信 |
AWS IoT は、$aws/certificates/create/ への呼び出しが成功すると、このトピックに発行します |
$aws/certificates/create/ |
サブスクライブ、受信 |
AWS IoT は、$aws/certificates/create/ への呼び出しが失敗すると、このトピックに発行します |
$aws/certificates/create-from-csr/ |
公開 |
このトピックに発行して、 から証明書を作成しますCSR。 |
$aws/certificates/create-from-csr/ |
サブスクライブ、受信 |
AWS IoT は、$aws/certificates/create-from-csr/ への正常な呼び出しをこのトピックに発行します |
$aws/certificates/create-from-csr |
サブスクライブ、受信 |
AWS IoT は、$aws/certificates/create-from-csr/ への失敗した呼び出しをこのトピックに発行します |
$aws/provisioning-templates/ |
公開 |
モノを登録するには、このトピックに発行します。 |
$aws/provisioning-templates/ |
サブスクライブ、受信 |
AWS IoT は、$aws/provisioning-templates/ |
$aws/provisioning-templates/ |
サブスクライブ、受信 |
AWS IoT は、$aws/provisioning-templates/ |
ジョブのトピック
注記
この表で「Receive」と記載されているクライアントオペレーションは、クライアントがトピックをサブスクライブしているかどうかにかかわらず、リクエストしたクライアントに直接 AWS IoT 発行するトピックを示しています。クライアントは、応答メッセージにサブスクライブしていない場合でも、それらを受信する場合があることを想定する必要があります。
これらの応答メッセージはメッセージブローカーを通過せず、他のクライアントまたはルールによってサブスクライブする事はできません。ジョブアクティビティ関連のメッセージをサブスクライブするには、notify
および notify-next
トピックを使用します。
ジョブとjobExecution
フリートモニタリングソリューション用のイベントトピックをサブスクライブする際は、まずジョブおよびジョブイベントを実行して、クラウド側でイベント受信する必要があります。
詳細については、「ジョブデバイスのMQTTAPIオペレーション」を参照してください。
トピック | クライアントオペレーションを許可する | 説明 |
---|---|---|
$aws/things/ |
公開 |
デバイスは、このトピックにメッセージを発行して、 |
$aws/things/ |
サブスクライブ、受信 |
デバイスは、このトピックにサブスクライブして、 |
$aws/things/ |
サブスクライブ、受信 |
|
$aws/things/ |
公開 |
デバイスは、このトピックにメッセージを発行して、 |
$aws/things/ |
サブスクライブ、受信 |
デバイスは、このトピックをサブスクライブして、 |
$aws/things/ |
サブスクライブ、受信 |
|
$aws/things/ |
公開 |
デバイスは、このトピックにメッセージを発行して、 |
$aws/things/ |
サブスクライブ、受信 |
デバイスは、このトピックをサブスクライブして、 |
$aws/things/ |
サブスクライブ、受信 |
|
$aws/things/ |
公開 |
デバイスは、このトピックにメッセージをパブリッシュして、 |
$aws/things/ |
サブスクライブ、受信 |
デバイスは、このトピックにサブスクライブして、 メモ$aws/things/ |
$aws/things/ |
サブスクライブ、受信 |
メモ$aws/things/ |
$aws/things/ |
サブスクライブ、受信 |
デバイスは、このトピックにサブスクライブして、モノに対して保留中の実行のリストとの間でジョブの実行が追加または削除されたときに、通知を受け取ります。詳細については、「ジョブデバイスのMQTTAPIオペレーション」を参照してください。 |
$aws/things/ |
サブスクライブ、受信 |
デバイスはこのトピックにサブスクライブして、モノに対する次に保留中のジョブの実行が変更されたときに、通知を受け取ります。詳細については、「ジョブデバイスのMQTTAPIオペレーション」を参照してください。 |
$aws/events/job/ |
Subscribe |
ジョブサービスは、ジョブが完了したときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/job/ |
Subscribe |
ジョブサービスは、ジョブがキャンセルされたときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/job/ |
Subscribe |
ジョブサービスは、ジョブが削除されたときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/job/ |
Subscribe |
ジョブサービスは、ジョブのキャンセルが開始されたときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/job/ |
Subscribe |
ジョブサービスは、ジョブの削除が開始されたときに、イベントを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/ |
Subscribe |
ジョブサービスは、ジョブの実行が成功したときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/ |
Subscribe |
ジョブサービスは、ジョブの実行が失敗したときにイベントを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/ |
Subscribe |
ジョブサービスは、ジョブの実行が拒否されたときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/ |
Subscribe |
ジョブサービスは、ジョブの実行がキャンセルされたときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/ |
Subscribe |
ジョブサービスは、ジョブの実行がタイムアウトしたときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/ |
Subscribe |
ジョブサービスは、ジョブの実行が削除されたときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/ |
Subscribe |
ジョブサービスは、ジョブの実行が削除されたときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。 |
コマンドトピック
注記
この表で「Receive」と記載されているクライアントオペレーションは、クライアントがトピックをサブスクライブしているかどうかにかかわらず、リクエストしたクライアントに直接 AWS IoT 発行するトピックを示しています。クライアントは、応答メッセージにサブスクライブしていない場合でも、それらを受信する場合があることを想定する必要があります。
これらの応答メッセージはメッセージブローカーを通過せず、他のクライアントまたはルールによってサブスクライブする事はできません。
トピック | クライアントオペレーションを許可する | 説明 |
---|---|---|
$aws/commands/ $aws/commands/ |
サブスクライブ、受信 |
コンソールまたは |
$aws/commands/ |
公開 |
デバイスは |
$aws/commands/ $aws/commands/ |
サブスクライブ、受信 |
クラウドサービスがコマンド実行結果を正常に処理した場合、 は /accepted トピックにレスポンス AWS IoT Device Management を発行します。 |
$aws/commands/ $aws/commands/ |
公開 |
クラウドサービスがコマンド実行結果を処理できなかった場合、 は /rejected トピックにレスポンス AWS IoT Device Management を発行します。 |
ルールのトピック
トピック | クライアントオペレーションを許可する | 説明 |
---|---|---|
$aws/ルール/ |
公開 |
デバイスまたはアプリケーションは、このトピックに発行して、ルールを直接トリガーします。詳細については、「基本的な取り込みによるメッセージングコストの削減」を参照してください。 |
セキュアトンネリングのトピック
トピック | クライアントオペレーションを許可する | 説明 |
---|---|---|
$aws/things/ |
Subscribe |
AWS IoT は、IoT エージェントがリモートデバイスでローカルプロキシを開始するためにこのメッセージを発行します。詳細については、「IoT エージェントスニペット」を参照してください。 |
シャドウトピック
このセクションのトピックは、名前付きシャドウと名前のないシャドウで使用されます。それぞれで使用されるトピックは、トピックのプレフィックスでのみ異なります。この表は、各シャドウタイプで使用されるトピックのプレフィックスを示しています。
ShadowTopicPrefix 値 |
シャドウタイプ |
---|---|
$aws/things/thingName /shadow |
名前のない (クラシック) シャドウ |
$aws/things/thingName /shadow/name/shadowName |
名前付きシャドウ |
完全なトピックを作成するには、参照するシャドウShadowTopicPrefix
タイプの を選択し、該当する場合は thingName
と shadowName
を対応する値に置き換え、それを次の表に示すようにトピックスタブに追加します。トピックでは大文字と小文字が区別されることに注意してください。
トピック | クライアントオペレーションを許可する | 説明 |
---|---|---|
|
パブリッシュ/サブスクライブ |
デバイスまたはアプリケーションは、このトピックにパブリッシュして、シャドウを削除します。詳細については、「/delete」を参照してください。 |
|
Subscribe |
Device Shadow サービスは、シャドウが削除されると、このトピックにメッセージを送信します。詳細については、「/delete/accepted」を参照してください。 |
|
Subscribe |
Device Shadow サービスは、シャドウの削除リクエストが拒否されると、このトピックにメッセージを送信します。詳細については、「/delete/rejected」を参照してください。 |
|
パブリッシュ/サブスクライブ |
アプリケーションまたはモノは、このトピックに空のメッセージをパブリッシュして、Shadow を取得します。詳細については、「Device Shadow MQTTのトピック」を参照してください。 |
|
Subscribe |
Device Shadow サービスは、シャドウに対するリクエストが正常に行われると、このトピックにメッセージを送信します。詳細については、「/get/accepted」を参照してください。 |
|
Subscribe |
Device Shadow サービスは、シャドウのリクエストが拒否されると、このトピックにメッセージを送信します。詳細については、「/get/rejected」を参照してください。 |
|
パブリッシュ/サブスクライブ |
モノまたはアプリケーションは、このトピックにパブリッシュして、Shadow を更新します。詳細については、「/update」を参照してください。 |
|
Subscribe |
Device Shadow サービスは、シャドウに対する更新が正常に行われると、このトピックにメッセージを送信します。詳細については、「/update/accepted」を参照してください。 |
|
Subscribe |
Device Shadow サービスは、シャドウに対する更新が拒否されると、このトピックにメッセージを送信します。詳細については、「/update/rejected」を参照してください。 |
|
Subscribe |
Device Shadow サービスは、シャドウの reported セクションと desired セクションとの間で差分が検出されると、このトピックにメッセージを送信します。詳細については、「/update/delta」を参照してください。 |
|
Subscribe |
AWS IoT シャドウの更新が正常に実行されるたびに、 はこのトピックに状態ドキュメントを発行します。詳細については、「/update/documents」を参照してください。 |
MQTTベースのファイル配信トピック
注記
この表で「Receive」と記載されているクライアントオペレーションは、クライアントがトピックをサブスクライブしているかどうかにかかわらず、リクエストしたクライアントに直接 AWS IoT 発行するトピックを示しています。クライアントは、応答メッセージにサブスクライブしていない場合でも、それらを受信する場合があることを想定する必要があります。これらの応答メッセージはメッセージブローカーを通過せず、他のクライアントまたはルールによってサブスクライブする事はできません。
これらのメッセージは、トピックの に応じて、簡潔なバイナリオブジェクト表現 (CBOR) 形式と JavaScript オブジェクト表記 (JSON) payload-format
のレスポンスバッファをサポートします。
payload-format |
レスポンス形式のデータ型 |
---|---|
cbor | 簡潔なバイナリオブジェクト表現 (CBOR) |
json | JavaScript オブジェクト表記 (JSON) |
トピック | クライアントオペレーションを許可する | 説明 |
---|---|---|
$aws/things/ |
サブスクライブ、受信 |
AWS MQTTベースのファイル配信は、デバイスからのGetStream「」リクエストが受け入れられた場合に、このトピックに発行されます。ペイロードにはストリーミングデータが含まれます。詳細については、「デバイスでの AWS IoT MQTT ベースのファイル配信の使用」を参照してください。 |
$aws/things/ |
公開 |
デバイスは、このトピックに発行してGetStream「」リクエストを実行します。詳細については、「デバイスでの AWS IoT MQTT ベースのファイル配信の使用」を参照してください。 |
$aws/things/ |
サブスクライブ、受信 |
AWS MQTTベースのファイル配信は、デバイスからのDescribeStream「」リクエストが受け入れられた場合、このトピックに発行されます。ペイロードには、ストリーミングの説明が含まれます。詳細については、「デバイスでの AWS IoT MQTT ベースのファイル配信の使用」を参照してください。 |
$aws/things/ |
公開 |
デバイスは、このトピックに発行してDescribeStream「」リクエストを実行します。詳細については、「デバイスでの AWS IoT MQTT ベースのファイル配信の使用」を参照してください。 |
$aws/things/ |
サブスクライブ、受信 |
AWS MQTTベースのファイル配信は、デバイスからのDescribeStream「」またはGetStream「」リクエストが拒否された場合に、このトピックに発行されます。詳細については、「デバイスでの AWS IoT MQTT ベースのファイル配信の使用」を参照してください。 |
予約済みトピック ARN
すべての予約済みトピック ARNs (Amazon リソースネーム) の形式は次のとおりです。
arn:aws:iot:
aws-region
:AWS-account-ID
:topic/Topic
例えば、 arn:aws:iot:us-west-2:123EXAMPLE456:topic/$aws/things/thingName/jobs/get/accepted
は予約済みトピック ARNの です$aws/things/thingName/jobs/get/accepted
。