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

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

予約済みトピック

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

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

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

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

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/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//defenderthingName/metrics/ に発行した後、このトピックに発行しますpayload-format。詳細については、「デバイスからのメトリクスの送信」を参照してください。

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

Subscribe

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

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/customer_device_id/get_position_estimate

公開

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

$aws/device_location/customer_device_id/get_position_estimate/accepted

Subscribe

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

$aws/device_location/customer_device_id/get_position_estimate/rejected

Subscribe

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

イベントのトピック

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

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

$aws/events/certificates/registered/caCertificateId

Subscribe

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

$aws/events/job/jobID/キャンセル済み

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/キャンセル済み

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

$aws/events/presence/disconnected/clientId

Subscribe

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

$aws/events/subscriptions/subscribed/clientId

Subscribe

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

$aws/events/subscriptions/unsubscribed/clientId

Subscribe

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

$aws/events/thing/thingName/created

Subscribe

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

$aws/events/thing/thingName/更新

Subscribe

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

$aws/events/thing/thingName/deleted

Subscribe

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

$aws/events/thingGroup/thingGroupName/created

Subscribe

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

$aws/events/thingGroup/thingGroupName/更新

Subscribe

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

$aws/events/thingGroup/thingGroupName/deleted

Subscribe

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

$aws/events/thingType/thingTypeName/created

Subscribe

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

$aws/events/thingType/thingTypeName/更新

Subscribe

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

$aws/events/thingType/thingTypeName/deleted

Subscribe

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

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

Subscribe

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

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

Subscribe

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

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

Subscribe

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

$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroupchildThingGroupName//added

Subscribe

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

$aws/events/thingGroupHierarchy/thingGroup/parentThingGroupName/childThingGroupchildThingGroupName//removed

Subscribe

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

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

注記

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

これらのメッセージは、トピックの に応じて、簡潔なバイナリオブジェクト表現 (CBOR) 形式と JavaScript オブジェクト表記 (JSON) payload-formatのレスポンスバッファをサポートします。

payload-format レスポンス形式のデータ型
cbor 簡潔なバイナリオブジェクト表現 (CBOR)
json JavaScript オブジェクト表記 (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-csrpayload-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フリートモニタリングソリューション用のイベントトピックをサブスクライブする際は、まずジョブおよびジョブイベントを実行して、クラウド側でイベント受信する必要があります。

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

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

$aws/things/thingName/jobs/get

公開

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

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

サブスクライブ、受信

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

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

サブスクライブ、受信

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

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

公開

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

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

サブスクライブ、受信

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

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

サブスクライブ、受信

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

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

公開

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

$aws/things/thingName/jobsjobId//get/accepted

サブスクライブ、受信

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

$aws/things/thingName/jobsjobId//get/rejected

サブスクライブ、受信

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

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

公開

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

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

サブスクライブ、受信

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

メモ

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

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

サブスクライブ、受信

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

メモ

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

$aws/things/thingName/jobs/notify

サブスクライブ、受信

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

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

サブスクライブ、受信

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

$aws/events/job/jobId/completed

Subscribe

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

$aws/events/job/jobId/キャンセル済み

Subscribe

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

$aws/events/job/jobId/deleted

Subscribe

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

$aws/events/job/jobId/cancellation_in_progress

Subscribe

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

$aws/events/job/jobId/deletion_in_progress

Subscribe

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

$aws/events/jobExecution/jobId/succeeded

Subscribe

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

$aws/events/jobExecution/jobId/failed

Subscribe

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

$aws/events/jobExecution/jobId/rejected

Subscribe

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

$aws/events/jobExecution/jobId/キャンセル済み

Subscribe

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

$aws/events/jobExecution/jobId/timed_out

Subscribe

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

$aws/events/jobExecution/jobId/removed

Subscribe

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

$aws/events/jobExecution/jobId/deleted

Subscribe

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

コマンドトピック

注記

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

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

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

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

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

サブスクライブ、受信

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

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

公開

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

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

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

サブスクライブ、受信

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

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

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

公開

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

ルールのトピック

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

$aws/ルール/ruleName

公開

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

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

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

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

Subscribe

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

シャドウトピック

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

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

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

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

ShadowTopicPrefix/削除

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

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

ShadowTopicPrefix/delete/accepted

Subscribe

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

ShadowTopicPrefix/delete/rejected

Subscribe

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

ShadowTopicPrefix/get

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

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

ShadowTopicPrefix/get/accepted

Subscribe

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

ShadowTopicPrefix/get/rejected

Subscribe

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

ShadowTopicPrefix/更新

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

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

ShadowTopicPrefix/update/accepted

Subscribe

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

ShadowTopicPrefix/update/rejected

Subscribe

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

ShadowTopicPrefix/update/delta

Subscribe

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

ShadowTopicPrefix/update/documents

Subscribe

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

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

注記

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

これらのメッセージは、トピックの に応じて、簡潔なバイナリオブジェクト表現 (CBOR) 形式と JavaScript オブジェクト表記 (JSON) payload-formatのレスポンスバッファをサポートします。

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

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

サブスクライブ、受信

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

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

公開

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

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

サブスクライブ、受信

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

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

公開

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

$aws/things/ThingName/streamsStreamId//rejected/payload-format

サブスクライブ、受信

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