本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 預留主題
<a name="reserved-topics"></a>

以美元符號 ($) 開頭的主題保留供 使用 AWS IoT。在允許的情況下，您可以訂閱並發佈至這些預留主題；然而您無法建立以貨幣符號開頭的新主題。不支援的發佈或訂閱預留主題作業可能會導致連線終止。

## 資產模型主題
<a name="reserved-topics-other"></a>


| 主題 | 允許的用戶端操作 | Description | 
| --- | --- | --- | 
| $aws/sitewise/asset-models/{{assetModelId}}/assets/{{assetId}}/properties/{{propertyId}} | 訂閱 | AWS IoT SiteWise 會將資產屬性通知發佈至此主題。如需詳細資訊，請參閱*AWS IoT SiteWise 《 使用者指南*》中的[與其他 AWS 服務互動](https://docs.aws.amazon.com/iot-sitewise/latest/userguide/interact-with-other-services.html)。 | 

## AWS IoT Device Defender 主題
<a name="reserved-topics-device-defender"></a>

這些訊息支援簡潔二進位物件表示法 (CBOR) 格式和 JavaScript 物件表示法 (JSON) 的回應緩衝區，具體取決於 topic. AWS IoT Device Defender topics {{的承載格式}}，僅支援 MQTT 發佈。


| {{承載格式}} | 回應格式資料類型 | 
| --- | --- | 
| cbor | Concise Binary Object Representation (CBOR) | 
| json | JavaScript 物件標記法 (JSON) | 

如需詳細資訊，請參閱[從裝置傳送指標](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages)。


| 主題 | 允許操作 | Description | 
| --- | --- | --- | 
| $aws/things/{{thingName}}/defender/metrics/{{payload-format}} | 發布 | AWS IoT Device Defender 代理程式會將指標發佈至此主題。如需詳細資訊，請參閱[從裝置傳送指標](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages)。 | 
| $aws/things/{{thingName}}/defender/metrics/{{payload-format}}/accepted | 訂閱 | AWS IoT 在 AWS IoT Device Defender 客服人員成功將訊息發佈至 $aws/things/{{thingName}}/defender/metrics/{{payload-format}} 之後， 會發佈至此主題。如需詳細資訊，請參閱[從裝置傳送指標](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages)。 | 
| $aws/things/{{thingName}}/defender/metrics/{{payload-format}}/rejected | 訂閱 | AWS IoT 在 AWS IoT Device Defender 代理程式將失敗訊息發佈至 $aws/things/{{thingName}}/defender/metrics/{{payload-format}} 之後， 會發佈至此主題。如需詳細資訊，請參閱[從裝置傳送指標](https://docs.aws.amazon.com/iot-device-defender/latest/devguide/detect-device-side-metrics.html#DetectMetricsMessages)。 | 

## AWS IoT Core 裝置位置主題
<a name="reserved-topics-device-location"></a>

AWS IoT Core Device Location 可以從您的裝置解析測量資料，並提供 IoT 裝置的預估位置。來自裝置的測量資料可包含 GNSS、Wi-Fi、行動和 IP 地址。接著， AWS IoT Core Device Location 會選擇可提供最佳準確度的測量類型，並解決裝置位置資訊。如需詳細資訊，請參閱[AWS IoT Core 裝置位置](device-location.md)及[使用裝置位置 MQTT 主題解決 AWS IoT Core 裝置位置](device-location-reserved-topics.md)。


| 主題 | 允許操作 | Description | 
| --- | --- | --- | 
| $aws/device\_location/{{customer\_device\_id}}/get\_position\_estimate | 發布 | 裝置會發佈至此主題，以取得 AWS IoT Core 裝置位置要解析的掃描原始測量資料。 | 
| $aws/device\_location/{{customer\_device\_id}}/get\_position\_estimate/accepted | 訂閱 | AWS IoT Core 裝置位置成功解析裝置位置後，會發佈至此主題。 | 
| $aws/device\_location/{{customer\_device\_id}}/get\_position\_estimate/rejected | 訂閱 | AWS IoT Core 當裝置位置因 4xx 錯誤而無法成功解析裝置位置時，裝置位置會發佈至此主題。 | 

## 事件主題
<a name="reserved-topics-event"></a>

當發生特定事件時，會發佈事件訊息。例如，在新增、更新或刪除事物時，由登錄檔產生的事件。資料表顯示各種 AWS IoT 事件及其預留主題。


| 主題 | 允許的用戶端操作 | Description | 
| --- | --- | --- | 
| $aws/events/certificates/registered/{{caCertificateId}} | 訂閱 | AWS IoT 當 AWS IoT 自動註冊憑證，以及當用戶端呈現`PENDING_ACTIVATION`狀態為 的憑證時， 會發佈此訊息。如需詳細資訊，請參閱[設定用戶端的首次連線進行自動註冊](auto-register-device-cert.md#configure-auto-reg-first-connect)。 | 
| $aws/events/job/{{jobID}}/canceled | 訂閱 | AWS IoT 會在任務取消時發佈此訊息。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/job/{{jobID}}/cancellation\_in\_progress | 訂閱 | AWS IoT 會在任務取消進行中時發佈此訊息。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/job/{{jobID}}/completed | 訂閱 | AWS IoT 當任務完成時， 會發佈此訊息。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/job/{{jobID}}/deleted | 訂閱 | AWS IoT 會在刪除任務時發佈此訊息。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/job/{{jobID}}/deletion\_in\_progress | 訂閱 | AWS IoT 會在任務刪除進行中時發佈此訊息。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/jobExecution/{{jobID}}/canceled | 訂閱 | AWS IoT 會在任務執行取消時發佈此訊息。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/jobExecution/{{jobID}}/deleted | 訂閱 | AWS IoT 會在刪除任務執行時發佈此訊息。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/jobExecution/{{jobID}}/failed | 訂閱 | AWS IoT 當任務執行失敗時， 會發佈此訊息。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/jobExecution/{{jobID}}/rejected | 訂閱 | AWS IoT 當任務執行遭拒時， 會發佈此訊息。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/jobExecution/{{jobID}}/removed | 訂閱 | AWS IoT 會在任務執行移除時發佈此訊息。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/jobExecution/{{jobID}}/succeeded | 訂閱 | AWS IoT 當任務執行成功時， 會發佈此訊息。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/jobExecution/{{jobID}}/timed\_out | 訂閱 | AWS IoT 當任務執行逾時時， 會發佈此訊息。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/presence/connected/{{clientId}} | 訂閱 | AWS IoT 當具有指定用戶端 ID 的 MQTT 用戶端連線到此主題時， 會發佈至此主題 AWS IoT。如需詳細資訊，請參閱[連線/中斷連線事件](life-cycle-events.md#connect-disconnect)。 | 
| $aws/events/presence/disconnected/{{clientId}} | 訂閱 | AWS IoT 當具有指定用戶端 ID 的 MQTT 用戶端中斷連線時， 會發佈至此主題 AWS IoT。如需詳細資訊，請參閱[連線/中斷連線事件](life-cycle-events.md#connect-disconnect)。 | 
| $aws/events/subscriptions/subscribed/{{clientId}} | 訂閱 | AWS IoT 當具有指定用戶端 ID 的 MQTT 用戶端訂閱 MQTT 主題時， 會發佈至此主題。如需詳細資訊，請參閱[訂閱/取消訂閱事件](life-cycle-events.md#subscribe-unsubscribe-events)。 | 
| $aws/events/subscriptions/unsubscribed/{{clientId}} | 訂閱 | AWS IoT 當具有指定用戶端 ID 的 MQTT 用戶端取消訂閱 MQTT 主題時， 會發佈至此主題。如需詳細資訊，請參閱[訂閱/取消訂閱事件](life-cycle-events.md#subscribe-unsubscribe-events)。 | 
| $aws/events/thing/{{thingName}}/created | 訂閱 | AWS IoT 會在建立 {{thingName}} 物件時發佈至此主題。如需詳細資訊，請參閱[登錄檔事件](registry-events.md)。 | 
| $aws/events/thing/{{thingName}}/updated | 訂閱 | AWS IoT 當 {{thingName}} 物件更新時， 會發佈至此主題。如需詳細資訊，請參閱[登錄檔事件](registry-events.md)。 | 
| $aws/events/thing/{{thingName}}/deleted | 訂閱 | AWS IoT 刪除 {{thingName}} 物件時， 會發佈至此主題。如需詳細資訊，請參閱[登錄檔事件](registry-events.md)。 | 
| $aws/events/thingGroup/{{thingGroupName}}/created | 訂閱 | AWS IoT 會在物件群組 {{thingGroupName}} 建立時發佈至此主題。如需詳細資訊，請參閱[登錄檔事件](registry-events.md)。 | 
| $aws/events/thingGroup/{{thingGroupName}}/updated | 訂閱 | AWS IoT 當物件群組 {{thingGroupName}} 更新時， 會發佈至此主題。如需詳細資訊，請參閱[登錄檔事件](registry-events.md)。 | 
| $aws/events/thingGroup/{{thingGroupName}}/deleted | 訂閱 | AWS IoT 當刪除物件群組 {{thingGroupName}} 時， 會發佈至此主題。如需詳細資訊，請參閱[登錄檔事件](registry-events.md)。 | 
| $aws/events/thingType/{{thingTypeName}}/created | 訂閱 | AWS IoT 會在建立 {{thingTypeName}} 物件類型時發佈至此主題。如需詳細資訊，請參閱[登錄檔事件](registry-events.md)。 | 
| $aws/events/thingType/{{thingTypeName}}/updated | 訂閱 | AWS IoT 當 {{thingTypeName}} 物件類型更新時， 會發佈至此主題。如需詳細資訊，請參閱[登錄檔事件](registry-events.md)。 | 
| $aws/events/thingType/{{thingTypeName}}/deleted | 訂閱 | AWS IoT 刪除 {{thingTypeName}} 物件類型時， 會發佈至此主題。如需詳細資訊，請參閱[登錄檔事件](registry-events.md)。 | 
| $aws/events/thingTypeAssociation/thing/{{thingName}}/{{thingTypeName}} | 訂閱 | AWS IoT 當 物件 {{thingName}}與物件類型 {{thingTypeName}} 相關聯或取消關聯時， 會發佈至此主題。如需詳細資訊，請參閱[登錄檔事件](registry-events.md)。 | 
| $aws/events/thingGroupMembership/thingGroup/{{thingGroupName}}/thing/{{thingName}}/added | 訂閱 |  AWS IoT 當 物件 {{thingName}} 新增至物件群組 {{thingGroupName}} 時， 會發佈至此主題。如需詳細資訊，請參閱[登錄檔事件](registry-events.md)。 | 
| $aws/events/thingGroupMembership/thingGroup/{{thingGroupName}}/thing/{{thingName}}/removed | 訂閱 |  AWS IoT 從物件群組 {{thingName}} {{thingGroupName}} 時， 會發佈至此主題。如需詳細資訊，請參閱[登錄檔事件](registry-events.md)。 | 
|  $aws/events/thingGroupHierarchy/thingGroup/{{parentThingGroupName}}/childThingGroup/{{childThingGroupName}}/added | 訂閱 |  AWS IoT 當物件群組 {{childThingGroupName}} 新增至物件群組 {{parentThingGroupName}} 時， 會發佈至此主題。如需詳細資訊，請參閱[登錄檔事件](registry-events.md)。 | 
|  $aws/events/thingGroupHierarchy/thingGroup/{{parentThingGroupName}}/childThingGroup/{{childThingGroupName}}/removed | 訂閱 |  AWS IoT 當物件群組 {{childThingGroupName}} 從物件群組 {{parentThingGroupName}} 中移除時， 會發佈至此主題。如需詳細資訊，請參閱[登錄檔事件](registry-events.md)。 | 

## 機群佈建主題
<a name="reserved-topics-fleet"></a>

**注意**  
此表格中標記為**接收**的用戶端操作指出直接 AWS IoT 發佈到請求它的用戶端的主題，無論用戶端是否已訂閱主題。即使用戶端尚未訂閱回應訊息，也應該預期會收到這些訊息。這些回應訊息不會透過訊息代理程式傳遞，而且其他用戶端或規則無法訂閱這些訊息。

這些訊息支援 Concise Binary Object Representation (CBOR) 格式和 JavaScript 物件標記法 (JSON) 的回應緩衝區，具體取決於主題的{{承載格式}}。


| {{承載格式}} | 回應格式資料類型 | 
| --- | --- | 
| cbor | Concise Binary Object Representation (CBOR) | 
| json | JavaScript 物件標記法 (JSON) | 

如需詳細資訊，請參閱[裝置佈建 MQTT API](fleet-provision-api.md)。


| 主題 | 允許的用戶端操作 | Description | 
| --- | --- | --- | 
| $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}} 失敗之後， 會發佈至此主題。 | 

## 任務主題
<a name="reserved-topics-job"></a>

**注意**  
此表格中標記為**接收**的用戶端操作指出直接 AWS IoT 發佈到請求它的用戶端的主題，無論用戶端是否已訂閱主題。即使用戶端尚未訂閱回應訊息，也應該預期會收到這些訊息。  
這些回應訊息不會透過訊息代理程式傳遞，而且其他用戶端或規則無法訂閱這些訊息。若要訂閱任務活動相關訊息，請使用 `notify` 和 `notify-next` 主題。  
為機群監控解決方案訂閱任務和 `jobExecution` 事件主題時，您必須先啟用[任務和任務執行事件](iot-events.md)來接收雲端上的任何事件。  
如需詳細資訊，請參閱[任務裝置 MQTT API 操作](jobs-mqtt-api.md)。


| 主題 | 允許的用戶端操作 | Description | 
| --- | --- | --- | 
| $aws/things/{{thingName}}/jobs/get | 發布 | 裝置發佈訊息到這個主題來提出 `GetPendingJobExecutions` 請求。如需詳細資訊，請參閱[任務裝置 MQTT API 操作](jobs-mqtt-api.md)。 | 
| $aws/things/{{thingName}}/jobs/get/accepted | 訂閱、接收 | 裝置訂閱此主題，以接收來自 `GetPendingJobExecutions` 請求的成功回應。如需詳細資訊，請參閱[任務裝置 MQTT API 操作](jobs-mqtt-api.md)。 | 
| $aws/things/{{thingName}}/jobs/get/rejected | 訂閱、接收 | 當 `GetPendingJobExecutions` 請求被拒時，裝置會訂閱此主題以接收回應。如需詳細資訊，請參閱[任務裝置 MQTT API 操作](jobs-mqtt-api.md)。 | 
| $aws/things/{{thingName}}/jobs/start-next | 發布 | 裝置發佈訊息到這個主題來提出 `StartNextPendingJobExecution` 請求。如需詳細資訊，請參閱[任務裝置 MQTT API 操作](jobs-mqtt-api.md)。 | 
| $aws/things/{{thingName}}/jobs/start-next/accepted | 訂閱、接收 | 裝置訂閱此主題，以接收送往 `StartNextPendingJobExecution` 請求的成功回應。如需詳細資訊，請參閱[任務裝置 MQTT API 操作](jobs-mqtt-api.md)。 | 
| $aws/things/{{thingName}}/jobs/start-next/rejected | 訂閱、接收 | 當 `StartNextPendingJobExecution` 請求被拒時，裝置會訂閱此主題以接收回應。如需詳細資訊，請參閱[任務裝置 MQTT API 操作](jobs-mqtt-api.md)。 | 
| $aws/things/{{thingName}}/jobs/{{jobId}}/get | 發布 | 裝置發佈訊息到這個主題來提出 `DescribeJobExecution` 請求。如需詳細資訊，請參閱[任務裝置 MQTT API 操作](jobs-mqtt-api.md)。 | 
| $aws/things/{{thingName}}/jobs/{{jobId}}/get/accepted | 訂閱、接收 | 裝置訂閱此主題，以接收送往 `DescribeJobExecution` 請求的成功回應。如需詳細資訊，請參閱[任務裝置 MQTT API 操作](jobs-mqtt-api.md)。 | 
| $aws/things/{{thingName}}/jobs/{{jobId}}/get/rejected | 訂閱、接收 | 當 `DescribeJobExecution` 請求被拒時，裝置會訂閱此主題以接收回應。如需詳細資訊，請參閱[任務裝置 MQTT API 操作](jobs-mqtt-api.md)。 | 
| $aws/things/{{thingName}}/jobs/{{jobId}}/update | 發布 | 裝置發佈訊息到這個主題來提出 `UpdateJobExecution` 請求。如需詳細資訊，請參閱[任務裝置 MQTT API 操作](jobs-mqtt-api.md)。 | 
| $aws/things/{{thingName}}/jobs/{{jobId}}/update/accepted | 訂閱、接收 | 裝置訂閱此主題，以接收送往 `UpdateJobExecution` 請求的成功回應。如需詳細資訊，請參閱[任務裝置 MQTT API 操作](jobs-mqtt-api.md)。 注意 只有發佈到 $aws/things/{{thingName}}/jobs/{{jobId}}/update 的設備才會收到此主題的訊息。  | 
| $aws/things/{{thingName}}/jobs/{{jobId}}/update/rejected | 訂閱、接收 | 當 `UpdateJobExecution` 請求被拒時，裝置會訂閱此主題以接收回應。如需詳細資訊，請參閱[任務裝置 MQTT API 操作](jobs-mqtt-api.md)。 注意 只有發佈到 $aws/things/{{thingName}}/jobs/{{jobId}}/update 的設備才會收到此主題的訊息。  | 
| $aws/things/{{thingName}}/jobs/notify | 訂閱、接收 | 裝置訂閱此主題，以在物件的待處理執行清單新增或移除任務執行時接收通知。如需詳細資訊，請參閱[任務裝置 MQTT API 操作](jobs-mqtt-api.md)。 | 
| $aws/things/{{thingName}}/jobs/notify-next | 訂閱、接收 | 裝置訂閱此主題，以在物件的下一個待處理任務執行變更時接收通知。如需詳細資訊，請參閱[任務裝置 MQTT API 操作](jobs-mqtt-api.md)。 | 
| $aws/events/job/{{jobId}}/completed | 訂閱 | 任務完成時，任務服務會發佈這個主題的事件。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/job/{{jobId}}/canceled | 訂閱 | 任務取消時，任務服務會發佈這個主題的事件。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/job/{{jobId}}/deleted  | 訂閱 | 任務刪除時，任務服務會發佈這個主題的事件。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/job/{{jobId}}/cancellation\_in\_progress  | 訂閱 | 開始取消任務時，任務服務會發佈這個主題的事件。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/job/{{jobId}}/deletion\_in\_progress  | 訂閱 | 開始刪除任務時，任務服務會發佈這個主題的事件。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/jobExecution/{{jobId}}/succeeded  | 訂閱 | 任務執行成功時，任務服務會發佈這個主題的事件。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/jobExecution/{{jobId}}/failed  | 訂閱 | 任務執行失敗時，任務服務會發佈這個主題的事件。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/jobExecution/{{jobId}}/rejected  | 訂閱 | 任務執行遭拒時，任務服務會發佈這個主題的事件。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/jobExecution/{{jobId}}/canceled  | 訂閱 | 任務執行取消時，任務服務會發佈這個主題的事件。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/jobExecution/{{jobId}}/timed\_out  | 訂閱 | 任務執行逾時時，任務服務會發佈這個主題的事件。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/jobExecution/{{jobId}}/removed  | 訂閱 | 任務執行移除時，任務服務會發佈這個主題的事件。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 
| $aws/events/jobExecution/{{jobId}}/deleted  | 訂閱 | 任務執行刪除時，任務服務會發佈這個主題的事件。如需詳細資訊，請參閱[任務事件](events-jobs.md)。 | 

## 命令主題
<a name="reserved-topics-commands"></a>

**注意**  
此表格中標記為**接收**的用戶端操作指出直接 AWS IoT 發佈到請求它的用戶端的主題，無論用戶端是否已訂閱主題。即使用戶端尚未訂閱回應訊息，也應該預期會收到這些訊息。  
這些回應訊息不會透過訊息代理程式傳遞，而且其他用戶端或規則無法訂閱這些訊息。


| 主題 | 允許的用戶端操作 | Description | 
| --- | --- | --- | 
| $aws/commands/{{<devices>}}/{{<DeviceID>}}/executions/{{<ExecutionId>}}/request/{{<PayloadFormat>}}<br />$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>}}<br />$aws/commands/{{<devices>}}/{{<DeviceID>}}/executions/{{<ExecutionId>}}/response/accepted | 訂閱、接收 | 如果雲端服務成功處理命令執行結果， 會將回應 AWS IoT Device Management 發佈至 /接受的主題。 | 
| $aws/commands/{{<devices>}}/{{<DeviceID>}}/executions/{{<ExecutionId>}}/response/rejected/{{<PayloadFormat>}}<br />$aws/commands/{{<devices>}}/{{<DeviceID>}}/executions/{{<ExecutionId>}}/response/rejected | 發布 | 如果雲端服務無法處理命令執行結果， 會將回應 AWS IoT Device Management 發佈至 /拒絕主題。 | 

## 規則主題
<a name="reserved-topics-rule"></a>


| 主題 | 允許的用戶端操作 | Description | 
| --- | --- | --- | 
| $aws/rules/{{ruleName}} | 發布 | 裝置或應用程式會發佈至此主題，以直接觸發規則。如需詳細資訊，請參閱[使用基本擷取減少簡訊費用](iot-basic-ingest.md)。 | 

## 安全通道主題
<a name="reserved-topics-secure"></a>


| 主題 | 允許的用戶端操作 | Description | 
| --- | --- | --- | 
| $aws/things/{{thing-name}}/tunnels/notify | 訂閱 |  AWS IoT 會發佈此訊息，讓 IoT 代理程式在遠端裝置上啟動本機代理。如需詳細資訊，請參閱[IoT Agent Snippet](configure-remote-device.md#agent-snippet)。 | 

## 影子主題
<a name="reserved-topics-shadow"></a>

已命名的影子和未命名的影子會使用本節中的主題。各影子所使用的主題只有在主題字首中有所不同。此表格會顯示每種影子類型所使用的主題字首。


| {{ShadowTopicPrefix}} 值 | 影子類型 | 
| --- | --- | 
| $aws/things/{{thingName}}/shadow | 未命名 (經典) 影子 | 
| $aws/things/{{thingName}}/shadow/name/{{shadowName}} | 已命名影子 | 

若要建立完整的主題，請為您想要參照的影子類型選取 {{ShadowTopicPrefix}}，取代 {{thingName}} 和 {{shadowName}} (如果適用)，並使用其對應的值，然後將其附加到主題 stub，如下表所示。請記住，主題會區分大小寫。


| 主題 | 允許的用戶端操作 | Description | 
| --- | --- | --- | 
| {{ShadowTopicPrefix}}/delete | 發佈/訂閱 | 裝置或應用程式會發佈至此主題，以刪除影子。如需詳細資訊，請參閱 [/delete](device-shadow-mqtt.md#delete-pub-sub-topic)。 | 
| {{ShadowTopicPrefix}}/delete/accepted | 訂閱 | 當影子刪除時，Device Shadow 服務會傳送訊息至此主題。如需詳細資訊，請參閱 [/delete/accepted](device-shadow-mqtt.md#delete-accepted-pub-sub-topic)。 | 
| {{ShadowTopicPrefix}}/delete/rejected | 訂閱 | 拒絕刪除影子的要求時，Device Shadow 服務會傳送訊息至此主題。如需詳細資訊，請參閱 [/delete/rejected](device-shadow-mqtt.md#delete-rejected-pub-sub-topic)。 | 
| {{ShadowTopicPrefix}}/get | 發佈/訂閱 | 應用程式或物件會發佈空白訊息至此主題，以取得影子。如需詳細資訊，請參閱[Device Shadow MQTT 主題](device-shadow-mqtt.md)。 | 
| {{ShadowTopicPrefix}}/get/accepted | 訂閱 | 當要求影子成功時，Device Shadow 服務會傳送訊息至此主題。如需詳細資訊，請參閱 [/get/accepted](device-shadow-mqtt.md#get-accepted-pub-sub-topic)。 | 
| {{ShadowTopicPrefix}}/get/rejected | 訂閱 | 當要求影子被拒絕時，Device Shadow 服務會傳送訊息至此主題。如需詳細資訊，請參閱 [/get/rejected](device-shadow-mqtt.md#get-rejected-pub-sub-topic)。 | 
| {{ShadowTopicPrefix}}/update | 發佈/訂閱 | 物件或應用程式會發佈至此主題，以更新影子。如需詳細資訊，請參閱 [/update](device-shadow-mqtt.md#update-pub-sub-topic)。 | 
| {{ShadowTopicPrefix}}/update/accepted | 訂閱 | 當更新影子成功時，Device Shadow 服務會傳送訊息至此主題。如需詳細資訊，請參閱 [/update/accepted](device-shadow-mqtt.md#update-accepted-pub-sub-topic)。 | 
| {{ShadowTopicPrefix}}/update/rejected | 訂閱 | 當更新影子被拒絕時，Device Shadow 服務會傳送訊息至此主題。如需詳細資訊，請參閱 [/update/rejected](device-shadow-mqtt.md#update-rejected-pub-sub-topic)。 | 
| {{ShadowTopicPrefix}}/update/delta | 訂閱 | 當偵測到回報的區段與所需的區段之間發生差異時，Device Shadow 服務會傳送訊息至此主題。如需詳細資訊，請參閱 [/update/delta](device-shadow-mqtt.md#update-delta-pub-sub-topic)。 | 
| {{ShadowTopicPrefix}}/update/documents | 訂閱 | AWS IoT 每當成功執行影子更新時， 就會發佈狀態文件至此主題。如需詳細資訊，請參閱 [/update/documents](device-shadow-mqtt.md#update-documents-pub-sub-topic)。 | 

## MQTT 型檔案交付主題
<a name="reserved-topics-mqtt-based-file-delivery"></a>

**注意**  
此表格中標記為**接收**的用戶端操作指出直接 AWS IoT 發佈到請求它的用戶端的主題，無論用戶端是否已訂閱主題。即使用戶端尚未訂閱回應訊息，也應該預期會收到這些訊息。這些回應訊息不會透過訊息代理程式傳遞，而且其他用戶端或規則無法訂閱這些訊息。

這些訊息支援 Concise Binary Object Representation (CBOR) 格式和 JavaScript 物件標記法 (JSON) 的回應緩衝區，具體取決於主題的{{承載格式}}。


| {{承載格式}} | 回應格式資料類型 | 
| --- | --- | 
| cbor | Concise Binary Object Representation (CBOR) | 
| json | JavaScript 物件標記法 (JSON) | 


| 主題 | 允許的用戶端操作 | Description | 
| --- | --- | --- | 
| $aws/things/{{ThingName}}/streams/{{StreamId}}/data/{{payload-format}} | 訂閱、接收 | AWS 如果接受來自裝置的「GetStream」請求，則 MQTT 型檔案交付會發佈至此主題。承載包含串流資料。如需詳細資訊，請參閱[在裝置中使用 AWS IoT MQTT 型檔案交付](mqtt-based-file-delivery-in-devices.md)。 | 
| $aws/things/{{ThingName}}/streams/{{StreamId}}/get/{{payload-format}} | 發布 | 裝置會發佈至本主題，以執行 "GetStream" 請求。如需詳細資訊，請參閱[在裝置中使用 AWS IoT MQTT 型檔案交付](mqtt-based-file-delivery-in-devices.md)。 | 
| $aws/things/{{ThingName}}/streams/{{StreamId}}/description/{{payload-format}} | 訂閱、接收 | AWS 如果接受來自裝置的「DescribeStream」請求，則 MQTT 型檔案交付會發佈至此主題。承載包含串流描述。如需詳細資訊，請參閱[在裝置中使用 AWS IoT MQTT 型檔案交付](mqtt-based-file-delivery-in-devices.md)。 | 
| $aws/things/{{ThingName}}/streams/{{StreamId}}/describe/{{payload-format}} | 發布 | 裝置會發佈至本主題，以執行 "DescribeStream" 請求。如需詳細資訊，請參閱[在裝置中使用 AWS IoT MQTT 型檔案交付](mqtt-based-file-delivery-in-devices.md)。 | 
| $aws/things/{{ThingName}}/streams/{{StreamId}}/rejected/{{payload-format}} | 訂閱、接收 | AWS 如果來自裝置的「DescribeStream」或「GetStream」請求遭到拒絕，則 MQTT 型檔案交付會發佈至此主題。如需詳細資訊，請參閱[在裝置中使用 AWS IoT MQTT 型檔案交付](mqtt-based-file-delivery-in-devices.md)。 | 

## 預留的主題 ARN
<a name="reserved-topicnames-arn"></a>

所有預留的主題 ARN (Amazon Resource Names) 都具有以下形式：

```
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。