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 prozessübergreifende Kommunikation zu nutzen, um mit lokalen Schatten interagieren. Die Shadow-Manager-Komponente verwaltet die Speicherung von lokalen Shadow-Dokumenten und übernimmt auch die Synchronisation der lokalen Shadow-Status mit dem AWS IoT Device Shadow-Dienst.
Weitere Informationen darüber, wie Greengrass-Core-Geräte mit Schatten interagieren können, finden Sie unter Interagiere mit Geräteschatten.
Versionen
Diese Komponente hat die folgenden Versionen:
Typ
Diese Komponente ist eine Plugin-Komponente (aws.greengrass.plugin). Das Kern von Greengrass führt diese Komponente in derselben Java Virtual Machine (JVM) aus wie der Nucleus. Der Nucleus wird neu gestartet, wenn Sie die Version dieser Komponente auf dem Kerngerät ändern.
Diese Komponente verwendet dieselbe Protokolldatei wie der Greengrass-Nucleus. 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 Schatten mit dem zu synchronisieren AWS IoT Device Shadow-Dienst, der des Greengrass-Core-Geräts AWS IoT Die Richtlinie muss Folgendes zulassen AWS IoT Core Politische Maßnahmen im Schatten:
-
iot:GetThingShadow
-
iot:UpdateThingShadow
-
iot:DeleteThingShadow
Weitere Informationen zu diesen AWS IoT Core Richtlinien finden Sie unter AWS IoT Core politische Maßnahmen in der AWS IoT Leitfaden für Entwickler.
Für weitere Informationen über das Minimum AWS IoT Richtlinie, siehe Minimale AWS IoT Richtlinie für AWS IoT Greengrass V2 Kerngeräte
-
Die Ausführung der Shadow Manager-Komponente wird in einer VPC unterstützt.
Abhängigkeiten
Wenn Sie eine Komponente bereitstellen, AWS IoT Greengrass stellt auch kompatible Versionen seiner 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 bereitzustellen. In diesem Abschnitt werden die Abhängigkeiten für die aufgeführt veröffentlichte Versionen dieser Komponente und der semantischen Versionsbeschränkungen, die die Komponentenversionen für jede Abhängigkeit definieren. Sie können die Abhängigkeiten für jede Version der Komponente auch in der AWS IoT Greengrass Konsole. Suchen Sie auf der Seite mit den Komponentendetails nach Abhängigkeiten Liste.
- 2.3.15
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.15 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Typ der Abhängigkeit |
| Kern von Greengrass |
> =2,5,0 <2,19,0 |
Weich |
- 2.3.14
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.14 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Typ der Abhängigkeit |
| Kern von Greengrass |
> =2,5,0 <2,18,0 |
Weich |
- 2.3.13
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.13 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Typ der Abhängigkeit |
| Kern von Greengrass |
> =2,5,0 <2,17,0 |
Weich |
- 2.3.12
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.12 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Typ der Abhängigkeit |
| Kern von Greengrass |
> =2,5,0 <2,17,0 |
Weich |
- 2.3.11
-
In der folgenden Tabelle sind die Abhängigkeiten für Version 2.3.11 dieser Komponente aufgeführt.
| -Abhängigkeit |
Kompatible Versionen |
Typ der Abhängigkeit |
| Kern von Greengrass |
> =2,5,0 <2,16,0 |
Weich |
- 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 |
Typ der Abhängigkeit |
| Kern von Greengrass |
> =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 |
Typ der Abhängigkeit |
| Kern von Greengrass |
> =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 |
| Kern von Greengrass |
> =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 |
Typ der Abhängigkeit |
| Kern von Greengrass |
> =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 |
Typ der Abhängigkeit |
| Kern von Greengrass |
> =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 |
Typ der Abhängigkeit |
| Kern von Greengrass |
> =2,5,0 <2,1,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 |
Typ der Abhängigkeit |
| Kern von Greengrass |
> =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 |
Typ der Abhängigkeit |
| Kern von Greengrass |
> =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 |
Typ der Abhängigkeit |
| Kern von Greengrass |
> =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 |
Typ der Abhängigkeit |
| Kern von Greengrass |
> =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 |
Typ der Abhängigkeit |
| Kern von Greengrass |
> =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 |
Typ der Abhängigkeit |
| Kern von Greengrass |
> =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 |
Typ der Abhängigkeit |
| Kern von Greengrass |
> =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 |
Typ der Abhängigkeit |
| Kern von Greengrass |
> =2,2,0 <2,3,0 |
Weich |
Weitere Informationen zu Komponentenabhängigkeiten finden Sie im Referenz zum Komponenten-Rezept.
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, mit der diese Komponente Schatten synchronisiert AWS IoT Core und das Kerngerät.
Dieses Objekt enthält die folgenden Informationen.
type
-
(Optional) Die Art der Strategie, mit der diese Komponente Schatten synchronisiert AWS IoT Core und das Kerngerät. Wählen Sie aus den folgenden Optionen aus:
-
realTime — Synchronisiere Schatten mit AWS IoT Core jedes Mal, wenn ein Shadow-Update stattfindet.
-
periodic — Synchronisiere Schatten mit AWS IoT Core in einem regelmäßigen Intervall, das Sie mit dem angeben delay Konfigurationsparameter.
Standard: realTime
delay
-
(Optional) Das Intervall in Sekunden, in dem diese Komponente Schatten synchronisiert AWS IoT Core, wenn Sie Folgendes angeben periodic Synchronisierungsstrategie.
Dieser Parameter ist erforderlich, wenn Sie Folgendes angeben periodic Synchronisierungsstrategie.
synchronize
-
(Optional) Die Synchronisierungseinstellungen, die bestimmen, wie Schatten mit dem synchronisiert werden AWS Cloud.
Sie müssen ein Konfigurationsupdate mit dieser Eigenschaft erstellen, um Schatten mit dem zu synchronisieren AWS Cloud.
Dieses Objekt enthält die folgenden Informationen.
coreThing
-
(Optional) Das Kerngerät wird zum Synchronisieren gespießt. 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äteschatten nicht synchronisieren möchten, setzen Sie diesen Wert auf false.
Standard: true
namedShadows
-
(Optional) Die Liste der benannten Core-Geräteschatten, die synchronisiert werden sollen. Sie müssen die genauen Namen der Schatten angeben.
Die AWS IoT Greengrass Der Dienst verwendet die AWSManagedGreengrassV2Deployment named shadow zur Verwaltung von Bereitstellungen, die auf einzelne Kerngeräte abzielen. Dieser benannte Shadow ist für die Verwendung durch den reserviert AWS IoT Greengrass Dienst. Aktualisieren oder löschen Sie diesen benannten Shadow nicht.
shadowDocumentsMap
-
(Optional) Die zusätzlichen Geräteschatten, die synchronisiert werden sollen. Die Verwendung dieses Konfigurationsparameters erleichtert die Angabe von Schattendokumenten. Wir empfehlen, diesen Parameter anstelle von zu verwenden shadowDocuments Objekt.
Wenn Sie eine angeben shadowDocumentsMap Objekt, Sie dürfen kein Objekt angeben shadowDocuments Objekt.
Jedes Objekt enthält die folgenden Informationen:
thingName
-
Die Shadow-Konfiguration für den thingName für diese Shadow-Konfiguration.
classic
-
(Optional) Wenn Sie den klassischen Geräteschatten für den nicht synchronisieren möchten thingName Gerät, stellen Sie dies ein false.
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 Ihnen, das zu verwenden shadowDocumentsMap Parameter stattdessen.
Wenn Sie eine angeben shadowDocuments Objekt, Sie dürfen kein Objekt angeben shadowDocumentsMap Objekt.
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äteschatten für das Gerät nicht synchronisieren möchten thingName Gerät, stellen Sie dies ein false.
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-Service und dem synchronisiert werden sollen AWS Cloud. Sie können diese Option konfigurieren, um die Bandbreite und die Verbindungen zum AWS Cloud. Wählen Sie aus den folgenden Optionen aus:
-
betweenDeviceAndCloud — Synchronisieren Sie Schatten zwischen dem lokalen Shadow-Service und dem AWS Cloud.
-
deviceToCloud — Senden Sie Shadow-Updates vom lokalen Shadow-Service an den AWS Cloud, und ignorieren Sie Shadow-Updates von AWS Cloud.
-
cloudToDevice — Erhalte Shadow-Updates von der 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-Serviceanforderungen 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 requests/second
maxTotalLocalRequestsRate
-
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die an das Kerngerät gesendet werden.
Standard: 200 requests/second
maxLocalRequestsPerSecondPerThing
-
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die für jedes verbundene IoT-Ding gesendet werden.
Standard: 20 requests/second für jedes Ding
Diese Ratengrenzparameter definieren die maximale Anzahl von Anfragen pro Sekunde für den lokalen Shadow-Service. Die maximale Anzahl von Anfragen pro Sekunde für AWS IoT Der Device Shadow-Service hängt von Ihrem ab AWS-Region. Weitere Informationen finden Sie in den Grenzwerten für 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 AWS IoT
Device Shadow Service API in der Allgemeine Amazon Web Services-Referenz.
Standard: 8192 Byte
Maximum: 30720 Byte
Beispiel Beispiel: Aktualisierung der Konfiguration zum Zusammenführen
Das folgende Beispiel zeigt ein Beispiel für ein Update zum Zusammenführen der Konfiguration 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 zu synchronisieren AWS IoT Core und das Kerngerät.
Dieses Objekt enthält die folgenden Informationen.
type
-
(Optional) Die Art der Strategie, mit der diese Komponente Schatten synchronisiert AWS IoT Core und das Kerngerät. Wählen Sie aus den folgenden Optionen aus:
-
realTime — Synchronisiere Schatten mit AWS IoT Core jedes Mal, wenn ein Shadow-Update stattfindet.
-
periodic — Synchronisiere Schatten mit AWS IoT Core in einem regelmäßigen Intervall, das Sie mit dem angeben delay Konfigurationsparameter.
Standard: realTime
delay
-
(Optional) Das Intervall in Sekunden, in dem diese Komponente Schatten synchronisiert AWS IoT Core, wenn Sie Folgendes angeben periodic Synchronisierungsstrategie.
Dieser Parameter ist erforderlich, wenn Sie Folgendes angeben periodic Synchronisierungsstrategie.
synchronize
-
(Optional) Die Synchronisierungseinstellungen, die bestimmen, wie Schatten mit dem synchronisiert werden AWS Cloud.
Sie müssen ein Konfigurationsupdate mit dieser Eigenschaft erstellen, um Schatten mit dem zu synchronisieren AWS Cloud.
Dieses Objekt enthält die folgenden Informationen.
coreThing
-
(Optional) Das Kerngerät wird zum Synchronisieren gespießt. 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äteschatten nicht synchronisieren möchten, setzen Sie diesen Wert auf false.
Standard: true
namedShadows
-
(Optional) Die Liste der benannten Core-Geräteschatten, die synchronisiert werden sollen. Sie müssen die genauen Namen der Schatten angeben.
Die AWS IoT Greengrass Der Dienst verwendet die AWSManagedGreengrassV2Deployment named shadow zur Verwaltung von Bereitstellungen, die auf einzelne Kerngeräte abzielen. Dieser benannte Shadow ist für die Verwendung durch den reserviert AWS IoT Greengrass Dienst. Aktualisieren oder löschen Sie diesen benannten Shadow nicht.
shadowDocumentsMap
-
(Optional) Die zusätzlichen Geräteschatten, die synchronisiert werden sollen. Die Verwendung dieses Konfigurationsparameters erleichtert die Angabe von Schattendokumenten. Wir empfehlen, diesen Parameter anstelle von zu verwenden shadowDocuments Objekt.
Wenn Sie eine angeben shadowDocumentsMap Objekt, Sie dürfen kein Objekt angeben shadowDocuments Objekt.
Jedes Objekt enthält die folgenden Informationen:
thingName
-
Die Shadow-Konfiguration für den thingName für diese Shadow-Konfiguration.
classic
-
(Optional) Wenn Sie den klassischen Geräteschatten für den nicht synchronisieren möchten thingName Gerät, stellen Sie dies ein false.
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 Ihnen, das zu verwenden shadowDocumentsMap Parameter stattdessen.
Wenn Sie eine angeben shadowDocuments Objekt, Sie dürfen kein Objekt angeben shadowDocumentsMap Objekt.
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äteschatten für das Gerät nicht synchronisieren möchten thingName Gerät, stellen Sie dies ein false.
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-Service und dem synchronisiert werden AWS Cloud. Sie können diese Option konfigurieren, um die Bandbreite und die Verbindungen zum AWS Cloud. Wählen Sie aus den folgenden Optionen aus:
-
betweenDeviceAndCloud — Synchronisieren Sie Schatten zwischen dem lokalen Shadow-Service und dem AWS Cloud.
-
deviceToCloud — Senden Sie Shadow-Updates vom lokalen Shadow-Service an den AWS Cloud, und ignorieren Sie Shadow-Updates von AWS Cloud.
-
cloudToDevice — Erhalten Sie Shadow-Updates von der 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-Serviceanforderungen 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 requests/second
maxTotalLocalRequestsRate
-
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die an das Kerngerät gesendet werden.
Standard: 200 requests/second
maxLocalRequestsPerSecondPerThing
-
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die für jedes verbundene IoT-Ding gesendet werden.
Standard: 20 requests/second für jedes Ding
Diese Ratengrenzparameter definieren die maximale Anzahl von Anfragen pro Sekunde für den lokalen Shadow-Service. Die maximale Anzahl von Anfragen pro Sekunde für AWS IoT Der Device Shadow-Service hängt von Ihrem ab AWS-Region. Weitere Informationen finden Sie in den Grenzwerten für 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 AWS IoT
Device Shadow Service API in der Allgemeine Amazon Web Services-Referenz.
Standard: 8192 Byte
Maximum: 30720 Byte
Beispiel Beispiel: Aktualisierung der Konfiguration zum Zusammenführen
Das folgende Beispiel zeigt ein Beispiel für ein Update zum Zusammenführen der Konfiguration 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 zu synchronisieren AWS IoT Core und das Kerngerät.
Dieses Objekt enthält die folgenden Informationen.
type
-
(Optional) Die Art der Strategie, mit der diese Komponente Schatten synchronisiert AWS IoT Core und das Kerngerät. Wählen Sie aus den folgenden Optionen aus:
-
realTime — Synchronisiere Schatten mit AWS IoT Core jedes Mal, wenn ein Shadow-Update stattfindet.
-
periodic — Synchronisiere Schatten mit AWS IoT Core in einem regelmäßigen Intervall, das Sie mit dem angeben delay Konfigurationsparameter.
Standard: realTime
delay
-
(Optional) Das Intervall in Sekunden, in dem diese Komponente Schatten synchronisiert AWS IoT Core, wenn Sie Folgendes angeben periodic Synchronisierungsstrategie.
Dieser Parameter ist erforderlich, wenn Sie Folgendes angeben periodic Synchronisierungsstrategie.
synchronize
-
(Optional) Die Synchronisierungseinstellungen, die bestimmen, wie Schatten mit dem synchronisiert werden AWS Cloud.
Sie müssen ein Konfigurationsupdate mit dieser Eigenschaft erstellen, um Schatten mit dem zu synchronisieren AWS Cloud.
Dieses Objekt enthält die folgenden Informationen.
coreThing
-
(Optional) Das Kerngerät wird zum Synchronisieren gespießt. 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äteschatten nicht synchronisieren möchten, setzen Sie diesen Wert auf false.
Standard: true
namedShadows
-
(Optional) Die Liste der benannten Core-Geräteschatten, die synchronisiert werden sollen. Sie müssen die genauen Namen der Schatten angeben.
Die AWS IoT Greengrass Der Dienst verwendet die AWSManagedGreengrassV2Deployment named shadow zur Verwaltung von Bereitstellungen, die auf einzelne Kerngeräte abzielen. Dieser benannte Shadow ist für die Verwendung durch den reserviert AWS IoT Greengrass Dienst. Aktualisieren oder löschen Sie diesen benannten Shadow nicht.
shadowDocumentsMap
-
(Optional) Die zusätzlichen Geräteschatten, die synchronisiert werden sollen. Die Verwendung dieses Konfigurationsparameters erleichtert die Angabe von Schattendokumenten. Wir empfehlen, diesen Parameter anstelle von zu verwenden shadowDocuments Objekt.
Wenn Sie eine angeben shadowDocumentsMap Objekt, Sie dürfen kein Objekt angeben shadowDocuments Objekt.
Jedes Objekt enthält die folgenden Informationen:
thingName
-
Die Shadow-Konfiguration für den thingName für diese Shadow-Konfiguration.
classic
-
(Optional) Wenn Sie den klassischen Geräteschatten für den nicht synchronisieren möchten thingName Gerät, stellen Sie dies ein false.
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 Ihnen, das zu verwenden shadowDocumentsMap Parameter stattdessen.
Wenn Sie eine angeben shadowDocuments Objekt, Sie dürfen kein Objekt angeben shadowDocumentsMap Objekt.
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äteschatten für das Gerät nicht synchronisieren möchten thingName Gerät, stellen Sie dies ein false.
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-Serviceanforderungen 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 requests/second
maxTotalLocalRequestsRate
-
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die an das Kerngerät gesendet werden.
Standard: 200 requests/second
maxLocalRequestsPerSecondPerThing
-
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die für jedes verbundene IoT-Ding gesendet werden.
Standard: 20 requests/second für jedes Ding
Diese Ratengrenzparameter definieren die maximale Anzahl von Anfragen pro Sekunde für den lokalen Shadow-Service. Die maximale Anzahl von Anfragen pro Sekunde für AWS IoT Der Device Shadow-Service hängt von Ihrem ab AWS-Region. Weitere Informationen finden Sie in den Grenzwerten für 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 AWS IoT
Device Shadow Service API in der Allgemeine Amazon Web Services-Referenz.
Standard: 8192 Byte
Maximum: 30720 Byte
Beispiel Beispiel: Aktualisierung der Konfiguration zum Zusammenführen
Das folgende Beispiel zeigt ein Beispiel für ein Update zum Zusammenführen der Konfiguration 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 synchronisiert werden AWS Cloud.
Sie müssen ein Konfigurationsupdate mit dieser Eigenschaft erstellen, um Schatten mit dem zu synchronisieren AWS Cloud.
Dieses Objekt enthält die folgenden Informationen.
coreThing
-
(Optional) Das Kerngerät wird zum Synchronisieren gespießt. 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äteschatten nicht synchronisieren möchten, setzen Sie diesen Wert auf false.
Standard: true
namedShadows
-
(Optional) Die Liste der benannten Core-Geräteschatten, die synchronisiert werden sollen. Sie müssen die genauen Namen der Schatten angeben.
Die AWS IoT Greengrass Der Dienst verwendet die AWSManagedGreengrassV2Deployment named shadow zur Verwaltung von Bereitstellungen, die auf einzelne Kerngeräte abzielen. Dieser benannte Shadow ist für die Verwendung durch den reserviert AWS IoT Greengrass Dienst. Aktualisieren oder löschen Sie diesen benannten Shadow nicht.
shadowDocumentsMap
-
(Optional) Die zusätzlichen Geräteschatten, die synchronisiert werden sollen. Die Verwendung dieses Konfigurationsparameters erleichtert die Angabe von Schattendokumenten. Wir empfehlen, diesen Parameter anstelle von zu verwenden shadowDocuments Objekt.
Wenn Sie eine angeben shadowDocumentsMap Objekt, Sie dürfen kein Objekt angeben shadowDocuments Objekt.
Jedes Objekt enthält die folgenden Informationen:
thingName
-
Die Shadow-Konfiguration für den thingName für diese Shadow-Konfiguration.
classic
-
(Optional) Wenn Sie den klassischen Geräteschatten für den nicht synchronisieren möchten thingName Gerät, stellen Sie dies ein false.
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 Ihnen, das zu verwenden shadowDocumentsMap Parameter stattdessen.
Wenn Sie eine angeben shadowDocuments Objekt, Sie dürfen kein Objekt angeben shadowDocumentsMap Objekt.
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äteschatten für das Gerät nicht synchronisieren möchten thingName Gerät, stellen Sie dies ein false.
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-Serviceanforderungen 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 requests/second
maxTotalLocalRequestsRate
-
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die an das Kerngerät gesendet werden.
Standard: 200 requests/second
maxLocalRequestsPerSecondPerThing
-
(Optional) Die maximale Anzahl lokaler IPC-Anfragen pro Sekunde, die für jedes verbundene IoT-Ding gesendet werden.
Standard: 20 requests/second für jedes Ding
Diese Ratengrenzparameter definieren die maximale Anzahl von Anfragen pro Sekunde für den lokalen Shadow-Service. Die maximale Anzahl von Anfragen pro Sekunde für AWS IoT Der Device Shadow-Service hängt von Ihrem ab AWS-Region. Weitere Informationen finden Sie in den Grenzwerten für 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 AWS IoT
Device Shadow Service API in der Allgemeine Amazon Web Services-Referenz.
Standard: 8192 Byte
Maximum: 30720 Byte
Beispiel Beispiel: Aktualisierung der Konfiguration zum Zusammenführen
Das folgende Beispiel zeigt ein Beispiel für ein Update zum Zusammenführen der Konfiguration 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 Kern von Greengrass Komponente.
- Linux
-
/greengrass/v2/logs/greengrass.log
- 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.15
|
- Fehlerbehebungen und Verbesserungen
-
-
Behebt ein Problem, bei dem der Shadow Manager nach einem Stromausfall seine lokale Datenbank möglicherweise nicht mehr funktionierte.
-
Überprüft die Integrität der lokalen Datenbank beim Start und erstellt die Datenbank neu, wenn eine Beschädigung festgestellt wird.
|
|
2.3.14
|
Aktualisiert die Komponentenversion für die Greengrass Nucleus-Version 2.17.0.
|
|
2.3.13
|
- Fehlerbehebungen und Verbesserungen
-
-
Behebt ein Problem, bei dem lokale Shadow-Updates zeitweise nicht mit der Cloud synchronisiert wurden, auch wenn die Konfiguration der Synchronisationsrichtung dies zulässt.
-
Kleinere Fehlerbehebungen und Verbesserungen.
|
|
2.3.12
|
- Fehlerbehebungen und Verbesserungen
-
|
|
2.3.11
|
Die Version wurde für die Greengrass Nucleus-Version 2.15.0 aktualisiert. |
|
2.3.10
|
Die Version wurde für die Greengrass Nucleus-Version 2.14.0 aktualisiert. |
|
2.3.9
|
Die Version wurde für die Greengrass Nucleus-Version 2.13.0 aktualisiert. |
|
2.3.8
|
- Fehlerbehebungen und Verbesserungen
-
|
|
2.3.7
|
- Fehlerbehebungen und Verbesserungen
-
|
|
2.3.6
|
- Fehlerbehebungen und Verbesserungen
-
-
Behebt ein Problem, bei dem Schatteneigenschaften, die gelöscht wurden, durch AWS Cloud Updates, während das Gerät offline ist, existieren nach der Wiederherstellung der Konnektivität weiterhin im lokalen Shadow.
|
|
2.3.5
|
Die Version wurde für die Greengrass Nucleus-Version 2.12.0 aktualisiert. |
|
2.3.4
|
- Fehlerbehebungen und Verbesserungen
-
|
|
2.3.3
|
Die Version wurde für die Greengrass Nucleus-Version 2.11.0 aktualisiert. |
|
2.3.2
|
- Fehlerbehebungen und Verbesserungen
-
-
Behebt ein Problem, bei dem Shadow Manager das BROKEN gibt an, wenn die lokale Shadow-Datenbank beschädigt ist.
-
Die Version wurde für die Greengrass Nucleus-Version 2.10.0 aktualisiert.
|
|
2.3.1
|
- Fehlerbehebungen und Verbesserungen
-
-
Behebt einen Zustand, der dazu führen kann, dass Cloud Shadow-Updates nicht synchronisiert werden.
-
Behebt ein Problem, bei dem Änderungen an der Synchronisierungskonfiguration für benannte Schatten nur für einen benannten Schatten gelten.
|
|
2.3.0
|
- Fehlerbehebungen und Verbesserungen
-
-
Behebt ein Problem, das möglicherweise verhindert, dass Schatten synchronisiert werden, wenn der private Greengrass-Geräteschlüssel in einem Hardware-Sicherheitsmodul gespeichert ist.
|
|
2.2.4
|
- Fehlerbehebungen und Verbesserungen
-
-
Behebt ein Problem, bei dem die Überprüfung der Größe des Schattens nicht mit der der Cloud übereinstimmte, wenn das lokale Shadow-Dokument aktualisiert wurde.
-
Behebt ein Problem, bei dem der Shadow-Manager keine Konfigurationsaktualisierungen mehr abhört, wenn eine Bereitstellung eine RESET auf den Konfigurationsknoten.
|
|
2.2.3
|
Die Version wurde für die Greengrass Nucleus-Version 2.9.0 aktualisiert. |
|
2.2.2
|
Version für die Greengrass Nucleus-Version 2.8.0 aktualisiert. |
|
2.2.1
|
Die Version wurde für die Greengrass Nucleus-Version 2.7.0 aktualisiert.
|
|
2.2.0
|
- Neue Features
-
-
Fügt Unterstützung für den lokalen Shadow-Service über den lokalen hinzu publish/subscribe Schnittstelle. Sie können jetzt mit den Einheimischen kommunizieren publish/subscribe Message Broker an 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 dem lokalen Gerät weiterzuleiten publish/subscribe Schnittstelle.
Diese Funktion erfordert v2.6.0 oder höher des Komponente „Greengrass Nucleus“. Um Client-Geräte mit dem lokalen Shadow-Dienst zu verbinden, müssen Sie außerdem Version 2.2.0 oder höher des MQTT-Bridge-Komponente.
-
Fügt das hinzu direction Option, die Sie konfigurieren können, um die Richtung für die Synchronisation von Schatten zwischen dem lokalen Shadow-Service und dem AWS Cloud. Sie können diese Option konfigurieren, um die Bandbreite und die Verbindungen zum AWS Cloud.
|
|
2.1.1
|
- Fehlerbehebungen und Verbesserungen
-
-
Behebt ein Problem, bei dem die maximale Tiefe in der desired und reported Abschnitte des JSON-Geräte-Schattenstatusdokuments waren 4 statt 5 Ebenen.
-
Die Version wurde für die Greengrass Nucleus-Version 2.6.0 aktualisiert.
|
|
2.1.0
|
|
|
2.0.6
|
Diese Version enthält Fehlerbehebungen und Verbesserungen.
|
|
2.0.5
|
Die Version wurde für die Greengrass Nucleus-Version 2.5.0 aktualisiert.
|
|
2.0.4
|
- Fehlerbehebungen und Verbesserungen
-
-
Behebt ein Problem, das dazu führte, dass Shadow Manager neu erstellte Versionen aller zuvor gelöschten Shadows löschte.
-
Aktualisiert den DeleteThingShadow IPC-Vorgang, um die Shadow-Version zu erhöhen, wenn sie aufgerufen wird.
|
|
2.0.3
|
Die Version wurde für die Greengrass Nucleus-Version 2.4.0 aktualisiert.
|
|
2.0.2
|
- Fehlerbehebungen und Verbesserungen
-
-
Es wurde ein Problem behoben, das dazu führte, dass der Shadow Manager das nicht erkannte delta Eigenschaft beim Synchronisieren von Schattenzuständen von AWS IoT Core.
-
Es wurde ein Problem behoben, das manchmal dazu führte, dass Synchronisierungsanfragen für einen Shadow falsch zusammengeführt wurden.
|
|
2.0.1
|
Die Version wurde für die Greengrass Nucleus-Version 2.3.0 aktualisiert.
|
|
2.0.0
|
Erste Version
|