翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
予約済みトピック
ドル記号 ($) で始まるトピックは、 が使用するために予約されています AWS IoT。これらの予約済みトピックは、許可されているとおりにサブスクライブおよび発行できます。ただし、ドル記号で始まる新しいトピックを作成することはできません。予約済みトピックへのサポートされていないパブリッシュまたはサブスクライブオペレーションにより、接続が終了することがあります。
アセットモデルのトピック
トピック | クライアントオペレーションを許可する | 説明 |
---|---|---|
$aws/サイト単位/アセットモデル/ |
Subscribe |
AWS IoT SiteWise は、このトピックにアセットプロパティ通知を発行します。詳細については、AWS IoT SiteWise 「 ユーザーガイド」の「他の AWS サービスとのインタラクション」を参照してください。 |
AWS IoT Device Defender トピック
これらのメッセージは、 に応じて、簡潔なバイナリオブジェクト表現 (CBOR) 形式と JavaScript オブジェクト表記 (JSON) のレスポンスバッファをサポートします。payload-format
topic. AWS IoT Device Defender topics の はMQTTパブリッシュのみをサポートします。
payload-format |
レスポンス形式のデータ型 |
---|---|
cbor | 簡潔なバイナリオブジェクト表現 (CBOR) |
json | JavaScript オブジェクト表記 (JSON) |
詳細については、「デバイスからメトリクスを送信する」を参照してください。
トピック | 許可されている操作 | 説明 |
---|---|---|
$aws/モノ/ |
公開 |
AWS IoT Device Defender エージェントはこのトピックにメトリクスを発行します。詳細については、「デバイスからのメトリクスの送信」を参照してください。 |
$aws/モノ/ |
Subscribe |
AWS IoT AWS IoT Device Defender エージェントが成功したメッセージを $aws/things/ に発行した後、このトピックに発行します。 |
$aws/モノ/ |
Subscribe |
AWS IoT AWS IoT Device Defender エージェントが失敗したメッセージを $aws/things/ に発行した後、このトピックに発行します。 |
AWS IoT Core デバイスの場所に関するトピック
AWS IoT Core Device Location は、デバイスからの測定データを解決し、IoT デバイスの推定場所を提供できます。デバイスからの測定データにはGNSS、、Wi-Fi、セルラー、IP アドレスを含めることができます。次に、 AWS IoT Core デバイスロケーションは、最適な精度を提供し、デバイスの位置情報を解決する測定タイプを選択します。詳細については、「AWS IoT Core デバイスの場所」および「Device Location MQTTトピックを使用した AWS IoT Core デバイスロケーションの解決」を参照してください。
トピック | 許可されている操作 | 説明 |
---|---|---|
$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 / 削除済み |
Subscribe |
AWS IoT ジョブが削除されると、 はこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/job/jobID /deletion_in_progress |
Subscribe |
AWS IoT は、ジョブの削除が進行中のときにこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/jobID /キャンセル済み |
Subscribe |
AWS IoT は、ジョブ実行がキャンセルされたときにこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/jobID / 削除済み |
Subscribe |
AWS IoT は、ジョブ実行が削除されると、このメッセージを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/jobID /失敗 |
Subscribe |
AWS IoT は、ジョブの実行が失敗したときにこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/jobID /拒否 |
Subscribe |
AWS IoT は、ジョブ実行が拒否されたときにこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/jobID /削除済み |
Subscribe |
AWS IoT は、ジョブ実行が削除されたときにこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。 |
$aws/events/jobExecution/jobID /成功 |
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 モノのグループが によってこのトピックに発行される |
フリートプロビジョニングのトピック
注記
この表で Receive と記されているクライアントオペレーションは、クライアントがトピックをサブスクライブしているかどうかにかかわらず、リクエストしたクライアントに直接 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/証明書/create-from-csr/ |
公開 |
このトピックに発行して、 から証明書を作成しますCSR。 |
$aws/証明書/create-from-csr/ |
サブスクライブ、受信 |
AWS IoT はこのトピックに $aws/certificates/create-from-csr/ への正常な呼び出しを発行します |
$aws/証明書/create-from-csr/ |
サブスクライブ、受信 |
AWS IoT このトピックに $aws/certificates/create-from-csr/ への呼び出しが失敗しました |
$aws/プロビジョニングテンプレート/ |
公開 |
モノを登録するには、このトピックに発行します。 |
$aws/プロビジョニングテンプレート/ |
サブスクライブ、受信 |
AWS IoT は、$aws/provisioning-templates/ への正常な呼び出し後にこのトピックに発行します。 |
$aws/プロビジョニングテンプレート/ |
サブスクライブ、受信 |
AWS IoT は、$aws/provisioning-templates/ への呼び出しが失敗した後にこのトピックに発行します。 |
ジョブのトピック
注記
このテーブルで Receive と記されているクライアントオペレーションは、クライアントがトピックをサブスクライブしているかどうかにかかわらず、リクエストしたクライアントに直接 AWS IoT 発行するトピックを示しています。クライアントは、応答メッセージにサブスクライブしていない場合でも、それらを受信する場合があることを想定する必要があります。
これらの応答メッセージはメッセージブローカーを通過せず、他のクライアントまたはルールによってサブスクライブする事はできません。ジョブアクティビティ関連のメッセージをサブスクライブするには、notify
および notify-next
トピックを使用します。
ジョブとjobExecution
フリートモニタリングソリューション用のイベントトピックをサブスクライブする際は、まずジョブおよびジョブイベントを実行して、クラウド側でイベント受信する必要があります。
詳細については、「ジョブデバイス MQTT API オペレーション」を参照してください。
トピック | クライアントオペレーションを許可する | 説明 |
---|---|---|
$aws/モノ/ |
公開 |
デバイスは、このトピックにメッセージを発行して、 |
$aws/モノ/ |
サブスクライブ、受信 |
デバイスは、このトピックにサブスクライブして、 |
$aws/モノ/ |
サブスクライブ、受信 |
|
$aws/モノ/ |
公開 |
デバイスは、このトピックにメッセージを発行して、 |
$aws/モノ/ |
サブスクライブ、受信 |
デバイスは、このトピックをサブスクライブして、 |
$aws/モノ/ |
サブスクライブ、受信 |
|
$aws/モノ/ |
公開 |
デバイスは、このトピックにメッセージを発行して、 |
$aws/モノ/ |
サブスクライブ、受信 |
デバイスは、このトピックをサブスクライブして、 |
$aws/モノ/ |
サブスクライブ、受信 |
|
$aws/モノ/ |
公開 |
デバイスは、このトピックにメッセージをパブリッシュして、 |
$aws/モノ/ |
サブスクライブ、受信 |
デバイスは、このトピックにサブスクライブして、 注記$aws/things/ に発行するデバイスのみ |
$aws/モノ/ |
サブスクライブ、受信 |
注記$aws/things/ に発行するデバイスのみ |
$aws/モノ/ |
サブスクライブ、受信 |
デバイスは、このトピックにサブスクライブして、モノに対して保留中の実行のリストとの間でジョブの実行が追加または削除されたときに、通知を受け取ります。詳細については、「ジョブデバイス MQTT API オペレーション」を参照してください。 |
$aws/モノ/ |
サブスクライブ、受信 |
デバイスはこのトピックにサブスクライブして、モノに対する次に保留中のジョブの実行が変更されたときに、通知を受け取ります。詳細については、「ジョブデバイス MQTT API オペレーション」を参照してください。 |
$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 |
ジョブサービスは、ジョブの実行が削除されたときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。 |
ルールのトピック
トピック | クライアントオペレーションを許可する | 説明 |
---|---|---|
$aws/ルール/ |
公開 |
デバイスまたはアプリケーションは、このトピックに発行して、ルールを直接トリガーします。詳細については、「基本的な取り込みによるメッセージングコストの削減」を参照してください。 |
セキュアトンネリングのトピック
トピック | クライアントオペレーションを許可する | 説明 |
---|---|---|
$aws/モノ/ |
Subscribe |
AWS IoT は、IoT エージェントがリモートデバイスでローカルプロキシを起動するために、このメッセージを発行します。詳細については、「IoT エージェントスニペット」を参照してください。 |
シャドウトピック
このセクションのトピックは、名前付きシャドウと名前のないシャドウで使用されます。それぞれで使用されるトピックは、トピックのプレフィックスでのみ異なります。この表は、各シャドウタイプで使用されるトピックのプレフィックスを示しています。
ShadowTopicPrefix value |
シャドウタイプ |
---|---|
$aws/モノ/thingName /シャドウ |
名前のない (クラシック) シャドウ |
$aws/モノ/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/モノ/ |
サブスクライブ、受信 |
AWS MQTTベースのファイル配信は、デバイスからのGetStream「」リクエストが受け入れられると、このトピックに発行されます。ペイロードにはストリーミングデータが含まれます。詳細については、「デバイスでの AWS IoT MQTTベースのファイル配信の使用」を参照してください。 |
$aws/モノ/ |
公開 |
デバイスは、GetStream「」リクエストを実行するためにこのトピックに発行します。詳細については、「デバイスでの AWS IoT MQTTベースのファイル配信の使用」を参照してください。 |
$aws/モノ/ |
サブスクライブ、受信 |
AWS MQTTベースのファイル配信は、デバイスからのDescribeStream「」リクエストが受け入れられると、このトピックに発行されます。ペイロードには、ストリーミングの説明が含まれます。詳細については、「デバイスでの AWS IoT MQTTベースのファイル配信の使用」を参照してください。 |
$aws/モノ/ |
公開 |
デバイスは、DescribeStream「」リクエストを実行するためにこのトピックに発行します。詳細については、「デバイスでの AWS IoT MQTTベースのファイル配信の使用」を参照してください。 |
$aws/モノ/ |
サブスクライブ、受信 |
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
。