Shadow 管理員 - AWS IoT Greengrass

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

Shadow 管理員

影子管理員元件 (aws.greengrass.ShadowManager) 會在您的核心裝置上啟用本機影子服務。本機影子服務允許元件使用程序間通訊與本機影子互動。影子管理員元件會管理本機影子文件的儲存,也會處理本機影子狀態與 AWS IoT Device Shadow 服務的同步。

如需 Greengrass 核心裝置如何與影子互動的詳細資訊,請參閱 與裝置陰影互動

版本

此元件具有下列版本:

  • 2.3.x 版本

  • 2.2.x 版本

  • 2.1.x

  • 2.0.x

Type

此元件是外掛程式元件 (aws.greengrass.plugin)。Greengrass 核會在與核相同的 Java 虛擬機器 (JVM) 中執行此元件。當您在核心裝置上變更此元件的版本時,核會重新啟動。

此元件使用與 Greengrass 核相同的日誌檔案。如需詳細資訊,請參閱監控AWS IoT Greengrass日誌

如需詳細資訊,請參閱元件類型

作業系統

此元件可以安裝在執行下列作業系統的核心裝置上:

  • Linux

  • Windows

要求

此元件有下列需求:

  • (選用) 若要將影子同步至 AWS IoT Device Shadow 服務,Greengrass 核心裝置的 AWS IoT 政策必須允許下列 AWS IoT Core 影子政策動作:

    • iot:GetThingShadow

    • iot:UpdateThingShadow

    • iot:DeleteThingShadow

    如需這些 AWS IoT Core 政策的詳細資訊,請參閱《 AWS IoT 開發人員指南》中的AWS IoT Core 政策動作

    如需最低 AWS IoT 政策的詳細資訊,請參閱 AWS IoT Greengrass V2核心裝置的最低AWS IoT原則

  • 支援影子管理員元件在 中執行VPC。

相依性

當您部署元件時, AWS IoT Greengrass 也會部署其相依性的相容版本。這表示您必須符合元件及其所有相依性的要求,才能成功部署元件。本節列出此元件發行版本的相依性,以及為每個相依性定義元件版本的語意版本限制。您也可以在 AWS IoT Greengrass 主控台中檢視每個版本元件的相依性。在元件詳細資訊頁面上,尋找相依性清單。

2.3.10

下表列出此元件 2.3.10 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.5.0 <2.15.0 軟式
2.3.9

下表列出此元件 2.3.9 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.5.0 <2.14.0 軟式
2.3.5 – 2.3.8

下表列出此元件 2.3.5 至 2.3.8 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.5.0 <2.13.0 軟式
2.3.3 and 2.3.4

下表列出此元件 2.3.3 和 2.3.4 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.5.0 <2.12.0 軟式
2.3.2

下表列出此元件 2.3.2 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.5.0 <2.11.0 軟式
2.3.0 and 2.3.1

下表列出此元件 2.3.0 和 2.3.1 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.5.0 <2.10.0 軟式
2.2.3 and 2.2.4

下表列出此元件 2.2.3 和 2.2.4 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <3.0.0 軟式
2.2.2

下表列出此元件 2.2.2 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.9.0 軟式
2.2.1

下表列出此元件 2.2.1 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.8.0 軟式
2.1.1 and 2.2.0

下表列出此元件 2.1.1 和 2.2.0 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.7.0 軟式
2.0.5 - 2.1.0

下表列出此元件 2.0.5 到 2.1.0 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.6.0 軟式
2.0.3 and 2.0.4

下表列出此元件 2.0.3 和 2.0.4 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.5.0 軟式
2.0.1 and 2.0.2

下表列出此元件 2.0.1 和 2.0.2 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.4.0 軟式
2.0.0

下表列出此元件 2.0.0 版的相依性。

相依性 相容版本 相依性類型
Greengrass 核 >=2.2.0 <2.3.0 軟式

如需元件相依性的詳細資訊,請參閱元件配方參考

組態

此元件提供下列組態參數,您可以在部署元件時自訂這些參數。

2.3.x
strategy

(選用) 此元件用來同步 AWS IoT Core 和 核心裝置之間的陰影的策略。

此物件包含下列資訊。

type

(選用) 此元件用於在 AWS IoT Core 和 核心裝置之間同步陰影的策略類型。您可以從以下選項中選擇:

  • realTime – 每次進行影子更新 AWS IoT Core 時,同步影子。

  • periodic – AWS IoT Core 以您使用delay組態參數指定的定期間隔,將陰影與 同步。

預設:realTime

delay

(選用) 當您指定同步策略時 AWS IoT Core,此元件與 periodic同步陰影的間隔,以秒為單位。

注意

如果您指定periodic同步策略,則需要此參數。

synchronize

(選用) 同步設定,用於決定影子與 同步的方式 AWS 雲端。

注意

您必須使用此屬性建立組態更新,才能與 同步陰影 AWS 雲端。

此物件包含下列資訊。

coreThing

(選用) 要同步的核心裝置陰影。此物件包含下列資訊。

classic

(選用) 根據預設,影子管理員會使用 同步核心裝置傳統影子的本機狀態 AWS 雲端。如果您不想同步傳統裝置影子,請將此設為 false

預設:true

namedShadows

(選用) 要同步的具名核心裝置影子清單。您必須指定影子的確切名稱。

警告

AWS IoT Greengrass 服務使用AWSManagedGreengrassV2Deployment具名影子來管理以個別核心裝置為目標的部署。此具名影子會保留供 AWS IoT Greengrass 服務使用。請勿更新或刪除此具名影子。

shadowDocumentsMap

(選用) 要同步的其他裝置陰影。使用此組態參數可更輕鬆地指定陰影文件。我們建議您使用此參數,而非 shadowDocuments 物件。

注意

如果您指定shadowDocumentsMap物件,則不得指定shadowDocuments物件。

每個物件都包含下列資訊:

thingName

此影子組態之 thingName的影子組態。

classic

(選用) 如果您不想同步thingName裝置的傳統裝置影子,請將此設為 false

namedShadows

您要同步的具名陰影清單。您必須指定影子的確切名稱。

shadowDocuments

(選用) 要同步的其他裝置陰影清單。我們建議您改用 shadowDocumentsMap 參數。

注意

如果您指定shadowDocuments物件,則不得指定shadowDocumentsMap物件。

此清單中的每個物件都包含下列資訊。

thingName

要同步陰影之裝置的物件名稱。

classic

(選用) 如果您不想同步thingName裝置的傳統裝置影子,請將此設為 false

預設:true

namedShadows

(選用) 您要同步的具名裝置陰影清單。您必須指定影子的確切名稱。

direction

(選用) 在本機影子服務與 之間同步影子的方向 AWS 雲端。您可以設定此選項,以減少頻寬和對 的連線 AWS 雲端。您可以從以下選項中選擇:

  • betweenDeviceAndCloud – 同步本機影子服務與 之間的影子 AWS 雲端。

  • deviceToCloud – 將陰影更新從本機陰影服務傳送至 AWS 雲端,並忽略來自 的陰影更新 AWS 雲端。

  • cloudToDevice – 接收來自 的陰影更新 AWS 雲端,且不要將陰影更新從本機陰影服務傳送至 AWS 雲端。

預設:BETWEEN_DEVICE_AND_CLOUD

rateLimits

(選用) 決定陰影服務請求速率限制的設定。

此物件包含下列資訊。

maxOutboundSyncUpdatesPerSecond

(選用) 裝置每秒傳輸的同步請求數量上限。

預設:100 個請求/秒

maxTotalLocalRequestsRate

(選用) 每秒傳送至核心裝置的本機IPC請求數量上限。

預設:200 個請求/秒

maxLocalRequestsPerSecondPerThing

(選用) 每秒針對每個連線 IoT 物件傳送的本機IPC請求數量上限。

預設:每個物件每秒 20 個請求

注意

這些速率限制參數會定義本機影子服務的每秒請求數上限。 AWS IoT Device Shadow 服務的每秒請求數上限取決於您的 AWS 區域。如需詳細資訊,請參閱 中的 AWS IoT Device Shadow Service API 限制Amazon Web Services 一般參考

shadowDocumentSizeLimitBytes

(選用) 本機影子的每個JSON狀態文件允許的大小上限。

如果您增加此值,也必須增加雲端影子JSON狀態文件的資源限制。如需詳細資訊,請參閱 中的 AWS IoT Device Shadow Service API 限制Amazon Web Services 一般參考

預設:8192 位元組

上限:30720 位元組

範例:組態合併更新

下列範例顯示範例組態合併更新,其中包含影子管理員元件的所有可用組態參數。

{ "strategy":{ "type":"periodic", "delay":300 }, "synchronize":{ "shadowDocumentsMap":{ "MyDevice1":{ "classic":false, "namedShadows":[ "MyShadowA", "MyShadowB" ] }, "MyDevice2":{ "classic":true, "namedShadows":[] } }, "direction":"betweenDeviceAndCloud" }, "rateLimits":{ "maxOutboundSyncUpdatesPerSecond":100, "maxTotalLocalRequestsRate":200, "maxLocalRequestsPerSecondPerThing":20 }, "shadowDocumentSizeLimitBytes":8192 }
2.2.x
strategy

(選用) 此元件用來同步 AWS IoT Core 和 核心裝置之間的陰影的策略。

此物件包含下列資訊。

type

(選用) 此元件用於在 AWS IoT Core 和 核心裝置之間同步陰影的策略類型。您可以從以下選項中選擇:

  • realTime – 每次進行影子更新 AWS IoT Core 時,同步影子。

  • periodic – AWS IoT Core 以您使用delay組態參數指定的定期間隔,將陰影與 同步。

預設:realTime

delay

(選用) 當您指定同步策略時 AWS IoT Core,此元件與 periodic同步陰影的間隔,以秒為單位。

注意

如果您指定periodic同步策略,則需要此參數。

synchronize

(選用) 同步設定,用於決定影子與 同步的方式 AWS 雲端。

注意

您必須使用此屬性建立組態更新,才能與 同步陰影 AWS 雲端。

此物件包含下列資訊。

coreThing

(選用) 要同步的核心裝置陰影。此物件包含下列資訊。

classic

(選用) 根據預設,影子管理員會同步核心裝置傳統影子的本機狀態與 AWS 雲端。如果您不想同步傳統裝置影子,請將此設為 false

預設:true

namedShadows

(選用) 要同步的具名核心裝置影子清單。您必須指定陰影的確切名稱。

警告

AWS IoT Greengrass 服務使用AWSManagedGreengrassV2Deployment具名影子來管理以個別核心裝置為目標的部署。此具名影子會保留供 AWS IoT Greengrass 服務使用。請勿更新或刪除此具名影子。

shadowDocumentsMap

(選用) 要同步的其他裝置陰影。使用此組態參數可更輕鬆地指定陰影文件。我們建議您使用此參數,而非 shadowDocuments 物件。

注意

如果您指定shadowDocumentsMap物件,則不得指定shadowDocuments物件。

每個物件都包含下列資訊:

thingName

此影子組態之 thingName的影子組態。

classic

(選用) 如果您不想同步thingName裝置的傳統裝置影子,請將此設為 false

namedShadows

您要同步的具名陰影清單。您必須指定陰影的確切名稱。

shadowDocuments

(選用) 要同步的其他裝置陰影清單。我們建議您改用 shadowDocumentsMap 參數。

注意

如果您指定shadowDocuments物件,則不得指定shadowDocumentsMap物件。

此清單中的每個物件都包含下列資訊。

thingName

要同步陰影之裝置的物件名稱。

classic

(選用) 如果您不想同步thingName裝置的傳統裝置影子,請將此設為 false

預設:true

namedShadows

(選用) 您要同步的具名裝置陰影清單。您必須指定陰影的確切名稱。

direction

(選用) 在本機影子服務與 之間同步影子的方向 AWS 雲端。您可以設定此選項,以減少頻寬和對 的連線 AWS 雲端。您可以從以下選項中選擇:

  • betweenDeviceAndCloud – 同步本機影子服務與 之間的影子 AWS 雲端。

  • deviceToCloud – 將陰影更新從本機陰影服務傳送至 AWS 雲端,並忽略來自 的陰影更新 AWS 雲端。

  • cloudToDevice – 接收來自 的陰影更新 AWS 雲端,且不要將陰影更新從本機陰影服務傳送至 AWS 雲端。

預設:BETWEEN_DEVICE_AND_CLOUD

rateLimits

(選用) 決定陰影服務請求速率限制的設定。

此物件包含下列資訊。

maxOutboundSyncUpdatesPerSecond

(選用) 裝置每秒傳輸的同步請求數量上限。

預設:100 個請求/秒

maxTotalLocalRequestsRate

(選用) 每秒傳送至核心裝置的本機IPC請求數量上限。

預設:200 個請求/秒

maxLocalRequestsPerSecondPerThing

(選用) 每秒針對每個連線 IoT 物件傳送的本機IPC請求數量上限。

預設:每個物件每秒 20 個請求

注意

這些速率限制參數會定義本機影子服務的每秒請求數上限。 AWS IoT Device Shadow 服務的每秒請求數上限取決於您的 AWS 區域。如需詳細資訊,請參閱 中的 AWS IoT Device Shadow Service API 限制Amazon Web Services 一般參考

shadowDocumentSizeLimitBytes

(選用) 本機影子的每個JSON狀態文件允許的大小上限。

如果您增加此值,也必須增加雲端影子JSON狀態文件的資源限制。如需詳細資訊,請參閱 中的 AWS IoT Device Shadow Service API 限制Amazon Web Services 一般參考

預設:8192 位元組

上限:30720 位元組

範例:組態合併更新

下列範例顯示範例組態合併更新,其中包含影子管理員元件的所有可用組態參數。

{ "strategy":{ "type":"periodic", "delay":300 }, "synchronize":{ "shadowDocumentsMap":{ "MyDevice1":{ "classic":false, "namedShadows":[ "MyShadowA", "MyShadowB" ] }, "MyDevice2":{ "classic":true, "namedShadows":[] } }, "direction":"betweenDeviceAndCloud" }, "rateLimits":{ "maxOutboundSyncUpdatesPerSecond":100, "maxTotalLocalRequestsRate":200, "maxLocalRequestsPerSecondPerThing":20 }, "shadowDocumentSizeLimitBytes":8192 }
2.1.x
strategy

(選用) 此元件用來同步 AWS IoT Core 和 核心裝置之間的陰影的策略。

此物件包含下列資訊。

type

(選用) 此元件用來同步 AWS IoT Core 和 核心裝置之間的陰影的策略類型。您可以從以下選項中選擇:

  • realTime – 每次進行影子更新 AWS IoT Core 時,同步影子。

  • periodic – AWS IoT Core 以您使用delay組態參數指定的定期間隔,將陰影與 同步。

預設:realTime

delay

(選用) 當您指定同步策略時 AWS IoT Core,此元件與 periodic同步陰影的間隔,以秒為單位。

注意

如果您指定periodic同步策略,則需要此參數。

synchronize

(選用) 同步設定,用於決定影子與 同步的方式 AWS 雲端。

注意

您必須使用此屬性建立組態更新,才能與 同步陰影 AWS 雲端。

此物件包含下列資訊。

coreThing

(選用) 要同步的核心裝置陰影。此物件包含下列資訊。

classic

(選用) 根據預設,影子管理員會同步核心裝置傳統影子的本機狀態與 AWS 雲端。如果您不想同步傳統裝置影子,請將此設為 false

預設:true

namedShadows

(選用) 要同步的具名核心裝置影子清單。您必須指定陰影的確切名稱。

警告

AWS IoT Greengrass 服務使用AWSManagedGreengrassV2Deployment具名影子來管理以個別核心裝置為目標的部署。此具名影子會保留供 AWS IoT Greengrass 服務使用。請勿更新或刪除此具名影子。

shadowDocumentsMap

(選用) 要同步的其他裝置陰影。使用此組態參數可更輕鬆地指定陰影文件。我們建議您使用此參數,而非 shadowDocuments 物件。

注意

如果您指定shadowDocumentsMap物件,則不得指定shadowDocuments物件。

每個物件都包含下列資訊:

thingName

此影子組態之 thingName的影子組態。

classic

(選用) 如果您不想同步thingName裝置的傳統裝置影子,請將此設為 false

namedShadows

您要同步的具名陰影清單。您必須指定陰影的確切名稱。

shadowDocuments

(選用) 要同步的其他裝置陰影清單。我們建議您改用 shadowDocumentsMap 參數。

注意

如果您指定shadowDocuments物件,則不得指定shadowDocumentsMap物件。

此清單中的每個物件都包含下列資訊。

thingName

要同步陰影之裝置的物件名稱。

classic

(選用) 如果您不想同步thingName裝置的傳統裝置影子,請將此設為 false

預設:true

namedShadows

(選用) 您要同步的具名裝置陰影清單。您必須指定陰影的確切名稱。

rateLimits

(選用) 決定陰影服務請求速率限制的設定。

此物件包含下列資訊。

maxOutboundSyncUpdatesPerSecond

(選用) 裝置每秒傳輸的同步請求數量上限。

預設:100 個請求/秒

maxTotalLocalRequestsRate

(選用) 每秒傳送至核心裝置的本機IPC請求數量上限。

預設:200 個請求/秒

maxLocalRequestsPerSecondPerThing

(選用) 每秒針對每個連線 IoT 物件傳送的本機IPC請求數量上限。

預設:每個物件每秒 20 個請求

注意

這些速率限制參數會定義本機影子服務的每秒請求數上限。 AWS IoT Device Shadow 服務的每秒請求數上限取決於您的 AWS 區域。如需詳細資訊,請參閱 中的 AWS IoT Device Shadow Service API 限制Amazon Web Services 一般參考

shadowDocumentSizeLimitBytes

(選用) 本機影子的每個JSON狀態文件允許的大小上限。

如果您增加此值,也必須增加雲端影子JSON狀態文件的資源限制。如需詳細資訊,請參閱 中的 AWS IoT Device Shadow Service API 限制Amazon Web Services 一般參考

預設:8192 位元組

上限:30720 位元組

範例:組態合併更新

下列範例顯示範例組態合併更新,其中包含影子管理員元件的所有可用組態參數。

{ "strategy":{ "type":"periodic", "delay":300 }, "synchronize":{ "shadowDocumentsMap":{ "MyDevice1":{ "classic":false, "namedShadows":[ "MyShadowA", "MyShadowB" ] }, "MyDevice2":{ "classic":true, "namedShadows":[] } }, "direction":"betweenDeviceAndCloud" }, "rateLimits":{ "maxOutboundSyncUpdatesPerSecond":100, "maxTotalLocalRequestsRate":200, "maxLocalRequestsPerSecondPerThing":20 }, "shadowDocumentSizeLimitBytes":8192 }
2.0.x
synchronize

(選用) 同步設定,用於決定影子與 同步的方式 AWS 雲端。

注意

您必須使用此屬性建立組態更新,才能與 同步陰影 AWS 雲端。

此物件包含下列資訊。

coreThing

(選用) 要同步的核心裝置陰影。此物件包含下列資訊。

classic

(選用) 根據預設,影子管理員會同步核心裝置傳統影子的本機狀態與 AWS 雲端。如果您不想同步傳統裝置影子,請將此設為 false

預設:true

namedShadows

(選用) 要同步的具名核心裝置影子清單。您必須指定陰影的確切名稱。

警告

AWS IoT Greengrass 服務使用AWSManagedGreengrassV2Deployment具名影子來管理以個別核心裝置為目標的部署。此具名影子會保留供 AWS IoT Greengrass 服務使用。請勿更新或刪除此具名影子。

shadowDocumentsMap

(選用) 要同步的其他裝置陰影。使用此組態參數可更輕鬆地指定陰影文件。我們建議您使用此參數,而非 shadowDocuments 物件。

注意

如果您指定shadowDocumentsMap物件,則不得指定shadowDocuments物件。

每個物件都包含下列資訊:

thingName

此影子組態之 thingName的影子組態。

classic

(選用) 如果您不想同步thingName裝置的傳統裝置影子,請將此設為 false

namedShadows

您要同步的具名陰影清單。您必須指定陰影的確切名稱。

shadowDocuments

(選用) 要同步的其他裝置陰影清單。我們建議您改用 shadowDocumentsMap 參數。

注意

如果您指定shadowDocuments物件,則不得指定shadowDocumentsMap物件。

此清單中的每個物件都包含下列資訊。

thingName

要同步陰影之裝置的物件名稱。

classic

(選用) 如果您不想同步thingName裝置的傳統裝置影子,請將此設為 false

預設:true

namedShadows

(選用) 您要同步的具名裝置陰影清單。您必須指定陰影的確切名稱。

rateLimits

(選用) 決定陰影服務請求速率限制的設定。

此物件包含下列資訊。

maxOutboundSyncUpdatesPerSecond

(選用) 裝置每秒傳輸的同步請求數量上限。

預設:100 個請求/秒

maxTotalLocalRequestsRate

(選用) 每秒傳送至核心裝置的本機IPC請求數量上限。

預設:200 個請求/秒

maxLocalRequestsPerSecondPerThing

(選用) 每秒針對每個連線 IoT 物件傳送的本機IPC請求數量上限。

預設:每個物件每秒 20 個請求

注意

這些速率限制參數會定義本機影子服務的每秒請求數上限。 AWS IoT Device Shadow 服務的每秒請求數上限取決於您的 AWS 區域。如需詳細資訊,請參閱 中的 AWS IoT Device Shadow Service API 限制Amazon Web Services 一般參考

shadowDocumentSizeLimitBytes

(選用) 本機影子的每個JSON狀態文件允許的大小上限。

如果您增加此值,也必須增加雲端影子JSON狀態文件的資源限制。如需詳細資訊,請參閱 中的 AWS IoT Device Shadow Service API 限制Amazon Web Services 一般參考

預設:8192 位元組

上限:30720 位元組

範例:組態合併更新

下列範例顯示範例組態合併更新,其中包含影子管理員元件的所有可用組態參數。

{ "synchronize": { "coreThing": { "classic": true, "namedShadows": [ "MyCoreShadowA", "MyCoreShadowB" ] }, "shadowDocuments": [ { "thingName": "MyDevice1", "classic": false, "namedShadows": [ "MyShadowA", "MyShadowB" ] }, { "thingName": "MyDevice2", "classic": true, "namedShadows": [] } ] }, "rateLimits": { "maxOutboundSyncUpdatesPerSecond": 100, "maxTotalLocalRequestsRate": 200, "maxLocalRequestsPerSecondPerThing": 20 }, "shadowDocumentSizeLimitBytes": 8192 }

本機日誌檔案

此元件使用與 Greengrass 核元件相同的日誌檔案。

Linux
/greengrass/v2/logs/greengrass.log
Windows
C:\greengrass\v2\logs\greengrass.log
檢視此元件的日誌
  • 在核心裝置上執行下列命令,以即時檢視此元件的日誌檔案。將 /greengrass/v2或 取代C:\greengrass\v2為 AWS IoT Greengrass 根資料夾的路徑。

    Linux
    sudo tail -f /greengrass/v2/logs/greengrass.log
    Windows (PowerShell)
    Get-Content C:\greengrass\v2\logs\greengrass.log -Tail 10 -Wait

變更記錄

下表說明每個版本元件的變更。

版本

變更

2.3.10

針對 Greengrass nucleus 2.14.0 版更新版本。

2.3.9

針對 Greengrass nucleus 2.13.0 版更新版本。

2.3.8

錯誤修正和改善
  • 修正陰影管理員在MQTT用戶端連線期間建立死鎖情況的問題。

2.3.7

錯誤修正和改善
  • 修正陰影管理員在陰影管理員同步期間定期記錄NullPointerException錯誤的問題。

2.3.6

錯誤修正和改善
  • 修正在裝置離線時透過 AWS 雲端 更新刪除影子屬性的問題,在重新取得連線後仍持續存在於本機影子中。

2.3.5

針對 Greengrass nucleus 2.12.0 版更新版本。

2.3.4

錯誤修正和改善
  • 新增對 null 和空白陰影狀態文件的支援。

2.3.3

針對 Greengrass nucleus 2.11.0 版更新版本。

2.3.2

錯誤修正和改善
  • 修正當本機影子資料庫損毀時影子管理員進入 BROKEN 狀態的問題。

  • 針對 Greengrass nucleus 2.10.0 版更新版本。

2.3.1

錯誤修正和改善
  • 修正可能阻止雲端影子更新同步的條件。

  • 修正對具名影子同步組態的變更僅適用於一個具名影子的問題。

2.3.0

錯誤修正和改善
  • 修正在 Greengrass 裝置私有金鑰存放在硬體安全模組中時,可能阻止影子同步的問題。

2.2.4

錯誤修正和改善
  • 修正更新本機影子文件時,影子大小驗證與雲端不一致的問題。

  • 修正部署在組態節點RESET上執行 時,陰影管理員停止接聽組態更新的問題。

2.2.3

針對 Greengrass nucleus 2.9.0 版更新版本。

2.2.2

針對 Greengrass nucleus 2.8.0 版更新版本。

2.2.1

針對 Greengrass nucleus 2.7.0 版更新版本。

2.2.0

新功能
  • 透過本機publish/subscribe interface. You can now communicate with the local publish/subscribe訊息代理程式新增本機影子服務的支援,MQTT以取得、更新和刪除核心裝置上的影子。此功能可讓您使用MQTT橋接器,在用戶端裝置與本機發佈/訂閱界面之間轉送影子主題的訊息,將用戶端裝置連線至本機影子服務。

    此功能需要 2.6.0 版或更新版本的 Greengrass 核元件。若要將用戶端裝置連線至本機影子服務,您還必須使用 MQTT橋接元件的 v2.2.0 或更新版本。

  • 新增您可以設定的 direction選項,以自訂方向,在本機影子服務與 之間同步影子 AWS 雲端。您可以設定此選項,以減少頻寬和對 的連線 AWS 雲端。

2.1.1

錯誤修正和改善
  • 修正JSON裝置影子狀態文件 desiredreported區段的最大深度為 4 個層級而非 5 個層級的問題。

  • 針對 Greengrass nucleus 2.6.0 版更新版本。

2.1.0

新功能
  • 新增定期影子同步間隔的支援,因此您可以設定核心裝置以減少頻寬用量和費用。

2.0.6

此版本包含錯誤修正和改善。

2.0.5

針對 Greengrass nucleus 2.5.0 版更新版本。

2.0.4

錯誤修正和改善
  • 修正導致影子管理員刪除先前刪除之任何影子新建立版本的問題。

  • 更新 DeleteThingShadowIPC操作,以在呼叫時增加陰影版本。

2.0.3

針對 Greengrass nucleus 2.4.0 版更新版本。

2.0.2

錯誤修正和改善
  • 修正從 同步陰影狀態時,導致陰影管理員無法辨識 delta 屬性的問題 AWS IoT Core。

  • 修正有時導致影子同步請求錯誤合併的問題。

2.0.1

針對 Greengrass nucleus 2.3.0 版更新版本。

2.0.0

初始版本。