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