與影子互動

用戶端應具有目前的影子文件，以便識別要變更的屬性。請參閱 /get 動作，了解如何取得目前的影子文件。

用戶端會訂閱下列 MQTT 主題：

用戶端會發佈 $aws/things/thingName/shadow/name/shadowName/update 請求主題，其中包含所需的影子狀態的狀態文件。只有要變更的屬性需要包含在文件中。這是具有所需狀態的文件的範例。

{
  "state": {
    "desired": {
      "color": {
        "r": 10
      },
      "engine": "ON"
    }
  }
}

如果更新要求有效，請在陰影中 AWS IoT 更新所需的狀態，並發佈下列主題的訊息：

/update/accepted 訊息包含 /accepted response state document 影子文件，而 /update/delta 訊息包含 /delta response state document 影子文件。

如果更新要求無效，會 AWS IoT 發佈一則訊息，其中包含描述錯誤的錯誤回應文件陰影文件的$aws/things/thingName/shadow/name/shadowName/update/rejected主題。

用戶端呼叫 UpdateThingShadow API，包含作為其訊息內文的 請求狀態文件 狀態文件。

如果要求有效，會 AWS IoT 傳回 HTTP 成功回應碼和/accepted response state document陰影文件做為其回應訊息內文。

AWS IoT 也會針對任何訂閱的裝置或用戶端，將 MQTT 訊息以及/delta response state document陰影文件的$aws/things/thingName/shadow/name/shadowName/update/delta主題發佈至主題。

如果要求無效，會 AWS IoT 傳回 HTTP 錯誤回應碼 a 錯誤回應文件 做為其回應訊息內文。

裝置應該在更新影子之前訂閱這些 MQTT 主題：

裝置會將訊息發佈至報告目前狀態的 $aws/things/thingName/shadow/name/shadowName/update 主題，例如在此範例中，以報告其目前狀態。

{
    "state": {
        "reported" : {
            "color" : { "r" : 10 },
            "engine" : "ON"
        }
    }
}

如果 AWS IoT 接受更新，則會將訊息發佈至具有/accepted response state document陰影文件的$aws/things/thingName/shadow/name/shadowName/update/accepted主題。

如果更新要求無效，會 AWS IoT 發佈一則訊息，其中包含描述錯誤的錯誤回應文件陰影文件的$aws/things/thingName/shadow/name/shadowName/update/rejected主題。

裝置會呼叫 UpdateThingShadow API，包含 請求狀態文件 狀態文件作為其訊息正文。

如果要求有效，請 AWS IoT 更新陰影，並傳回含有/accepted response state document陰影文件做為其回應訊息內文的 HTTP 成功回應碼。

AWS IoT 也會針對任何訂閱的裝置或用戶端，將 MQTT 訊息以及/delta response state document陰影文件的$aws/things/thingName/shadow/name/shadowName/update/delta主題發佈至主題。

如果要求無效，會 AWS IoT 傳回 HTTP 錯誤回應碼 a 錯誤回應文件 做為其回應訊息內文。

裝置或用戶端應該在更新影子之前訂閱這些 MQTT 主題：

裝置或用戶端會將訊息發佈至具有空白訊息內文的 $aws/things/thingName/shadow/name/shadowName/get 主題。

如果要求成功，則會將訊息 AWS IoT 發佈至訊息內文/accepted response state document中的$aws/things/thingName/shadow/name/shadowName/get/accepted主題。

如果要求無效，請將訊息 AWS IoT 發佈至訊息內文錯誤回應文件中的$aws/things/thingName/shadow/name/shadowName/get/rejected主題。

裝置或用戶端會使用空的訊息內文呼叫 GetThingShadow API。

如果要求有效，會 AWS IoT 傳回含有/accepted response state document陰影文件做為其回應訊息內文的 HTTP 成功回應碼。

如果要求無效，會 AWS IoT 傳回 HTTP 錯誤回應碼 a 錯誤回應文件 做為其回應訊息內文。

裝置或用戶端應該有目前的影子文件，以便識別要變更的屬性。如需如何取得目前影子文件的詳細資訊，請參閱 擷取影子文件。

裝置或用戶端會訂閱下列 MQTT 主題：

裝置或用戶端會發佈 $aws/things/thingName/shadow/name/shadowName/update 請求主題，其中包含狀態文件，該文件會將 null 值指派給要刪除的影子屬性。只有要變更的屬性需要包含在文件中。這是刪除 engine 屬性的文件範例。

{
  "state": {
    "desired": {
      "engine": null
    }
  }
}

如果更新要求有效， AWS IoT 會刪除陰影中指定的屬性，並在郵件內文中發行含有/accepted response state document陰影文件$aws/things/thingName/shadow/name/shadowName/update/accepted主題的郵件。

如果更新要求無效，會 AWS IoT 發佈一則訊息，其中包含描述錯誤的錯誤回應文件陰影文件的$aws/things/thingName/shadow/name/shadowName/update/rejected主題。

裝置或用戶端會呼叫 UpdateThingShadow API，其具有將 null 值指派給要刪除之影子屬性的 請求狀態文件。只包含您要在文件中刪除的屬性。這是刪除 engine 屬性的文件範例。

{
  "state": {
    "desired": {
      "engine": null
    }
  }
}

如果要求有效，會 AWS IoT 傳回 HTTP 成功回應碼和/accepted response state document陰影文件做為其回應訊息內文。

如果要求無效，會 AWS IoT 傳回 HTTP 錯誤回應碼 a 錯誤回應文件 做為其回應訊息內文。

裝置或用戶端會訂閱下列 MQTT 主題：

裝置或用戶端會發佈具有空白訊息緩衝區的 $aws/things/thingName/shadow/name/shadowName/delete。

如果刪除要求有效，請刪 AWS IoT 除陰影，並在郵件內文中發佈包含$aws/things/thingName/shadow/name/shadowName/delete/accepted主題和縮寫/accepted response state document陰影文件的郵件。以下是接受的刪除訊息範例：

{
  "version": 4,
  "timestamp": 1591057529
}

如果更新要求無效，會 AWS IoT 發佈一則訊息，其中包含描述錯誤的錯誤回應文件陰影文件的$aws/things/thingName/shadow/name/shadowName/delete/rejected主題。

裝置或用戶端會使用空的訊息緩衝區呼叫 DeleteThingShadow API。

如果要求有效，會 AWS IoT 傳回 HTTP 成功回應碼，以/accepted response state document及郵件內文中縮寫的/accepted response state document陰影文件。以下是接受的刪除訊息範例：

{
  "version": 4,
  "timestamp": 1591057529
}

如果要求無效，會 AWS IoT 傳回 HTTP 錯誤回應碼 a 錯誤回應文件 做為其回應訊息內文。