AWS IoT Device Shadow 服務

AWS IoT Device Shadow 服務會將陰影新增至 AWS IoT 物件物件。無論裝置是否連線，陰影都可讓應用程式和其他服務使用裝置 AWS IoT 的狀態。 AWS IoT 物件物件可以有多個命名陰影，因此您的 IoT 解決方案有更多選項可將裝置連接至其他應用程式和服務。

AWS IoT 在明確建立物件之前，物件物件沒有任何陰影。您可以使用 AWS IoT 控制台建立、更新和刪除陰影。裝置、其他 Web 用戶端和服務可使用 MQTT 及預留的 MQTT 主題、使用 Device Shadow REST API 的 HTTP，以及 AWS IoT 的 AWS CLI。由於陰影是由 AWS 雲端儲存，因此無論裝置是否連線，它們都可以從應用程式和其他雲端服務收集和報告裝置狀態資料。

使用影子

影子會提供可靠的資料存放區，讓裝置、應用程式和其他雲端服務共用資料。它們可讓裝置、應用程式和其他雲端服務連線和中斷連線，而不會遺失裝置的狀態。

當裝置、應用程式和其他雲端服務連線到時 AWS IoT，裝置可透過陰影存取和控制裝置的目前狀態。例如，應用程式可以透過更新陰影來要求變更裝置的狀態。 AWS IoT 會發佈訊息，指出裝置的變更。裝置會接收此訊息、更新其狀態以符合，並發佈具有更新狀態的訊息。Device Shadow 服務會在對應的影子中反映此更新的狀態。應用程式可以訂閱影子的更新，也可以查詢影子的目前狀態。

當設備離線時，應用程序仍然可以 AWS IoT 與設備的陰影進行通信。當裝置重新連線時，它會收到其影子的目前狀態，以便更新其狀態以符合其影子的狀態，然後發佈具有更新狀態的訊息。同樣地，當應用程式離線且裝置狀態在離線時變更時，裝置會保持影子更新，以便在重新連線時，應用程式可以查詢其目前狀態的影子。

如果您的裝置頻繁離線，而您希望將裝置設定為在重新連線後接收增量訊息，則可以使用持續工作階段功能。如需持續工作階段有效期限的詳細資訊，請參閱持續工作階段有效期限。

選擇使用已命名或未命名的影子

Device Shadow 服務支援已命名、未命名或傳統的影子。一個物件可以有多個已命名的影子，並且不超過一個未命名的影子。物件也可以具有預留已命名影子，其運作方式與已命名影子類似，只是您無法更新其名稱。如需詳細資訊，請參閱預留已命名影子。

一個物件物件可以同時具有已命名和未命名的影子；但是用於存取每個影子的 API 略有不同，所以決定最適合您解決方案的影子類型並僅使用該類型可能會更有效率。如需存取影子 API 的詳細資訊，請參閱影子主題。

使用已命名的影子，您可以建立物件物件狀態的不同檢視。例如，您可以將具有許多屬性的物件物件分割成具有邏輯屬性群組的影子，每個屬性都用其影子名稱加以識別。您也可以透過將屬性分組成不同的影子，並使用原則來控制存取來限制屬性的存取權限。如需與裝置影子搭配使用之政策的詳細資訊，請參閱適用於 AWS IoT 的動作、資源及條件索引鍵及 AWS IoT Core 政策。

典型、未命名的影子比已命名的影子更簡單，但限制比已命名的影子多。每個物 AWS IoT 件物件只能有一個未命名的陰影。如果您預期 IoT 解決方案對影子資料的需求有限，這可能就是您要開始使用影子的契機。但是，如果您認為未來可能想要增加其他影子，請考慮從一開始就使用已命名的影子。

機群索引以不同方式支援未命名的影子和已命名的影子。如需詳細資訊，請參閱管理機群索引。

存取影子

每個影子都有預留的 MQTT 主題和 HTTP URL，其支援在影子上的 get、update 和 delete 動作。

影子會使用 JSON 影子文件來儲存和擷取資料。影子的文件包含狀態屬性，描述裝置狀態的下列層面：

desired

應用程式會透過更新 desired 物件來指定裝置屬性的所需狀態。
reported

裝置會報告 reported 物件中的目前狀態。
delta

AWS IoT 報告物件中所需狀態與報告狀態之間的差delta異。

儲存在影子中的資料會由更新動作訊息內文的狀態屬性決定。後續的更新動作可以修改現有資料物件的值，也可以在影子的狀態物件中新增和刪除金鑰和其他元素。如需存取影子的詳細資訊，請參閱在裝置中使用影子和在應用程式和服務中使用影子。

重要

提出更新要求的權限應限於受信任的應用程式和裝置。這可以防止影子的狀態屬性遭意外地變更；否則，使用影子的裝置和應用程式的設計應預期狀態屬性中的金鑰會變更。

在裝置、應用程式和其他雲端服務中使用影子

在裝置、應用程式和其他雲端服務中使用影子需要一致性和協調性。 AWS IoT Device Shadow 服務會儲存陰影狀態、在陰影狀態變更時傳送訊息，以及回應變更其狀態的訊息。IoT 解決方案中的裝置、應用程式和其他雲端服務必須管理其狀態，並使其與 Device Shadow 狀態保持一致。

影子狀態資料是動態的，可由裝置、應用程式和其他具有存取影子權限的雲端服務進行變更。基於這個原因，請務必考慮每個裝置、應用程式和其他雲端服務如何與影子互動。例如：

將狀態資料傳到影子時，設備應該只會寫入影子狀態的 reported 屬性。
透過影子將狀態變更要求傳給裝置時，應用程式和其他雲端服務應該只會寫入 desired 屬性。

重要

包含在影子資料物件中的資料是獨立於其他影子和其他物件物件屬性的資料，例如物件的屬性和物件物件的裝置可能發佈的 MQTT 訊息內容。但如有必要，裝置可以在不同的 MQTT 主題和影子中報告相同的資料。

支援多重影子的裝置必須維持它在不同影子中報告之資料的一致性。

訊息順序

不保證來自 AWS IoT 服務的消息將以任何特定順序到達設備。下列情境說明在此情況下會發生的情況。

初始狀態文件：


{
  "state": {
    "reported": {
      "color": "blue"
    }
  },
  "version": 9,
  "timestamp": 123456776
}

更新 1：


{
  "state": {
    "desired": {
      "color": "RED"
    }
  },
  "version": 10,
  "timestamp": 123456777
}

更新 2：


{
  "state": {
    "desired": {
      "color": "GREEN"
    }
  },
  "version": 11,
  "timestamp": 123456778
}

最終狀態文件：


{
  "state": {
    "reported": {
      "color": "GREEN"
    }
  },
  "version": 12,
  "timestamp": 123456779
}

這樣會產生兩個差量訊息：


{
  "state": {
    "color": "RED"
  },
  "version": 11,
  "timestamp": 123456778
}


{
  "state": {
    "color": "GREEN"
  },
  "version": 12,
  "timestamp": 123456779
}

裝置可能不會依此順序收到這些訊息。由於這些訊息中的狀態是累積的，因此裝置可以安全捨棄比追蹤中版本編號更舊的所有訊息。如果裝置在接收到版本 11 的差量之前收到了版本 12 的差量，則可安全捨棄版本 11 的訊息。

裁剪影子訊息

若要減少傳送至您裝置的影子訊息大小，請定義只選擇了裝置所需之欄位的規則，然後將訊息重新發佈至裝置目前監聽的 MQTT 主題。

規則是在 JSON 中指定，並應如下所示：


{
  "sql": "SELECT state, version FROM '$aws/things/+/shadow/update/delta'",
  "ruleDisabled": false,
  "actions": [
    {
      "republish": {
        "topic": "${topic(3)}/delta",
        "roleArn": "arn:aws:iam:123456789012:role/my-iot-role"
      }
    }
  ]
}

SELECT 陳述會決定將訊息的哪些欄位重新發佈至指定主題。使用 "+" 萬用字元表示所有影子名稱。規則會指定所有符合的訊息都應重新發佈至指定主題。在這種情況下，該 "topic()" 函數是用於指定要重新發佈的主題。topic(3) 會評估原始主題中的物件名稱。如需關於建立規則的詳細資訊，請參閱的規則 AWS IoT。

您的瀏覽器已停用或無法使用 Javascript。

您必須啟用 Javascript，才能使用 AWS 文件。請參閱您的瀏覽器說明頁以取得說明。

文件慣用形式

SQL 版本

在裝置中使用影子