View a markdown version of this page

Schattenmanager - AWS IoT Greengrass

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:

  • 2.3.x

  • 2.2.x

  • 2.1.x

  • 2.0.x

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:

  • Linux

  • Windows

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.

Anmerkung

Dieser Parameter ist erforderlich, wenn Sie Folgendes angeben periodic Synchronisierungsstrategie.

synchronize

(Optional) Die Synchronisierungseinstellungen, die bestimmen, wie Schatten mit dem synchronisiert werden AWS Cloud.

Anmerkung

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.

Warnung

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.

Anmerkung

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.

Anmerkung

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

Anmerkung

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.

Anmerkung

Dieser Parameter ist erforderlich, wenn Sie Folgendes angeben periodic Synchronisierungsstrategie.

synchronize

(Optional) Die Synchronisierungseinstellungen, die bestimmen, wie Schatten mit dem synchronisiert werden AWS Cloud.

Anmerkung

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.

Warnung

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.

Anmerkung

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.

Anmerkung

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

Anmerkung

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.

Anmerkung

Dieser Parameter ist erforderlich, wenn Sie Folgendes angeben periodic Synchronisierungsstrategie.

synchronize

(Optional) Die Synchronisierungseinstellungen, die bestimmen, wie Schatten mit dem synchronisiert werden AWS Cloud.

Anmerkung

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.

Warnung

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.

Anmerkung

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.

Anmerkung

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

Anmerkung

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.

Anmerkung

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.

Warnung

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.

Anmerkung

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.

Anmerkung

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

Anmerkung

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
  • Führen Sie den folgenden Befehl auf dem Kerngerät aus, um die Protokolldatei dieser Komponente in Echtzeit anzuzeigen. Ersetzen /greengrass/v2 oder C:\greengrass\v2 mit dem Pfad zum AWS IoT Greengrass Stammordner.

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

Ä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
  • Behebt ein Problem, bei dem Bereitstellungen blockiert wurden, wenn mehr als 1024 Geräteschatten konfiguriert wurden.

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
  • Behebt ein Problem, bei dem der Shadow Manager während der MQTT-Client-Verbindung eine Deadlock-Situation verursacht.

2.3.7

Fehlerbehebungen und Verbesserungen
  • Behebt ein Problem, bei dem Shadow Manager regelmäßig ein NullPointerException Fehler während einer Shadow-Manager-Synchronisierung.

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
  • Fügt Unterstützung für leere und leere Shadow-State-Dokumente hinzu.

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

Neue Features
  • Fügt Unterstützung für periodische Shadow-Synchronisierungsintervalle hinzu, sodass Sie das Kerngerät so konfigurieren können, dass die Bandbreitennutzung und die Gebühren reduziert werden.

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