本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。
陰影管理
陰影管理員元件 (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日誌。
如需詳細資訊，請參閱 元件類型。
作業系統
要求
此元件具有下列需求：
-
(選擇性) 若要將陰影同步至 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.5 – 2.3.8
-
下表列出此元件 2.3.5 到 2.3.8 版的相依性。
- 2.3.3 and 2.3.4
-
下表列出此元件 2.3.3 和 2.3.4 版的相依性。
- 2.3.2
-
下表列出此元件 2.3.2 版的相依性。
- 2.3.0 and 2.3.1
-
下表列出此元件 2.3.0 和 2.3.1 版的相依性。
- 2.2.3 and 2.2.4
-
下表列出此元件 2.2.3 和 2.2.4 版的相依性。
- 2.2.2
-
下表列出此元件 2.2.2 版的相依性。
- 2.2.1
-
下表列出此元件 2.2.1 版的相依性。
- 2.1.1 and 2.2.0
-
下表列出此元件 2.1.1 和 2.2.0 版的相依性。
- 2.0.5 - 2.1.0
-
下表列出此元件 2.0.5 到 2.1.0 版的相依性。
- 2.0.3 and 2.0.4
-
下表列出此元件 2.0.3 和 2.0.4 版的相依性。
- 2.0.1 and 2.0.2
-
下表列出此元件 2.0.1 和 2.0.2 版本的相依性。
- 2.0.0
-
下表列出此元件 2.0.0 版的相依性。
如需有關元件相依性的詳細資訊，請參閱元件方案參考。
組態
此元件提供下列組態參數，您可以在部署元件時自訂這些參數。
- 2.3.x
-
strategy-
(選擇性) 此元件用來在 AWS IoT Core 與核心裝置之間同步陰影的策略。
此物件包含下列資訊。
type-
(選擇性) 此元件用來同步處理 AWS IoT Core 與核心裝置之間陰影的策略類型。您可以從以下選項中選擇：
預設：realTime
delay-
(選擇性) 當您指定periodic同步策略時 AWS IoT Core，此元件會與陰影同步的間隔 (以秒為單位)。
如果您指定periodic同步策略，則需要此參數。
synchronize-
(選擇性) 決定陰影與的同步化設定 AWS 雲端。
您必須使用此屬性建立模型組態更新，才能與陰影同步 AWS 雲端。
此物件包含下列資訊。
coreThing-
(選擇性) 要同步的核心裝置陰影。此物件包含下列資訊。
classic-
(選擇性) 根據預設，陰影管理員會將核心裝置的傳統陰影的本機狀態與. AWS 雲端如果您不想同步傳統裝置陰影，請將其設定為false。
預設：true
namedShadows-
(選擇性) 要同步的具名核心裝置陰影清單。您必須指定陰影的確切名稱。
此 AWS IoT Greengrass 服務會使用AWSManagedGreengrassV2Deployment具名的陰影來管理以個別核心裝置為目標的部署。此具名陰影會保留供 AWS IoT Greengrass 服務使用。請勿更新或刪除此命名陰影。
shadowDocumentsMap-
(選擇性) 要同步的其他裝置陰影。使用此組態參數可讓您更輕鬆地指定陰影文件。我們建議您使用此參數而不是shadowDocuments物件。
如果您指定shadowDocumentsMap物件，則不得指定shadowDocuments物件。
每個物件都包含下列資訊：
thingName-
此陰影組態之 thingName 的陰影組態。
classic-
(選擇性) 如果您不想同步裝置的傳統裝置陰影，請將此設定為false。thingName
namedShadows-
您要同步的已命名陰影清單。您必須指定陰影的確切名稱。
shadowDocuments-
(選擇性) 要同步的其他裝置陰影清單。我們建議您改用shadowDocumentsMap參數。
如果您指定shadowDocuments物件，則不得指定shadowDocumentsMap物件。
此清單中的每個物件都包含下列資訊。
thingName-
要同步陰影之裝置的物件名稱。
classic-
(選擇性) 如果您不想同步裝置的傳統裝置陰影，請將此設定為false。thingName
預設：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 參閱 Amazon Web Services 一般參考.
shadowDocumentSizeLimitBytes-
(選擇性) 本機陰影每個 JSON 狀態文件允許的大小上限。
如果增加此值，您也必須增加雲陰影 JSON 狀態文件的資源限制。如需詳細資訊，AWS IoT
Device Shadow 參閱 Amazon Web Services 一般參考.
預設值：8192 個位元組
最大位元組
範例：組態合併更新
下列範例顯示範例組態合併更新，其中包含陰影管理員元件的所有可用組態參數。
{
"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
delay-
(選擇性) 當您指定periodic同步策略時 AWS IoT Core，此元件會與陰影同步的間隔 (以秒為單位)。
如果您指定periodic同步策略，則需要此參數。
synchronize-
(選擇性) 決定陰影與的同步化設定 AWS 雲端。
您必須使用此屬性建立模型組態更新，才能與陰影同步 AWS 雲端。
此物件包含下列資訊。
coreThing-
(選擇性) 要同步的核心裝置陰影。此物件包含下列資訊。
classic-
(選擇性) 根據預設，陰影管理員會將核心裝置的傳統陰影的本機狀態與. AWS 雲端如果您不想同步傳統裝置陰影，請將其設定為false。
預設：true
namedShadows-
(選擇性) 要同步的具名核心裝置陰影清單。您必須指定陰影的確切名稱。
此 AWS IoT Greengrass 服務會使用AWSManagedGreengrassV2Deployment具名的陰影來管理以個別核心裝置為目標的部署。此具名陰影會保留供 AWS IoT Greengrass 服務使用。請勿更新或刪除此命名陰影。
shadowDocumentsMap-
(選擇性) 要同步的其他裝置陰影。使用此組態參數可讓您更輕鬆地指定陰影文件。我們建議您使用此參數而不是shadowDocuments物件。
如果您指定shadowDocumentsMap物件，則不得指定shadowDocuments物件。
每個物件都包含下列資訊：
thingName-
此陰影組態之 thingName 的陰影組態。
classic-
(選擇性) 如果您不想同步裝置的傳統裝置陰影，請將此設定為false。thingName
namedShadows-
您要同步的已命名陰影清單。您必須指定陰影的確切名稱。
shadowDocuments-
(選擇性) 要同步的其他裝置陰影清單。我們建議您改用shadowDocumentsMap參數。
如果您指定shadowDocuments物件，則不得指定shadowDocumentsMap物件。
此清單中的每個物件都包含下列資訊。
thingName-
要同步陰影之裝置的物件名稱。
classic-
(選擇性) 如果您不想同步裝置的傳統裝置陰影，請將此設定為false。thingName
預設：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 參閱 Amazon Web Services 一般參考.
shadowDocumentSizeLimitBytes-
(選擇性) 本機陰影每個 JSON 狀態文件允許的大小上限。
如果增加此值，您也必須增加雲陰影 JSON 狀態文件的資源限制。如需詳細資訊，AWS IoT
Device Shadow 參閱 Amazon Web Services 一般參考.
預設值：8192 個位元組
最大位元組
範例：組態合併更新
下列範例顯示範例組態合併更新，其中包含陰影管理員元件的所有可用組態參數。
{
"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
delay-
(選擇性) 當您指定periodic同步策略時 AWS IoT Core，此元件會與陰影同步的間隔 (以秒為單位)。
如果您指定periodic同步策略，則需要此參數。
synchronize-
(選擇性) 決定陰影與的同步化設定 AWS 雲端。
您必須使用此屬性建立模型組態更新，才能與陰影同步 AWS 雲端。
此物件包含下列資訊。
coreThing-
(選擇性) 要同步的核心裝置陰影。此物件包含下列資訊。
classic-
(選擇性) 根據預設，陰影管理員會將核心裝置的傳統陰影的本機狀態與. AWS 雲端如果您不想同步傳統裝置陰影，請將其設定為false。
預設：true
namedShadows-
(選擇性) 要同步的具名核心裝置陰影清單。您必須指定陰影的確切名稱。
此 AWS IoT Greengrass 服務會使用AWSManagedGreengrassV2Deployment具名的陰影來管理以個別核心裝置為目標的部署。此具名陰影會保留供 AWS IoT Greengrass 服務使用。請勿更新或刪除此命名陰影。
shadowDocumentsMap-
(選擇性) 要同步的其他裝置陰影。使用此組態參數可讓您更輕鬆地指定陰影文件。我們建議您使用此參數而不是shadowDocuments物件。
如果您指定shadowDocumentsMap物件，則不得指定shadowDocuments物件。
每個物件都包含下列資訊：
thingName-
此陰影組態之 thingName 的陰影組態。
classic-
(選擇性) 如果您不想同步裝置的傳統裝置陰影，請將此設定為false。thingName
namedShadows-
您要同步的已命名陰影清單。您必須指定陰影的確切名稱。
shadowDocuments-
(選擇性) 要同步的其他裝置陰影清單。我們建議您改用shadowDocumentsMap參數。
如果您指定shadowDocuments物件，則不得指定shadowDocumentsMap物件。
此清單中的每個物件都包含下列資訊。
thingName-
要同步陰影之裝置的物件名稱。
classic-
(選擇性) 如果您不想同步裝置的傳統裝置陰影，請將此設定為false。thingName
預設：true
namedShadows-
(選擇性) 您要同步的已命名裝置陰影清單。您必須指定陰影的確切名稱。
rateLimits-
(選擇性) 決定陰影服務要求之速率限制的設定。
此物件包含下列資訊。
maxOutboundSyncUpdatesPerSecond-
(選擇性) 裝置每秒傳輸的同步處理要求數目上限。
預設值：每秒 100 個要求
maxTotalLocalRequestsRate-
(選擇性) 每秒傳送至核心裝置的本機 IPC 要求數目上限。
預設值：每秒 200 個要求
maxLocalRequestsPerSecondPerThing-
(選擇性) 針對每個連線 IoT 物件，每秒傳送的本機 IPC 要求數目上限。
預設值：每個物件每秒 20 次要求
這些速率限制參數定義本機陰影服務每秒的要求數目上限。 AWS IoT Device Shadow 服務每秒的要求數目上限取決於您的 AWS 區域。如需詳細資訊，AWS IoT Device Shadow 參閱 Amazon Web Services 一般參考.
shadowDocumentSizeLimitBytes-
(選擇性) 本機陰影每個 JSON 狀態文件允許的大小上限。
如果增加此值，您也必須增加雲陰影 JSON 狀態文件的資源限制。如需詳細資訊，AWS IoT
Device Shadow 參閱 Amazon Web Services 一般參考.
預設值：8192 個位元組
最大位元組
範例：組態合併更新
下列範例顯示範例組態合併更新，其中包含陰影管理員元件的所有可用組態參數。
{
"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-
(選擇性) 如果您不想同步裝置的傳統裝置陰影，請將此設定為false。thingName
namedShadows-
您要同步的已命名陰影清單。您必須指定陰影的確切名稱。
shadowDocuments-
(選擇性) 要同步的其他裝置陰影清單。我們建議您改用shadowDocumentsMap參數。
如果您指定shadowDocuments物件，則不得指定shadowDocumentsMap物件。
此清單中的每個物件都包含下列資訊。
thingName-
要同步陰影之裝置的物件名稱。
classic-
(選擇性) 如果您不想同步裝置的傳統裝置陰影，請將此設定為false。thingName
預設：true
namedShadows-
(選擇性) 您要同步的已命名裝置陰影清單。您必須指定陰影的確切名稱。
rateLimits-
(選擇性) 決定陰影服務要求之速率限制的設定。
此物件包含下列資訊。
maxOutboundSyncUpdatesPerSecond-
(選擇性) 裝置每秒傳輸的同步處理要求數目上限。
預設值：每秒 100 個要求
maxTotalLocalRequestsRate-
(選擇性) 每秒傳送至核心裝置的本機 IPC 要求數目上限。
預設值：每秒 200 個要求
maxLocalRequestsPerSecondPerThing-
(選擇性) 針對每個連線 IoT 物件，每秒傳送的本機 IPC 要求數目上限。
預設值：每個物件每秒 20 次要求
這些速率限制參數定義本機陰影服務每秒的要求數目上限。 AWS IoT Device Shadow 服務每秒的要求數目上限取決於您的 AWS 區域。如需詳細資訊，AWS IoT Device Shadow 參閱 Amazon Web Services 一般參考.
shadowDocumentSizeLimitBytes-
(選擇性) 本機陰影每個 JSON 狀態文件允許的大小上限。
如果增加此值，您也必須增加雲陰影 JSON 狀態文件的資源限制。如需詳細資訊，AWS IoT
Device Shadow 參閱 Amazon Web Services 一般參考.
預設值：8192 個位元組
最大位元組
範例：組態合併更新
下列範例顯示範例組態合併更新，其中包含陰影管理員元件的所有可用組態參數。
{
"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
- Windows
-
C:\greengrass\v2\logs\greengrass.log
變更記錄
下表說明元件每個版本的變更。
|
版本
|
變更
|
|
2.3.8
|
|
|
2.3.7
|
|
|
2.3.6
|
|
|
2.3.5
|
版本更新了 Greengrass 核 2.12.0 版本釋放。 |
|
2.3.4
|
|
|
2.3.3
|
版本更新了 Greengrass 核 2.11.0 版本釋放。 |
|
2.3.2
|
|
|
2.3.1
|
|
|
2.3.0
|
|
|
2.2.4
|
|
|
2.2.3
|
版本更新 Greengrass 2.9.0 版本釋放。 |
|
2.2.2
|
版本更新 Greengrass 2.8.0 版本的版本。 |
|
2.2.1
|
版本更新了 Greengrass 核 2.7.0 版本釋放。
|
|
2.2.0
|
- 新功能
-
-
通過本地發布/訂閱界面添加對本地陰影服務的支持。您現在可以在陰影 MQTT 主題上與本機發佈/訂閱訊息代理程式進行通訊，以取得、更新和刪除核心裝置上的陰影。此功能可讓您使用 MQTT 橋接器在用戶端裝置與本機發佈/訂閱介面之間轉送陰影主題的訊息，將用戶端裝置連線至本機陰影服務。
此功能需要 v2.6.0 或更高版 Greeng rass 核成分。若要將用戶端裝置連線到本機陰影服務，您也必須使用 v2.2.0 或更新版本的 MQ TT 橋接器元件。
-
新增您可以設定的direction選項，以自訂方向，以便在本機陰影服務和 AWS 雲端. 您可以設定此選項以減少頻寬和與 AWS 雲端.
|
|
2.1.1
|
|
|
2.1.0
|
|
|
2.0.6
|
此版本包含錯誤修復和改進。
|
|
2.0.5
|
版本更新了 Greengrass 核 2.5.0 版本。
|
|
2.0.4
|
|
|
2.0.3
|
版本更新 Greengrass 2.4.0 版本的版本。
|
|
2.0.2
|
|
|
2.0.1
|
版本更新了 Greengrass 核 2.3.0 版本。
|
|
2.0.0
|
初始版本。
|
