Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
Schattenmanager
Die Shadow-Manager-Komponente (aws.greengrass.ShadowManager) aktiviert den lokalen Shadow-Dienst auf Ihrem Kerngerät. Der lokale Shadow-Dienst ermöglicht es Komponenten, die Kommunikation zwischen Prozessen zu nutzen, um mit lokalen Shadows zu interagieren. Die Shadow-Manager-Komponente verwaltet die Speicherung lokaler Shadow-Dokumente und kümmert sich auch um die Synchronisation lokaler Shadow-Zustände mit dem AWS IoT Device Shadow-Dienst.
Weitere Informationen darüber, wie Greengrass-Core-Geräte mit Schatten interagieren können, finden Sie unterInteragiere mit Geräteschatten.
Versionen
Diese Komponente hat die folgenden Versionen:
Typ
Diese Komponente ist eine Plugin-Komponente (aws.greengrass.plugin). Der Greengrass-Kern führt diese Komponente in derselben Java Virtual Machine (JVM) wie der Nucleus aus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Core-Gerät ändern.
Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Kern. Weitere Informationen finden Sie unter AWS IoT Greengrass Protokolle überwachen.
Weitere Informationen finden Sie unter Komponententypen.
Betriebssystem
Diese Komponente kann auf Kerngeräten installiert werden, auf denen die folgenden Betriebssysteme ausgeführt werden:
Voraussetzungen
Für diese Komponente gelten die folgenden Anforderungen:
-
(Optional) Um Shadows mit dem AWS IoT Device Shadow-Dienst zu synchronisieren, muss die AWS IoT Richtlinie des Greengrass-Core-Geräts die folgenden AWS IoT Core Shadow-Richtlinienaktionen zulassen:
-
iot:GetThingShadow
-
iot:UpdateThingShadow
-
iot:DeleteThingShadow
Weitere Informationen zu diesen AWS IoT Core Richtlinien finden Sie unter AWS IoT Core Richtlinienaktionen im AWS IoT Entwicklerhandbuch.
Weitere Informationen zur AWS IoT Mindestrichtlinie finden Sie unter Minimale AWS IoT Richtlinie für AWS IoT Greengrass V2 Kerngeräte
-
Die Shadow Manager-Komponente wird für die Ausführung in einer VPC unterstützt.
Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, stellt sie AWS IoT Greengrass auch kompatible Versionen ihrer Abhängigkeiten bereit. Das bedeutet, dass Sie die Anforderungen für die Komponente und all ihre Abhängigkeiten erfüllen müssen, um die Komponente erfolgreich bereitstellen zu können. In diesem Abschnitt werden die Abhängigkeiten für die veröffentlichten Versionen dieser Komponente sowie die semantischen Versionseinschränkungen aufgeführt, die die Komponentenversionen für jede Abhängigkeit definieren. Sie können auch die Abhängigkeiten für jede Version der Komponente in der AWS IoT Greengrass Konsole anzeigen. Suchen Sie auf der Seite mit den Komponentendetails nach der Liste der Abhängigkeiten.
- 2.3.10
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.10 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Art der Abhängigkeit |
| Grüngraskern |
>=2,5,0 <2,15,0 |
Weich |
- 2.3.9
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.9 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Art der Abhängigkeit |
| Grüngraskern |
>=2,5,0 <2,14,0 |
Weich |
- 2.3.5 – 2.3.8
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.3.5 bis 2.3.8 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Art der Abhängigkeit |
| Grüngraskern |
>=2,5,0 <2,13,0 |
Weich |
- 2.3.3 and 2.3.4
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.3.3 und 2.3.4 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Art der Abhängigkeit |
| Grüngraskern |
>=2.5.0 <2.12.0 |
Weich |
- 2.3.2
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.2 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Art der Abhängigkeit |
| Grüngraskern |
>=2,5,0 <2,11,0 |
Weich |
- 2.3.0 and 2.3.1
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.3.0 und 2.3.1 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Art der Abhängigkeit |
| Grüngraskern |
>=2.5.0 <2.10.0 |
Weich |
- 2.2.3 and 2.2.4
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.2.3 und 2.2.4 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Art der Abhängigkeit |
| Grüngraskern |
>=2.2.0 <3.0.0 |
Weich |
- 2.2.2
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.2 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Art der Abhängigkeit |
| Grüngraskern |
>=2.2.0 <2.9.0 |
Weich |
- 2.2.1
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.2.1 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Art der Abhängigkeit |
| Grüngraskern |
>=2.2.0 <2.8.0 |
Weich |
- 2.1.1 and 2.2.0
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.1.1 und 2.2.0 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Art der Abhängigkeit |
| Grüngraskern |
>=2.2.0 <2.7.0 |
Weich |
- 2.0.5 - 2.1.0
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.5 bis 2.1.0 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Art der Abhängigkeit |
| Grüngraskern |
>=2.2.0 <2.6.0 |
Weich |
- 2.0.3 and 2.0.4
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.3 und 2.0.4 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Art der Abhängigkeit |
| Grüngraskern |
>=2.2.0 <2.5.0 |
Weich |
- 2.0.1 and 2.0.2
-
In der folgenden Tabelle sind die Abhängigkeiten für die Versionen 2.0.1 und 2.0.2 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Art der Abhängigkeit |
| Grüngraskern |
>=2.2.0 <2.4.0 |
Weich |
- 2.0.0
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.0.0 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Art der Abhängigkeit |
| Grüngraskern |
>=2.2.0 <2.3.0 |
Weich |
Weitere Informationen zu Komponentenabhängigkeiten finden Sie in der Referenz zu den Komponentenrezepten.
Konfiguration
Diese Komponente stellt die folgenden Konfigurationsparameter bereit, die Sie bei der Bereitstellung der Komponente anpassen können.
- 2.3.x
-
strategy-
(Optional) Die Strategie, die diese Komponente verwendet, um Schatten zwischen AWS IoT Core und dem Kerngerät zu synchronisieren.
Dieses Objekt enthält die folgenden Informationen.
type-
(Optional) Die Art der Strategie, die diese Komponente verwendet, um Schatten zwischen AWS IoT Core und dem Kerngerät zu synchronisieren. Wählen Sie aus den folgenden Optionen aus:
-
realTime— Synchronisiert Schatten bei AWS IoT Core jedem Shadow-Update.
-
periodic— Synchronisieren Sie Schatten in einem regelmäßigen Intervall, das Sie mit dem delay Konfigurationsparameter angeben. AWS IoT Core
Standard: realTime
delay-
(Optional) Das Intervall in Sekunden, mit dem diese Komponente Schatten synchronisiert AWS IoT Core, wenn Sie die periodic Synchronisierungsstrategie angeben.
Dieser Parameter ist erforderlich, wenn Sie die periodic Synchronisierungsstrategie angeben.
synchronize-
(Optional) Die Synchronisierungseinstellungen, die bestimmen, wie Schatten mit dem AWS Cloud synchronisiert werden.
Sie müssen ein Konfigurationsupdate mit dieser Eigenschaft erstellen, um Schatten mit dem AWS Cloud zu synchronisieren.
Dieses Objekt enthält die folgenden Informationen.
coreThing-
(Optional) Das Core-Gerät wird zur Synchronisation gescrollt. Dieses Objekt enthält die folgenden Informationen.
classic-
(Optional) Standardmäßig synchronisiert der Shadow-Manager den lokalen Status des klassischen Shadows für Ihr Kerngerät mit dem AWS Cloud. Wenn Sie den klassischen Geräteshadow nicht synchronisieren möchten, setzen Sie ihn auffalse.
Standard: true
namedShadows-
(Optional) Die Liste der benannten Core-Device-Shadows, die synchronisiert werden sollen. Sie müssen die genauen Namen der Schatten angeben.
Der AWS IoT Greengrass Dienst verwendet den AWSManagedGreengrassV2Deployment benannten Shadow, um Bereitstellungen zu verwalten, die auf einzelne Kerngeräte abzielen. Dieser benannte Shadow ist für die Verwendung durch den AWS IoT Greengrass Dienst reserviert. Aktualisieren oder löschen Sie diesen benannten Schatten nicht.
shadowDocumentsMap-
(Optional) Die zusätzlichen Geräteschatten, die synchronisiert werden sollen. Die Verwendung dieses Konfigurationsparameters erleichtert die Angabe von Schattendokumenten. Es wird empfohlen, diesen Parameter anstelle des shadowDocuments Objekts zu verwenden.
Wenn Sie ein shadowDocumentsMap Objekt angeben, dürfen Sie kein shadowDocuments Objekt angeben.
Jedes Objekt enthält die folgenden Informationen:
thingName-
Die Shadow-Konfiguration für die thingName für diese Shadow-Konfiguration.
classic-
(Optional) Wenn Sie den klassischen Geräteshadow für das thingName Gerät nicht synchronisieren möchten, setzen Sie ihn auffalse.
namedShadows-
Die Liste der benannten Schatten, die Sie synchronisieren möchten. Sie müssen die genauen Namen der Schatten angeben.
shadowDocuments-
(Optional) Die Liste der zusätzlichen Geräteschatten, die synchronisiert werden sollen. Wir empfehlen, stattdessen den shadowDocumentsMap Parameter zu verwenden.
Wenn Sie ein shadowDocuments Objekt angeben, dürfen Sie kein shadowDocumentsMap Objekt angeben.
Jedes Objekt in dieser Liste enthält die folgenden Informationen.
thingName-
Der Dingname des Geräts, für das Schatten synchronisiert werden sollen.
classic-
(Optional) Wenn Sie den klassischen Geräteshadow für das thingName Gerät nicht synchronisieren möchten, setzen Sie ihn auffalse.
Standard: true
namedShadows-
(Optional) Die Liste der benannten Geräteschatten, die Sie synchronisieren möchten. Sie müssen die genauen Namen der Schatten angeben.
direction-
(Optional) Die Richtung, in der Schatten zwischen dem lokalen Shadow-Dienst und dem synchronisiert AWS Cloud werden sollen. Sie können diese Option konfigurieren, um die Bandbreite und die Verbindungen zum zu reduzieren AWS Cloud. Wählen Sie aus den folgenden Optionen aus:
-
betweenDeviceAndCloud— Synchronisiert Shadows zwischen dem lokalen Shadow-Dienst und dem AWS Cloud.
-
deviceToCloud— Sendet Shadow-Updates vom lokalen Shadow-Dienst an den AWS Cloud und ignoriert Shadow-Updates vom AWS Cloud.
-
cloudToDevice— Empfangen Sie Shadow-Updates vom AWS Cloud und senden Sie keine Shadow-Updates vom lokalen Shadow-Dienst an den AWS Cloud.
Standard: BETWEEN_DEVICE_AND_CLOUD
rateLimits-
(Optional) Die Einstellungen, die die Ratenlimits für Shadow-Serviceanfragen festlegen.
Dieses Objekt enthält die folgenden Informationen.
maxOutboundSyncUpdatesPerSecond-
(Optional) Die maximale Anzahl von Synchronisierungsanfragen pro Sekunde, die das Gerät überträgt.
Standard: 100 Anfragen/Sekunde
maxTotalLocalRequestsRate-
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die an das Kerngerät gesendet werden.
Standard: 200 Anfragen/Sekunde
maxLocalRequestsPerSecondPerThing-
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die für jedes verbundene IoT-Ding gesendet werden.
Standard: 20 Anfragen/Sekunde für jedes Ding
Diese Parameter für die Ratenbegrenzung definieren die maximale Anzahl von Anfragen pro Sekunde für den lokalen Shadow-Dienst. Die maximale Anzahl von Anfragen pro Sekunde für den AWS IoT Device Shadow-Dienst hängt von Ihrem ab AWS-Region. Weitere Informationen finden Sie in den Grenzwerten für die AWS IoT Device Shadow Service API in der Allgemeine Amazon Web Services-Referenz.
shadowDocumentSizeLimitBytes-
(Optional) Die maximal zulässige Größe jedes JSON-Statusdokuments für lokale Schatten.
Wenn Sie diesen Wert erhöhen, müssen Sie auch das Ressourcenlimit für das JSON-Statusdokument für Wolkenschatten erhöhen. Weitere Informationen finden Sie in den Grenzwerten für die AWS IoT
Device Shadow Service API in der Allgemeine Amazon Web Services-Referenz.
Standard: 8192 Byte
Maximum: 30720 Byte
Beispiel: Update zur Zusammenführung von Konfigurationen
Das folgende Beispiel zeigt ein Beispiel für ein Update zur Zusammenführung von Konfigurationen mit allen verfügbaren Konfigurationsparametern für die Shadow Manager-Komponente.
{
"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-
(Optional) Die Strategie, die diese Komponente verwendet, um Schatten zwischen AWS IoT Core und dem Kerngerät zu synchronisieren.
Dieses Objekt enthält die folgenden Informationen.
type-
(Optional) Die Art der Strategie, die diese Komponente verwendet, um Schatten zwischen AWS IoT Core und dem Kerngerät zu synchronisieren. Wählen Sie aus den folgenden Optionen aus:
-
realTime— Synchronisiert Schatten bei AWS IoT Core jedem Shadow-Update.
-
periodic— Synchronisieren Sie Schatten in einem regelmäßigen Intervall, das Sie mit dem delay Konfigurationsparameter angeben. AWS IoT Core
Standard: realTime
delay-
(Optional) Das Intervall in Sekunden, mit dem diese Komponente Schatten synchronisiert AWS IoT Core, wenn Sie die periodic Synchronisierungsstrategie angeben.
Dieser Parameter ist erforderlich, wenn Sie die periodic Synchronisierungsstrategie angeben.
synchronize-
(Optional) Die Synchronisierungseinstellungen, die bestimmen, wie Schatten mit dem AWS Cloud synchronisiert werden.
Sie müssen ein Konfigurationsupdate mit dieser Eigenschaft erstellen, um Schatten mit dem AWS Cloud zu synchronisieren.
Dieses Objekt enthält die folgenden Informationen.
coreThing-
(Optional) Das Core-Gerät wird zur Synchronisation gescrollt. Dieses Objekt enthält die folgenden Informationen.
classic-
(Optional) Standardmäßig synchronisiert der Shadow-Manager den lokalen Status des klassischen Shadows für Ihr Kerngerät mit dem AWS Cloud. Wenn Sie den klassischen Geräteshadow nicht synchronisieren möchten, setzen Sie ihn auffalse.
Standard: true
namedShadows-
(Optional) Die Liste der benannten Core-Device-Shadows, die synchronisiert werden sollen. Sie müssen die genauen Namen der Schatten angeben.
Der AWS IoT Greengrass Dienst verwendet den AWSManagedGreengrassV2Deployment benannten Shadow, um Bereitstellungen zu verwalten, die auf einzelne Kerngeräte abzielen. Dieser benannte Shadow ist für die Verwendung durch den AWS IoT Greengrass Dienst reserviert. Aktualisieren oder löschen Sie diesen benannten Schatten nicht.
shadowDocumentsMap-
(Optional) Die zusätzlichen Geräteschatten, die synchronisiert werden sollen. Die Verwendung dieses Konfigurationsparameters erleichtert die Angabe von Schattendokumenten. Es wird empfohlen, diesen Parameter anstelle des shadowDocuments Objekts zu verwenden.
Wenn Sie ein shadowDocumentsMap Objekt angeben, dürfen Sie kein shadowDocuments Objekt angeben.
Jedes Objekt enthält die folgenden Informationen:
thingName-
Die Shadow-Konfiguration für die thingName für diese Shadow-Konfiguration.
classic-
(Optional) Wenn Sie den klassischen Geräteshadow für das thingName Gerät nicht synchronisieren möchten, setzen Sie ihn auffalse.
namedShadows-
Die Liste der benannten Schatten, die Sie synchronisieren möchten. Sie müssen die genauen Namen der Schatten angeben.
shadowDocuments-
(Optional) Die Liste der zusätzlichen Geräteschatten, die synchronisiert werden sollen. Wir empfehlen, stattdessen den shadowDocumentsMap Parameter zu verwenden.
Wenn Sie ein shadowDocuments Objekt angeben, dürfen Sie kein shadowDocumentsMap Objekt angeben.
Jedes Objekt in dieser Liste enthält die folgenden Informationen.
thingName-
Der Dingname des Geräts, für das Schatten synchronisiert werden sollen.
classic-
(Optional) Wenn Sie den klassischen Geräteshadow für das thingName Gerät nicht synchronisieren möchten, setzen Sie ihn auffalse.
Standard: true
namedShadows-
(Optional) Die Liste der benannten Geräteschatten, die Sie synchronisieren möchten. Sie müssen die genauen Namen der Schatten angeben.
direction-
(Optional) Die Richtung, in der Schatten zwischen dem lokalen Shadow-Dienst und dem synchronisiert AWS Cloud werden sollen. Sie können diese Option konfigurieren, um die Bandbreite und die Verbindungen zum zu reduzieren AWS Cloud. Wählen Sie aus den folgenden Optionen aus:
-
betweenDeviceAndCloud— Synchronisiert Shadows zwischen dem lokalen Shadow-Dienst und dem AWS Cloud.
-
deviceToCloud— Sendet Shadow-Updates vom lokalen Shadow-Dienst an den AWS Cloud und ignoriert Shadow-Updates vom AWS Cloud.
-
cloudToDevice— Empfangen Sie Shadow-Updates vom AWS Cloud und senden Sie keine Shadow-Updates vom lokalen Shadow-Dienst an den AWS Cloud.
Standard: BETWEEN_DEVICE_AND_CLOUD
rateLimits-
(Optional) Die Einstellungen, die die Ratenlimits für Shadow-Serviceanfragen festlegen.
Dieses Objekt enthält die folgenden Informationen.
maxOutboundSyncUpdatesPerSecond-
(Optional) Die maximale Anzahl von Synchronisierungsanfragen pro Sekunde, die das Gerät überträgt.
Standard: 100 Anfragen/Sekunde
maxTotalLocalRequestsRate-
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die an das Kerngerät gesendet werden.
Standard: 200 Anfragen/Sekunde
maxLocalRequestsPerSecondPerThing-
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die für jedes verbundene IoT-Ding gesendet werden.
Standard: 20 Anfragen/Sekunde für jedes Ding
Diese Parameter für die Ratenbegrenzung definieren die maximale Anzahl von Anfragen pro Sekunde für den lokalen Shadow-Dienst. Die maximale Anzahl von Anfragen pro Sekunde für den AWS IoT Device Shadow-Dienst hängt von Ihrem ab AWS-Region. Weitere Informationen finden Sie in den Grenzwerten für die AWS IoT Device Shadow Service API in der Allgemeine Amazon Web Services-Referenz.
shadowDocumentSizeLimitBytes-
(Optional) Die maximal zulässige Größe jedes JSON-Statusdokuments für lokale Schatten.
Wenn Sie diesen Wert erhöhen, müssen Sie auch das Ressourcenlimit für das JSON-Statusdokument für Wolkenschatten erhöhen. Weitere Informationen finden Sie in den Grenzwerten für die AWS IoT
Device Shadow Service API in der Allgemeine Amazon Web Services-Referenz.
Standard: 8192 Byte
Maximum: 30720 Byte
Beispiel: Update zur Zusammenführung von Konfigurationen
Das folgende Beispiel zeigt ein Beispiel für ein Update zur Zusammenführung von Konfigurationen mit allen verfügbaren Konfigurationsparametern für die Shadow Manager-Komponente.
{
"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-
(Optional) Die Strategie, die diese Komponente verwendet, um Schatten zwischen AWS IoT Core und dem Kerngerät zu synchronisieren.
Dieses Objekt enthält die folgenden Informationen.
type-
(Optional) Die Art der Strategie, die diese Komponente verwendet, um Schatten zwischen AWS IoT Core und dem Kerngerät zu synchronisieren. Wählen Sie aus den folgenden Optionen aus:
-
realTime— Synchronisiert Schatten bei AWS IoT Core jedem Shadow-Update.
-
periodic— Synchronisieren Sie Schatten in einem regelmäßigen Intervall, das Sie mit dem delay Konfigurationsparameter angeben. AWS IoT Core
Standard: realTime
delay-
(Optional) Das Intervall in Sekunden, mit dem diese Komponente Schatten synchronisiert AWS IoT Core, wenn Sie die periodic Synchronisierungsstrategie angeben.
Dieser Parameter ist erforderlich, wenn Sie die periodic Synchronisierungsstrategie angeben.
synchronize-
(Optional) Die Synchronisierungseinstellungen, die bestimmen, wie Schatten mit dem AWS Cloud synchronisiert werden.
Sie müssen ein Konfigurationsupdate mit dieser Eigenschaft erstellen, um Schatten mit dem AWS Cloud zu synchronisieren.
Dieses Objekt enthält die folgenden Informationen.
coreThing-
(Optional) Das Core-Gerät wird zur Synchronisation gescrollt. Dieses Objekt enthält die folgenden Informationen.
classic-
(Optional) Standardmäßig synchronisiert der Shadow-Manager den lokalen Status des klassischen Shadows für Ihr Kerngerät mit dem AWS Cloud. Wenn Sie den klassischen Geräteshadow nicht synchronisieren möchten, setzen Sie ihn auffalse.
Standard: true
namedShadows-
(Optional) Die Liste der benannten Core-Device-Shadows, die synchronisiert werden sollen. Sie müssen die genauen Namen der Schatten angeben.
Der AWS IoT Greengrass Dienst verwendet den AWSManagedGreengrassV2Deployment benannten Shadow, um Bereitstellungen zu verwalten, die auf einzelne Kerngeräte abzielen. Dieser benannte Shadow ist für die Verwendung durch den AWS IoT Greengrass Dienst reserviert. Aktualisieren oder löschen Sie diesen benannten Schatten nicht.
shadowDocumentsMap-
(Optional) Die zusätzlichen Geräteschatten, die synchronisiert werden sollen. Die Verwendung dieses Konfigurationsparameters erleichtert die Angabe von Schattendokumenten. Es wird empfohlen, diesen Parameter anstelle des shadowDocuments Objekts zu verwenden.
Wenn Sie ein shadowDocumentsMap Objekt angeben, dürfen Sie kein shadowDocuments Objekt angeben.
Jedes Objekt enthält die folgenden Informationen:
thingName-
Die Shadow-Konfiguration für die thingName für diese Shadow-Konfiguration.
classic-
(Optional) Wenn Sie den klassischen Geräteshadow für das thingName Gerät nicht synchronisieren möchten, setzen Sie ihn auffalse.
namedShadows-
Die Liste der benannten Schatten, die Sie synchronisieren möchten. Sie müssen die genauen Namen der Schatten angeben.
shadowDocuments-
(Optional) Die Liste der zusätzlichen Geräteschatten, die synchronisiert werden sollen. Wir empfehlen, stattdessen den shadowDocumentsMap Parameter zu verwenden.
Wenn Sie ein shadowDocuments Objekt angeben, dürfen Sie kein shadowDocumentsMap Objekt angeben.
Jedes Objekt in dieser Liste enthält die folgenden Informationen.
thingName-
Der Dingname des Geräts, für das Schatten synchronisiert werden sollen.
classic-
(Optional) Wenn Sie den klassischen Geräteshadow für das thingName Gerät nicht synchronisieren möchten, setzen Sie ihn auffalse.
Standard: true
namedShadows-
(Optional) Die Liste der benannten Geräteschatten, die Sie synchronisieren möchten. Sie müssen die genauen Namen der Schatten angeben.
rateLimits-
(Optional) Die Einstellungen, die die Ratenlimits für Shadow-Service-Anfragen festlegen.
Dieses Objekt enthält die folgenden Informationen.
maxOutboundSyncUpdatesPerSecond-
(Optional) Die maximale Anzahl von Synchronisierungsanfragen pro Sekunde, die das Gerät überträgt.
Standard: 100 Anfragen/Sekunde
maxTotalLocalRequestsRate-
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die an das Kerngerät gesendet werden.
Standard: 200 Anfragen/Sekunde
maxLocalRequestsPerSecondPerThing-
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die für jedes verbundene IoT-Ding gesendet werden.
Standard: 20 Anfragen/Sekunde für jedes Ding
Diese Parameter für die Ratenbegrenzung definieren die maximale Anzahl von Anfragen pro Sekunde für den lokalen Shadow-Dienst. Die maximale Anzahl von Anfragen pro Sekunde für den AWS IoT Device Shadow-Dienst hängt von Ihrem ab AWS-Region. Weitere Informationen finden Sie in den Grenzwerten für die AWS IoT Device Shadow Service API in der Allgemeine Amazon Web Services-Referenz.
shadowDocumentSizeLimitBytes-
(Optional) Die maximal zulässige Größe jedes JSON-Statusdokuments für lokale Schatten.
Wenn Sie diesen Wert erhöhen, müssen Sie auch das Ressourcenlimit für das JSON-Statusdokument für Wolkenschatten erhöhen. Weitere Informationen finden Sie in den Grenzwerten für die AWS IoT
Device Shadow Service API in der Allgemeine Amazon Web Services-Referenz.
Standard: 8192 Byte
Maximum: 30720 Byte
Beispiel: Update zur Zusammenführung von Konfigurationen
Das folgende Beispiel zeigt ein Beispiel für ein Update zur Zusammenführung von Konfigurationen mit allen verfügbaren Konfigurationsparametern für die Shadow Manager-Komponente.
{
"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-
(Optional) Die Synchronisierungseinstellungen, die bestimmen, wie Schatten mit dem AWS Cloud synchronisiert werden.
Sie müssen ein Konfigurationsupdate mit dieser Eigenschaft erstellen, um Schatten mit dem AWS Cloud zu synchronisieren.
Dieses Objekt enthält die folgenden Informationen.
coreThing-
(Optional) Das Core-Gerät wird zur Synchronisation gescrollt. Dieses Objekt enthält die folgenden Informationen.
classic-
(Optional) Standardmäßig synchronisiert der Shadow-Manager den lokalen Status des klassischen Shadows für Ihr Kerngerät mit dem AWS Cloud. Wenn Sie den klassischen Geräteshadow nicht synchronisieren möchten, setzen Sie ihn auffalse.
Standard: true
namedShadows-
(Optional) Die Liste der benannten Core-Device-Shadows, die synchronisiert werden sollen. Sie müssen die genauen Namen der Schatten angeben.
Der AWS IoT Greengrass Dienst verwendet den AWSManagedGreengrassV2Deployment benannten Shadow, um Bereitstellungen zu verwalten, die auf einzelne Kerngeräte abzielen. Dieser benannte Shadow ist für die Verwendung durch den AWS IoT Greengrass Dienst reserviert. Aktualisieren oder löschen Sie diesen benannten Schatten nicht.
shadowDocumentsMap-
(Optional) Die zusätzlichen Geräteschatten, die synchronisiert werden sollen. Die Verwendung dieses Konfigurationsparameters erleichtert die Angabe von Schattendokumenten. Es wird empfohlen, diesen Parameter anstelle des shadowDocuments Objekts zu verwenden.
Wenn Sie ein shadowDocumentsMap Objekt angeben, dürfen Sie kein shadowDocuments Objekt angeben.
Jedes Objekt enthält die folgenden Informationen:
thingName-
Die Shadow-Konfiguration für die thingName für diese Shadow-Konfiguration.
classic-
(Optional) Wenn Sie den klassischen Geräteshadow für das thingName Gerät nicht synchronisieren möchten, setzen Sie ihn auffalse.
namedShadows-
Die Liste der benannten Schatten, die Sie synchronisieren möchten. Sie müssen die genauen Namen der Schatten angeben.
shadowDocuments-
(Optional) Die Liste der zusätzlichen Geräteschatten, die synchronisiert werden sollen. Wir empfehlen, stattdessen den shadowDocumentsMap Parameter zu verwenden.
Wenn Sie ein shadowDocuments Objekt angeben, dürfen Sie kein shadowDocumentsMap Objekt angeben.
Jedes Objekt in dieser Liste enthält die folgenden Informationen.
thingName-
Der Dingname des Geräts, für das Schatten synchronisiert werden sollen.
classic-
(Optional) Wenn Sie den klassischen Geräteshadow für das thingName Gerät nicht synchronisieren möchten, setzen Sie ihn auffalse.
Standard: true
namedShadows-
(Optional) Die Liste der benannten Geräteschatten, die Sie synchronisieren möchten. Sie müssen die genauen Namen der Schatten angeben.
rateLimits-
(Optional) Die Einstellungen, die die Ratenlimits für Shadow-Service-Anfragen festlegen.
Dieses Objekt enthält die folgenden Informationen.
maxOutboundSyncUpdatesPerSecond-
(Optional) Die maximale Anzahl von Synchronisierungsanfragen pro Sekunde, die das Gerät überträgt.
Standard: 100 Anfragen/Sekunde
maxTotalLocalRequestsRate-
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die an das Kerngerät gesendet werden.
Standard: 200 Anfragen/Sekunde
maxLocalRequestsPerSecondPerThing-
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die für jedes verbundene IoT-Ding gesendet werden.
Standard: 20 Anfragen/Sekunde für jedes Ding
Diese Parameter für die Ratenbegrenzung definieren die maximale Anzahl von Anfragen pro Sekunde für den lokalen Shadow-Dienst. Die maximale Anzahl von Anfragen pro Sekunde für den AWS IoT Device Shadow-Dienst hängt von Ihrem ab AWS-Region. Weitere Informationen finden Sie in den Grenzwerten für die AWS IoT Device Shadow Service API in der Allgemeine Amazon Web Services-Referenz.
shadowDocumentSizeLimitBytes-
(Optional) Die maximal zulässige Größe jedes JSON-Statusdokuments für lokale Schatten.
Wenn Sie diesen Wert erhöhen, müssen Sie auch das Ressourcenlimit für das JSON-Statusdokument für Wolkenschatten erhöhen. Weitere Informationen finden Sie in den Grenzwerten für die AWS IoT
Device Shadow Service API in der Allgemeine Amazon Web Services-Referenz.
Standard: 8192 Byte
Maximum: 30720 Byte
Beispiel: Update zur Zusammenführung von Konfigurationen
Das folgende Beispiel zeigt ein Beispiel für ein Update zur Zusammenführung von Konfigurationen mit allen verfügbaren Konfigurationsparametern für die Shadow Manager-Komponente.
{
"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
}
Lokale Protokolldatei
Diese Komponente verwendet dieselbe Protokolldatei wie die Greengrass Nucleus-Komponente.
- Linux
-
/greengrass/v2
- Windows
-
C:\greengrass\v2\logs\greengrass.log
Um die Protokolle dieser Komponente einzusehen
Änderungsprotokoll
In der folgenden Tabelle werden die Änderungen in den einzelnen Versionen der Komponente beschrieben.
|
Version
|
Änderungen
|
|
2.3.10
|
Die Version wurde für die Version 2.14.0 von Greengrass Nucleus aktualisiert. |
|
2.3.9
|
Die Version wurde für die Version 2.13.0 von Greengrass Nucleus aktualisiert. |
|
2.3.8
|
- Fehlerkorrekturen und Verbesserungen
-
|
|
2.3.7
|
- Fehlerkorrekturen und Verbesserungen
-
|
|
2.3.6
|
- Fehlerkorrekturen und Verbesserungen
-
-
Behebt ein Problem, bei dem Shadow-Eigenschaften, die durch AWS Cloud Updates gelöscht wurden, während das Gerät offline ist, nach Wiederherstellung der Konnektivität weiterhin im lokalen Shadow vorhanden sind.
|
|
2.3.5
|
Die Version wurde für die Version 2.12.0 von Greengrass Nucleus aktualisiert. |
|
2.3.4
|
- Fehlerkorrekturen und Verbesserungen
-
|
|
2.3.3
|
Die Version wurde für die Version 2.11.0 von Greengrass Nucleus aktualisiert. |
|
2.3.2
|
- Fehlerkorrekturen und Verbesserungen
-
-
Behebt ein Problem, bei dem der Shadow Manager in den BROKEN Status wechselt, wenn die lokale Shadow-Datenbank beschädigt ist.
-
Die Version wurde für die Version 2.10.0 von Greengrass Nucleus aktualisiert.
|
|
2.3.1
|
- Fehlerkorrekturen und Verbesserungen
-
-
Behebt ein Problem, das die Synchronisierung von Cloud-Shadow-Updates verhindern kann.
-
Behebt ein Problem, bei dem Änderungen an der Sync-Konfiguration für benannte Schatten nur für einen benannten Schatten gelten.
|
|
2.3.0
|
- Fehlerkorrekturen und Verbesserungen
-
-
Behebt ein Problem, das dazu führen kann, dass Schatten nicht synchronisiert werden, wenn der private Schlüssel des Greengrass-Geräts in einem Hardware-Sicherheitsmodul gespeichert ist.
|
|
2.2.4
|
- Fehlerkorrekturen und Verbesserungen
-
-
Behebt ein Problem, bei dem die Überprüfung der Schattengröße nicht mit der der Cloud übereinstimmte, wenn das lokale Schattendokument aktualisiert wurde.
-
Behebt ein Problem, bei dem der Shadow-Manager keine Konfigurationsupdates mehr abhört, wenn eine Bereitstellung RESET auf den Konfigurationsknoten ausgeführt wird.
|
|
2.2.3
|
Die Version wurde für die Version 2.9.0 von Greengrass Nucleus aktualisiert. |
|
2.2.2
|
Die Version wurde für die Version 2.8.0 von Greengrass Nucleus aktualisiert. |
|
2.2.1
|
Die Version wurde für die Version 2.7.0 von Greengrass Nucleus aktualisiert.
|
|
2.2.0
|
- Neue Features
-
-
Integriert die Unterstützung für den lokalen Shadow-Service über den lokalen publish/subscribe interface. You can now communicate with the local
publish/subscribe Message Broker zu Shadow-MQTT-Themen, um Schatten auf dem Kerngerät abzurufen, zu aktualisieren und zu löschen. Mit dieser Funktion können Sie Client-Geräte mit dem lokalen Shadow-Dienst verbinden, indem Sie die MQTT-Bridge verwenden, um Nachrichten zu Shadow-Themen zwischen Client-Geräten und der lokalen Publish/Subscribe-Schnittstelle weiterzuleiten.
Für diese Funktion ist Version 2.6.0 oder höher der Greengrass Nucleus-Komponente erforderlich. Um Client-Geräte mit dem lokalen Shadow-Service zu verbinden, müssen Sie auch Version 2.2.0 oder höher der MQTT-Bridge-Komponente verwenden.
-
Fügt die direction Option hinzu, die Sie konfigurieren können, um die Richtung für die Synchronisation von Shadows zwischen dem lokalen Shadow-Dienst und dem anzupassen. AWS Cloud Sie können diese Option konfigurieren, um die Bandbreite und die Verbindungen zum zu reduzieren AWS Cloud.
|
|
2.1.1
|
- Fehlerkorrekturen und Verbesserungen
-
-
Behebt ein Problem, bei dem die maximale Tiefe in den reported Abschnitten desired und im Dokument mit dem Schattenstatus des JSON-Geräts 4 statt 5 Stufen betrug.
-
Die Version wurde für die Version 2.6.0 von Greengrass Nucleus aktualisiert.
|
|
2.1.0
|
|
|
2.0.6
|
Diese Version enthält Fehlerkorrekturen und Verbesserungen.
|
|
2.0.5
|
Die Version wurde für die Version 2.5.0 von Greengrass Nucleus aktualisiert.
|
|
2.0.4
|
- Fehlerkorrekturen und Verbesserungen
-
-
Behebt ein Problem, das dazu führte, dass der Schattenmanager neu erstellte Versionen aller zuvor gelöschten Schatten löschte.
-
Aktualisiert den DeleteThingShadow IPC-Vorgang so, dass die Shadow-Version beim Aufruf inkrementiert wird.
|
|
2.0.3
|
Die Version wurde für die Version 2.4.0 von Greengrass Nucleus aktualisiert.
|
|
2.0.2
|
- Fehlerkorrekturen und Verbesserungen
-
-
Es wurde ein Problem behoben, das dazu führte, dass der Schattenmanager die delta Eigenschaft beim Synchronisieren von Schattenstatus von AWS IoT Core nicht erkannte.
-
Es wurde ein Problem behoben, das manchmal dazu führte, dass Synchronisierungsanforderungen für einen Schatten falsch zusammengeführt wurden.
|
|
2.0.1
|
Die Version wurde für die Version 2.3.0 von Greengrass Nucleus aktualisiert.
|
|
2.0.0
|
Erste Version
|
