予約済みトピック - AWS IoT Core

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

予約済みトピック

ドル記号 ($) で始まるトピックは、 で使用するために予約されていますAWS IoT。これらの予約済みトピックは、許可されているとおりにサブスクライブおよび発行できます。ただし、ドル記号で始まる新しいトピックを作成することはできません。予約済みトピックへのサポートされていないパブリッシュまたはサブスクライブオペレーションにより、接続が終了することがあります。

アセットモデルのトピック

トピック クライアントオペレーションを許可する 説明

$aws/sitewise/asset-models/assetModelId/assets/assetId/properties/propertyId

Subscribe

AWS IoT SiteWiseは、アセットプロパティ通知をこのトピックに発行します。詳細については、「 AWS IoT SiteWiseユーザーガイド」の「他の AWSサービスとのやり取り」を参照してください。

AWS IoT Device Defenderトピック

これらのメッセージは、トピックのペイロード形式に応じて、簡潔なバイナリオブジェクト表現 (CBOR) 形式のレスポンスバッファと JavaScript Object Notation (JSON) をサポートします。AWS IoT Device Defenderトピックは MQTT パブリッシュのみをサポートします。

ペイロード形式 レスポンス形式のデータ型
cbor 簡潔なバイナリオブジェクトの表現 (CCOR)
json JavaScript Object Notation (JSON)

詳細については、「デバイスからのメトリクスの送信」を参照してください。

Topic 許可されている操作 説明

$aws/things/thingName/defender/metrics/payload-format

発行

AWS IoT Device Defenderエージェントはこのトピックにメトリクスを発行します。詳細については、「デバイスからのメトリクスの送信」を参照してください。

$aws/things/thingName/defender/metrics/payload-format/accepted

Subscribe

AWS IoTは、AWS IoT Device Defenderエージェントが成功したメッセージを $aws/things/thingName/defender/metrics/payload-format に発行した後、このトピックに発行します。詳細については、「デバイスからのメトリクスの送信」を参照してください。

$aws/things/thingName/defender/metrics/payload-format/rejected

Subscribe

AWS IoTは、AWS IoT Device Defenderエージェントが失敗したメッセージを $aws/things/thingName/defender/metrics/payload-format に発行した後、このトピックに発行します。詳細については、「デバイスからのメトリクスの送信」を参照してください。

AWS IoT Coreデバイスの場所に関するトピック

AWS IoT CoreDevice Location は、デバイスからの測定データを解決し、IoT デバイスの推定位置を提供できます。デバイスからの測定データには、GNSS、Wi-Fi、セルラー、IP アドレスを含めることができます。次にAWS IoT Core、Device Location は、最高の精度を提供し、デバイスの位置情報を解決する測定タイプを選択します。詳細については、「AWS IoT Coreデバイスの場所」および「AWS IoT Core デバイスロケーション MQTT トピックを使用したデバイス位置の解決」を参照してください。

Topic 許可されている操作 説明

$aws/device_location/customer_device_id/get_position_estimate

発行

デバイスは、このトピックに発行して、スキャンされた未加工の測定データを AWS IoT CoreDevice Location で解決します。

$aws/device_location/customer_device_id/get_position_estimate/accepted

Subscribe

AWS IoT CoreDevice Location は、デバイスの場所が正常に解決された後、このトピックに発行されます。

$aws/device_location/customer_device_id/get_position_estimate/rejected

Subscribe

AWS IoT CoreDevice Location は、4xx エラーが原因でデバイスの位置を正常に解決できない場合に、このトピックに発行されます。

イベントのトピック

イベントメッセージは、特定のイベントが発生したときにを発行されます。例えば、モノが追加、更新、または削除されると、イベントがレジストリによって生成されます。この表は、さまざまなAWS IoTイベントとその予約済みトピックを示しています。

Topic クライアントオペレーションを許可する 説明

$aws/events/certificates/registered/caCertificateId

Subscribe

AWS IoTは、 が証明書AWS IoTを自動的に登録し、クライアントが PENDING_ACTIVATIONステータスの証明書を提示すると、このメッセージを発行します。詳細については、「自動登録のためのクライアントによる最初の接続の設定します」を参照してください。

$aws/events/job/jobID/canceled

Subscribe

AWS IoTは、ジョブがキャンセルされたときにこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。
$aws/events/job/jobID/cancellation_in_progress

Subscribe

AWS IoTは、ジョブのキャンセルが進行中のときにこのメッセージを発行します。詳細については、「ジョブイベント」を参照してください。

$aws/events/job/jobID/completed

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/clientId

Subscribe

AWS IoTは、指定されたクライアント ID を持つ MQTT クライアントが接続するときに、このトピックに発行しますAWS IoT。詳細については、「接続/切断イベント」を参照してください。

$aws/events/presence/disconnected/clientId

Subscribe

AWS IoTは、指定されたクライアント ID を持つ MQTT クライアントが切断されると、このトピックに発行しますAWS IoT。詳細については、「接続/切断イベント」を参照してください。

$aws/events/subscriptions/subscribed/clientId

Subscribe

AWS IoTは、指定されたクライアント ID を持つ MQTT クライアントが MQTT トピックをサブスクライブするときに、このトピックに発行します。詳細については、「サブスクライブ/サブスクライブ解除イベント」を参照してください。

$aws/events/subscriptions/unsubscribed/clientId

Subscribe

AWS IoT指定されたクライアント ID を持つ MQTT クライアントが MQTT トピックへのサブスクライブを解除すると、 はこのトピックに発行します。詳細については、「サブスクライブ/サブスクライブ解除イベント」を参照してください。

$aws/events/thing/thingName/created

Subscribe

AWS IoTthingNameモノが作成されると、 はこのトピックに発行します。詳細については、「登録イベント」を参照してください。

$aws/events/thing/thingName/updated

Subscribe

AWS IoTthingName モノが更新されると、 はこのトピックに発行します。詳細については、「登録イベント」を参照してください。

$aws/events/thing/thingName/deleted

Subscribe

AWS IoTthingName モノが削除されると、 はこのトピックに発行します。詳細については、「登録イベント」を参照してください。

$aws/events/thingGroup/thingGroupName/created

Subscribe

AWS IoTモノのグループ thingGroupName が作成されると、 はこのトピックに発行します。詳細については、「登録イベント」を参照してください。

$aws/events/thingGroup/thingGroupName/updated

Subscribe

AWS IoTモノのグループ thingGroupName が更新されると、 はこのトピックに発行します。詳細については、「登録イベント」を参照してください。

$aws/events/thingGroup/thingGroupName/deleted

Subscribe

AWS IoTモノのグループ thingGroupName が削除されると、 はこのトピックに発行します。詳細については、「登録イベント」を参照してください。

$aws/events/thingType/thingTypeName/created

Subscribe

AWS IoTthingTypeName モノのタイプが作成されると、 はこのトピックに発行します。詳細については、「登録イベント」を参照してください。

$aws/events/thingType/thingTypeName/updated

Subscribe

AWS IoTthingTypeName モノのタイプが更新されると、 はこのトピックに発行します。詳細については、「登録イベント」を参照してください。

$aws/events/thingType/thingTypeName/deleted

Subscribe

AWS IoTthingTypeName モノのタイプが削除されると、 はこのトピックに発行します。詳細については、「登録イベント」を参照してください。

$aws/events/thingTypeAssociation/thing/thingName/thingTypeName

Subscribe

AWS IoTthingName が ThingTypeName のモノタイプと関連付けられているか、関連付けが解除されると、 はこのトピックに発行されますthingTypeName。詳細については、「登録イベント」を参照してください。

$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/added

Subscribe

AWS IoTモノの thingName がモノのグループ thingGroupName に追加されると、 はこのトピックに発行します。詳細については、「登録イベント」を参照してください。

$aws/events/thingGroupMembership/thingGroup/thingGroupName/thing/thingName/removed

Subscribe

AWS IoTthingName thingGroupNameから削除されると、 はこのトピックに発行します。詳細については、「登録イベント」を参照してください。

$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/added

Subscribe

AWS IoTは、モノのグループ childThingGroupName がモノのグループ parentThingGroupName に追加されると、このトピックに発行します。詳細については、「登録イベント」を参照してください。

$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroup/childThingGroupName/removed

Subscribe

AWS IoTは、モノのグループ childThingGroupName がモノのグループ parentThingGroupName から削除されると、このトピックに発行します。詳細については、「登録イベント」を参照してください。

フリートプロビジョニングのトピック

注記

この表の「Receive」というクライアントオペレーションは、クライアントがトピックをサブスクライブしているかどうかにかかわらず、リクエストしたクライアントに直接AWS IoT発行するトピックを示しています。クライアントは、応答メッセージにサブスクライブしていない場合でも、それらを受信する場合があることを想定する必要があります。これらの応答メッセージはメッセージブローカーを通過せず、他のクライアントまたはルールによってサブスクライブする事はできません。

これらのメッセージは、トピックのペイロード形式に応じて、簡潔なバイナリオブジェクト表現 (CCOR) 形式および JavaScript Object Notation (JSON) 形式のレスポンスバッファをサポートします。

ペイロード形式 レスポンス形式のデータ型
cbor 簡潔なバイナリオブジェクトの表現 (CCOR)
json JavaScript Object Notation (JSON)

詳細については、「デバイスプロビジョニング MQTT API」を参照してください。

トピック クライアントオペレーションを許可する 説明

$aws/certificates/create/payload-format

発行

証明書署名リクエスト (CSR) から証明書を作成するには、このトピックに発行します。

$aws/certificates/create/payload-format/accepted

サブスクライブ、受信

AWS IoTは、$aws/certificates/create/payload-format への正常な呼び出し後に、このトピックに発行します。

$aws/certificates/create/payload-format/rejected

サブスクライブ、受信

AWS IoTは、$aws/certificates/create/payload-format への呼び出しが失敗した後に、このトピックに発行します。

$aws/certificates/create-from-csr/payload-format

発行

このトピックに発行して、CSR から証明書を作成します。

$aws/certificates/create-from-csr/payload-format/accepted

サブスクライブ、受信

AWS IoTは、$aws/certificates/create-from-csr/payload-format への正常な呼び出しをこのトピックに発行します。

$aws/certificates/create-from-csr/payload-format/rejected

サブスクライブ、受信

AWS IoTは、このトピックに $aws/certificates/create-from-csr/payload-format への呼び出しに失敗しました。

$aws/provisioning-templates/templateName/provision/payload-format

発行

モノを登録するには、このトピックに発行します。

$aws/provisioning-templates/templateName/provision/payload-format/accepted

サブスクライブ、受信

AWS IoTは、$aws/provisioning-templates/templateName/provision/payload-format を正常に呼び出した後、このトピックに発行します。

$aws/provisioning-templates/templateName/provision/payload-format/rejected

サブスクライブ、受信

AWS IoTは、$aws/provisioning-templates/templateName/provision/payload-format への呼び出しが失敗した後に、このトピックに発行します。

ジョブのトピック

注記

この表の「Receive」というクライアントオペレーションは、クライアントがトピックをサブスクライブしているかどうかにかかわらず、リクエストしたクライアントに直接AWS IoT発行するトピックを示しています。クライアントは、応答メッセージにサブスクライブしていない場合でも、それらを受信する場合があることを想定する必要があります。

これらの応答メッセージはメッセージブローカーを通過せず、他のクライアントまたはルールによってサブスクライブする事はできません。ジョブアクティビティ関連のメッセージをサブスクライブするには、notifyおよび notify-nextトピックを使用します。

ジョブとjobExecutionフリートモニタリングソリューション用のイベントトピックをサブスクライブする際は、まずジョブおよびジョブイベントを実行して、クラウド側でイベント受信する必要があります。

詳細については、「ジョブデバイス MQTT API オペレーション」を参照してください。

トピック クライアントオペレーションを許可する 説明

$aws/things/thingName/jobs/get

発行

デバイスは、このトピックにメッセージを発行して、GetPendingJobExecutionsリクエストを実行します。詳細については、「ジョブデバイス MQTT API オペレーション」を参照してください。

$aws/things/thingName/jobs/get/accepted

サブスクライブ、受信

デバイスは、このトピックにサブスクライブして、GetPendingJobExecutions から正常なレスポンスを受け取ります。詳細については、「ジョブデバイス MQTT API オペレーション」を参照してください。

$aws/things/thingName/jobs/get/rejected

サブスクライブ、受信

GetPendingJobExecutions リクエストが拒否されると、デバイスはこのトピックをサブスクライブしてレスポンスを受け取ります。詳細については、「ジョブデバイス MQTT API オペレーション」を参照してください。

$aws/things/thingName/jobs/start-next

発行

デバイスは、このトピックにメッセージを発行して、StartNextPendingJobExecutionリクエストを実行します。詳細については、「ジョブデバイス MQTT API オペレーション」を参照してください。

$aws/things/thingName/jobs/start-next/accepted

サブスクライブ、受信

デバイスは、このトピックをサブスクライブして、StartNextPendingJobExecutionリクエストに対する正常なレスポンスを受け取ります。詳細については、「ジョブデバイス MQTT API オペレーション」を参照してください。

$aws/things/thingName/jobs/start-next/rejected

サブスクライブ、受信

StartNextPendingJobExecution リクエストが拒否されると、デバイスはこのトピックをサブスクライブしてレスポンスを受け取ります。詳細については、「ジョブデバイス MQTT API オペレーション」を参照してください。

$aws/things/thingName/jobs/jobId/get

発行

デバイスは、このトピックにメッセージを発行して、DescribeJobExecutionリクエストを実行します。詳細については、「ジョブデバイス MQTT API オペレーション」を参照してください。

$aws/things/thingName/jobs/jobId/get/accepted

サブスクライブ、受信

デバイスは、このトピックをサブスクライブして、DescribeJobExecutionリクエストに対する正常なレスポンスを受け取ります。詳細については、「ジョブデバイス MQTT API オペレーション」を参照してください。

$aws/things/thingName/jobs/jobId/get/rejected

サブスクライブ、受信

DescribeJobExecution リクエストが拒否されると、デバイスはこのトピックをサブスクライブしてレスポンスを受け取ります。詳細については、「ジョブデバイス MQTT API オペレーション」を参照してください。

$aws/things/thingName/jobs/jobId/update

発行

デバイスは、このトピックにメッセージをパブリッシュして、UpdateJobExecution リクエストを実行します。詳細については、「ジョブデバイス MQTT API オペレーション」を参照してください。

$aws/things/thingName/jobs/jobId/update/accepted

サブスクライブ、受信

デバイスは、このトピックにサブスクライブして、UpdateJobExecution リクエストに対する正常なレスポンスを受け取ります。詳細については、「ジョブデバイス MQTT API オペレーション」を参照してください。

メモ

$aws/things/thingName/jobs/jobId/update にパブリッシュするデバイスのみが、このトピックのメッセージを受信します。

$aws/things/thingName/jobs/jobId/update/rejected

サブスクライブ、受信

UpdateJobExecution リクエストが拒否されると、デバイスはこのトピックをサブスクライブしてレスポンスを受け取ります。詳細については、「ジョブデバイス MQTT API オペレーション」を参照してください。

メモ

$aws/things/thingName/jobs/jobId/update にパブリッシュするデバイスのみが、このトピックのメッセージを受信します。

$aws/things/thingName/jobs/notify

サブスクライブ、受信

デバイスは、このトピックにサブスクライブして、モノに対して保留中の実行のリストとの間でジョブの実行が追加または削除されたときに、通知を受け取ります。詳細については、「ジョブデバイス MQTT API オペレーション」を参照してください。

$aws/things/thingName/jobs/notify-next

サブスクライブ、受信

デバイスはこのトピックにサブスクライブして、モノに対する次に保留中のジョブの実行が変更されたときに、通知を受け取ります。詳細については、「ジョブデバイス MQTT API オペレーション」を参照してください。

$aws/events/job/jobId/completed

サブスクライブ

ジョブサービスは、ジョブが完了したときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。

$aws/events/job/jobId/canceled

サブスクライブ

ジョブサービスは、ジョブがキャンセルされたときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。

$aws/events/job/jobId/deleted

サブスクライブ

ジョブサービスは、ジョブが削除されたときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。

$aws/events/job/jobId/cancellation_in_progress

サブスクライブ

ジョブサービスは、ジョブのキャンセルが開始されたときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。

$aws/events/job/jobId/deletion_in_progress

サブスクライブ

ジョブサービスは、ジョブの削除が開始されたときに、イベントを発行します。詳細については、「ジョブイベント」を参照してください。

$aws/events/jobExecution/jobId/succeeded

サブスクライブ

ジョブサービスは、ジョブの実行が成功したときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。

$aws/events/jobExecution/jobId/failed

サブスクライブ

ジョブサービスは、ジョブの実行が失敗したときにイベントを発行します。詳細については、「ジョブイベント」を参照してください。

$aws/events/jobExecution/jobId/rejected

サブスクライブ

ジョブサービスは、ジョブの実行が拒否されたときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。

$aws/events/jobExecution/jobId/canceled

サブスクライブ

ジョブサービスは、ジョブの実行がキャンセルされたときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。

$aws/events/jobExecution/jobId/timed_out

サブスクライブ

ジョブサービスは、ジョブの実行がタイムアウトしたときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。

$aws/events/jobExecution/jobId/removed

サブスクライブ

ジョブサービスは、ジョブの実行が削除されたときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。

$aws/events/jobExecution/jobId/deleted

サブスクライブ

ジョブサービスは、ジョブの実行が削除されたときに、このトピックでイベントを発行します。詳細については、「ジョブイベント」を参照してください。

コマンドトのピック

注記

この表の「Receive」というクライアントオペレーションは、クライアントがトピックをサブスクライブしているかどうかにかかわらず、リクエストしたクライアントに直接AWS IoT発行するトピックを示しています。クライアントは、応答メッセージにサブスクライブしていない場合でも、それらを受信する場合があることを想定する必要があります。

これらの応答メッセージはメッセージブローカーを通過せず、他のクライアントまたはルールによってサブスクライブする事はできません。

Topic クライアントオペレーションを許可する 説明

$aws/commands/<devices>/<DeviceID>/executions/<ExecutionId>/request/<PayloadFormat>

$aws/commands/<devices>/<DeviceID>/executions/<ExecutionId>/request

サブスクライブ、受信

コンソールまたは StartCommandExecution API を使用してコマンド実行を開始するリクエストが行われると、デバイスはこのトピックに関するメッセージを受信します。この場合、<devices> には IoT のモノまたは MQTT クライアントのいずれかを指定することができ、<DeviceID> には IoT モノ名または MQTT クライアント ID を指定できます。

$aws/commands/<devices>/<DeviceID>/executions/<ExecutionId>/response/<PayloadFormat>

発行

デバイスは UpdateCommandExecution MQTT API を使用して、コマンド実行に関するメッセージをこのトピックに発行します。メッセージは、コンソールまたは StartCommandExecution API を使用してコマンド実行を開始するリクエストへのレスポンスとして発行されます。発行されたメッセージで、JSON または CBOR を <PayloadFormat> として使用します。

$aws/commands/<devices>/<DeviceID>/executions/<ExecutionId>/response/accepted/<PayloadFormat>

$aws/commands/<devices>/<DeviceID>/executions/<ExecutionId>/response/accepted

サブスクライブ、受信

クラウドサービスでコマンド実行結果が正常に処理されると、AWS IoT Device Management は /accepted トピックにレスポンスを発行します。

$aws/commands/<devices>/<DeviceID>/executions/<ExecutionId>/response/rejected/<PayloadFormat>

$aws/commands/<devices>/<DeviceID>/executions/<ExecutionId>/response/rejected

発行

クラウドサービスでコマンド実行結果の処理が失敗した場合、AWS IoT Device Management は /rejected トピックにレスポンスを発行します。

ルールのトピック

トピック クライアントオペレーションを許可する 説明

$aws/rules/ruleName

発行

デバイスまたはアプリケーションは、このトピックに発行して、ルールを直接トリガーします。詳細については、「基本的な取り込みによるメッセージングコストの削減」を参照してください。

セキュアトンネリングのトピック

トピック クライアントオペレーションを許可する 説明

$aws/things/thing-name/tunnels/notify

Subscribe

AWS IoTは、このメッセージを IoT エージェントに発行して、リモートデバイスでローカルプロキシを開始します。詳細については、「IoT エージェントスニペット」を参照してください。

シャドウトピック

このセクションのトピックは、名前付きシャドウと名前のないシャドウで使用されます。それぞれで使用されるトピックは、トピックのプレフィックスでのみ異なります。この表は、各シャドウタイプで使用されるトピックのプレフィックスを示しています。

ShadowTopicPrefix シャドウタイプ
$aws/things/thingName/shadow 名前のない (クラシック) シャドウ
$aws/things/thingName/shadow/name/shadowName 名前付きシャドウ

完全なトピックを作成するには、次の表に示すように、参照するシャドウのタイプの ShadowTopicPrefix を選択し、thingName と、shadowName (該当する場合) を対応する値に置き換え、トピックスタブに追加します。トピックでは大文字と小文字が区別されることに注意してください。

トピック クライアントオペレーションを許可する 説明

ShadowTopicPrefix/delete

パブリッシュ/サブスクライブ

デバイスまたはアプリケーションは、このトピックにパブリッシュして、シャドウを削除します。詳細については、「/delete」を参照してください。

ShadowTopicPrefix/delete/accepted

サブスクライブ

Device Shadow サービスは、シャドウが削除されると、このトピックにメッセージを送信します。詳細については、「/delete/accepted」を参照してください。

ShadowTopicPrefix/delete/rejected

サブスクライブ

Device Shadow サービスは、シャドウの削除リクエストが拒否されると、このトピックにメッセージを送信します。詳細については、「/delete/rejected」を参照してください。

ShadowTopicPrefix/get

パブリッシュ/サブスクライブ

アプリケーションまたはモノは、このトピックに空のメッセージをパブリッシュして、Shadow を取得します。詳細については、「Device Shadow MQTT トピック」を参照してください。

ShadowTopicPrefix/get/accepted

サブスクライブ

Device Shadow サービスは、シャドウに対するリクエストが正常に行われると、このトピックにメッセージを送信します。詳細については、「/get/accepted」を参照してください。

ShadowTopicPrefix/get/rejected

サブスクライブ

Device Shadow サービスは、シャドウのリクエストが拒否されると、このトピックにメッセージを送信します。詳細については、「/get/rejected」を参照してください。

ShadowTopicPrefix/update

パブリッシュ/サブスクライブ

モノまたはアプリケーションは、このトピックにパブリッシュして、Shadow を更新します。詳細については、「/update」を参照してください。

ShadowTopicPrefix/update/accepted

サブスクライブ

Device Shadow サービスは、シャドウに対する更新が正常に行われると、このトピックにメッセージを送信します。詳細については、「/update/accepted」を参照してください。

ShadowTopicPrefix/update/rejected

サブスクライブ

Device Shadow サービスは、シャドウに対する更新が拒否されると、このトピックにメッセージを送信します。詳細については、「/update/rejected」を参照してください。

ShadowTopicPrefix/update/delta

サブスクライブ

Device Shadow サービスは、シャドウの reported セクションと desired セクションとの間で差分が検出されると、このトピックにメッセージを送信します。詳細については、「/update/delta」を参照してください。

ShadowTopicPrefix/update/documents

Subscribe

AWS IoTシャドウの更新が正常に実行されるたびに、 はこのトピックに状態ドキュメントを発行します。詳細については、「/update/documents」を参照してください。

MQTT ベースのファイル配信のトピック

注記

この表の「Receive」というクライアントオペレーションは、クライアントがトピックをサブスクライブしているかどうかにかかわらず、リクエストしたクライアントに直接AWS IoT発行するトピックを示しています。クライアントは、応答メッセージにサブスクライブしていない場合でも、それらを受信する場合があることを想定する必要があります。これらの応答メッセージはメッセージブローカーを通過せず、他のクライアントまたはルールによってサブスクライブする事はできません。

これらのメッセージは、トピックのペイロード形式に応じて、簡潔なバイナリオブジェクト表現 (CCOR) 形式および JavaScript Object Notation (JSON) 形式のレスポンスバッファをサポートします。

ペイロード形式 レスポンス形式のデータ型
cbor 簡潔なバイナリオブジェクトの表現 (CCOR)
json JavaScript Object Notation (JSON)
トピック クライアントオペレーションを許可する 説明

$aws/things/ThingName/streams/StreamId/data/payload-format

サブスクライブ、受信

AWSデバイスからのGetStream」リクエストが受け入れられた場合、MQTT ベースのファイル配信はこのトピックに発行されます。ペイロードにはストリーミングデータが含まれます。詳細については、「デバイスでAWS IoTの MQTT ベースのファイル配信の使用」を参照してください。

$aws/things/ThingName/streams/StreamId/get/payload-format

発行

デバイスは、このトピックに発行して、「GetStream」リクエストを実行します。詳細については、「デバイスでAWS IoTの MQTT ベースのファイル配信の使用」を参照してください。

$aws/things/ThingName/streams/StreamId/description/payload-format

サブスクライブ、受信

AWSデバイスからのDescribeStream」リクエストが受け入れられた場合、MQTT ベースのファイル配信はこのトピックに発行されます。ペイロードには、ストリーミングの説明が含まれます。詳細については、「デバイスでAWS IoTの MQTT ベースのファイル配信の使用」を参照してください。

$aws/things/ThingName/streams/StreamId/describe/payload-format

発行

デバイスは、このトピックに発行して、「DescribeStream」リクエストを実行します。詳細については、「デバイスでAWS IoTの MQTT ベースのファイル配信の使用」を参照してください。

$aws/things/ThingName/streams/StreamId/rejected/payload-format

サブスクライブ、受信

AWSMQTT ベースのファイル配信は、デバイスからのDescribeStream」またはGetStream」リクエストが拒否された場合に、このトピックに発行されます。詳細については、「デバイスで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 です。