

Hinweis zum Ende des Supports: Am 7. Oktober 2026 AWS wird der Support für eingestellt. AWS IoT Greengrass Version 1 Nach dem 7. Oktober 2026 können Sie nicht mehr auf die Ressourcen zugreifen. AWS IoT Greengrass V1 Weitere Informationen finden Sie unter [Migrieren von AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).

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.

# AWS IoT Greengrass Streammanager konfigurieren
<a name="configure-stream-manager"></a>

Im AWS IoT Greengrass Kern kann Stream Manager IoT-Gerätedaten speichern, verarbeiten und exportieren. Der Stream-Manager stellt Parameter bereit, die Sie zum Konfigurieren von Laufzeiteinstellungen auf Gruppenebene verwenden. Diese Einstellungen gelten für alle Streams auf dem Greengrass-Core. Sie können die AWS IoT Konsole oder AWS IoT Greengrass API verwenden, um die Stream Manager-Einstellungen zu konfigurieren. Änderungen werden wirksam, nachdem die Gruppe bereitgestellt wurde.

**Anmerkung**  
Nachdem Sie den Stream Manager konfiguriert haben, können Sie IoT-Anwendungen erstellen und bereitstellen, die auf dem Greengrass-Kern ausgeführt werden und mit dem Stream Manager interagieren. Bei diesen IoT-Anwendungen handelt es sich in der Regel um benutzerdefinierte Lambda-Funktionen. Weitere Informationen finden Sie unter [Wird verwendet StreamManagerClient , um mit Streams zu arbeiten](work-with-streams.md).

## Stream-Manager-Parameter
<a name="stream-manager-parameters"></a>

Der Stream-Manager stellt die folgenden Parameter bereit, mit denen Sie Einstellungen auf Gruppenebene definieren können. Alle Parameter sind optional.

**Speicherverzeichnis**  <a name="STREAM_MANAGER_STORE_ROOT_DIR"></a>
Parametername: `STREAM_MANAGER_STORE_ROOT_DIR`  
Der absolute Pfad des lokalen Verzeichnisses, das zum Speichern von Streams verwendet wird. Dieser Wert muss mit einem Schrägstrich (z. B. `/data`) beginnen.  
Hinweise zum Sichern von Streamdaten finden Sie unter [Lokale Datensicherheit](stream-manager.md#stream-manager-security-stream-data).  
Minimale AWS IoT Greengrass Kernversion: 1.10.0

**Server port**  
Parametername: `STREAM_MANAGER_SERVER_PORT`  
Die lokale Portnummer, die für die Kommunikation mit dem Stream-Manager verwendet wird. Der Standardwert ist `8088`.  
Minimale AWS IoT Greengrass Kernversion: 1.10.0

**Client authentifizieren**  <a name="STREAM_MANAGER_AUTHENTICATE_CLIENT"></a>
Parametername: `STREAM_MANAGER_AUTHENTICATE_CLIENT`  
Gibt an, ob Clients authentifiziert werden müssen, um mit dem Stream-Manager zu interagieren. Die gesamte Interaktion zwischen Clients und Stream Manager wird vom AWS IoT Greengrass Core SDK gesteuert. Dieser Parameter bestimmt, welche Clients das AWS IoT Greengrass Core SDK aufrufen können, um mit Streams zu arbeiten. Weitere Informationen finden Sie unter [Client-Authentifizierung](stream-manager.md#stream-manager-security-client-authentication).  
Gültige Werte sind `true` oder `false`. Der Standardwert ist `true` (empfohlen).  
+ `true`. Erlaubt nur Greengrass Lambda-Funktionen als Clients. Lambda-Funktionsclients verwenden interne AWS IoT Greengrass Kernprotokolle, um sich beim AWS IoT Greengrass Core SDK zu authentifizieren.
+ `false`. Ermöglicht es jedem Prozess, der auf dem AWS IoT Greengrass Core läuft, ein Client zu sein. Setzen Sie diese Einstellung nicht auf `false`, es sei denn, Ihr Geschäftsfall erfordert dies. Legen Sie diesen Wert beispielsweise `false` nur dann fest, wenn Nicht-Lambda-Prozesse auf dem Core-Gerät direkt mit dem Stream-Manager kommunizieren müssen, z. B. [Docker-Container](docker-app-connector.md), die auf dem Core ausgeführt werden.
Minimale AWS IoT Greengrass Core-Version: 1.10.0

**Maximale Bandbreite**  
Parametername: `STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH`  
Die durchschnittliche maximale Bandbreite (in Kilobit pro Sekunde), die zum Exportieren von Daten verwendet werden kann. Die Standardeinstellung erlaubt die unbegrenzte Nutzung der verfügbaren Bandbreite.  
Minimale AWS IoT Greengrass Kernversion: 1.10.0

**Größe des Threadpools**  
Parametername: `STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE`  
Die maximale Anzahl der aktiven Threads, die zum Exportieren von Daten verwendet werden können. Der Standardwert ist `5`.  
Die optimale Größe hängt von der Hardware, dem Stream-Volume und der geplanten Anzahl der Exportstreams ab. Wenn die Exportgeschwindigkeit langsam ist, können Sie diese Einstellung anpassen, um die optimale Größe für Ihre Hardware und Ihren Geschäftsfall zu ermitteln. Die CPU und der Arbeitsspeicher Ihrer Core-Geräte-Hardware sind begrenzende Faktoren. Um zu starten, können Sie versuchen, diesen Wert gleich der Anzahl der Prozessorkerne auf dem Gerät festzulegen.  
Achten Sie darauf, keine Größe festzulegen, die höher ist, als Ihre Hardware unterstützen kann. Jeder Stream verbraucht Hardwareressourcen, daher sollten Sie versuchen, die Anzahl der Exportstreams auf eingeschränkten Geräten zu begrenzen.  
Minimale AWS IoT Greengrass Kernversion: 1.10.0

**JVM-Argumente**  
Parametername: `JVM_ARGS`  
Benutzerdefinierte Java Virtual Machine-Argumente, die beim Start an den Stream-Manager übergeben werden. Mehrere Argumente sollten durch Leerzeichen getrennt werden.  
Verwenden Sie diesen Parameter nur, wenn Sie die von der JVM verwendeten Standardeinstellungen außer Kraft setzen müssen. Beispielsweise müssen Sie möglicherweise die Standard-Heap-Größe erhöhen, wenn Sie eine große Anzahl von Streams exportieren möchten.  
Minimale AWS IoT Greengrass Kernversion: 1.10.0

**Schreibgeschützte Eingabedateiverzeichnisse**  <a name="stream-manager-read-only-directories"></a>
Parametername: `STREAM_MANAGER_READ_ONLY_DIRS`  
Eine durch Kommas getrennte Liste absoluter Pfade zu den Verzeichnissen außerhalb des Root-Dateisystems, in denen Eingabedateien gespeichert sind. Stream Manager liest und lädt die Dateien auf Amazon S3 hoch und mountet die Verzeichnisse schreibgeschützt. Weitere Informationen zum Exportieren nach Amazon S3 finden Sie unter[Amazon-S3-Objekte](stream-export-configurations.md#export-to-s3).  
Verwenden Sie diesen Parameter nur, wenn die folgenden Bedingungen zutreffen:  
+ Das Eingabedateiverzeichnis für einen Stream, der nach Amazon S3 exportiert wird, befindet sich an einem der folgenden Speicherorte:
  + Eine andere Partition als das Root-Dateisystem.
  + Unter `/tmp` im Root-Dateisystem.
+ **Die [Standardcontainerisierung](lambda-group-config.md#lambda-containerization-groupsettings) der Greengrass-Gruppe ist Greengrass-Container.**
Beispielwert: `/mnt/directory-1,/mnt/directory-2,/tmp`  
Minimale Kernversion AWS IoT Greengrass : 1.11.0

**Mindestgröße für mehrteiligen Upload**  <a name="stream-manager-minimum-part-size"></a>
Parametername: `STREAM_MANAGER_EXPORTER_S3_DESTINATION_MULTIPART_UPLOAD_MIN_PART_SIZE_BYTES`  
Die Mindestgröße (in Byte) eines Teils in einem mehrteiligen Upload auf Amazon S3. Stream Manager verwendet diese Einstellung und die Größe der Eingabedatei, um zu bestimmen, wie Daten in einer mehrteiligen PUT-Anfrage gebündelt werden. Der Standard- und Mindestwert ist `5242880` Byte (5 MB).  
Stream Manager verwendet die `sizeThresholdForMultipartUploadBytes` Eigenschaft des Streams, um zu bestimmen, ob ein- oder mehrteiliger Upload nach Amazon S3 exportiert werden soll. Benutzerdefinierte Lambda-Funktionen legen diesen Schwellenwert fest, wenn sie einen Stream erstellen, der nach Amazon S3 exportiert wird. Der Standardschwellenwert ist 5 MB.
Minimale AWS IoT Greengrass Core-Version: 1.11.0

## Konfigurieren der Stream-Manager-Einstellungen (Konsole)
<a name="configure-stream-manager-console"></a>

Sie können die AWS IoT Konsole für die folgenden Verwaltungsaufgaben verwenden:
+ [Überprüfen, ob der Stream-Manager aktiviert ist](#check-stream-manager-console)
+ [Aktivieren oder Deaktivieren des Stream-Managers während der Gruppenerstellung](#enable-stream-manager-console-new-group)
+ [Aktivieren oder Deaktivieren des Stream-Managers für eine vorhandene Gruppe](#enable-stream-manager-console-existing-group)
+ [Ändern der Einstellungen für den Stream Manager](#change-stream-manager-console)

Änderungen werden wirksam, nachdem die Greengrass-Gruppe bereitgestellt wurde. Ein Tutorial, das zeigt, wie Sie eine Greengrass-Gruppe bereitstellen, die eine Lambda-Funktion enthält, die mit dem Stream-Manager interagiert, finden Sie unter. [Datenströme in die AWS Cloud (Konsole) exportieren](stream-manager-console.md)

**Anmerkung**  <a name="ggstreammanager-function-config-console"></a>
Wenn Sie die Konsole verwenden, um den Stream Manager zu aktivieren und die Gruppe bereitzustellen, ist die Speichergröße für den Stream Manager standardmäßig auf 4194304 KB (4 GB) festgelegt. Wir empfehlen, die Speichergröße auf mindestens 128000 KB festzulegen.

 

### So prüfen Sie, ob der Stream-Manager aktiviert ist (Konsole)
<a name="check-stream-manager-console"></a>

1. <a name="console-gg-groups"></a>Erweitern Sie im Navigationsbereich der AWS IoT Konsole unter **Verwalten** die Option **Greengrass-Geräte** und wählen Sie dann **Gruppen (V1)** aus.

1. <a name="group-choose-target-group"></a>Wählen Sie die Zielgruppe aus.

1. Wählen Sie die **Registerkarte Lambda-Funktionen**.

1. Wählen Sie unter **System Lambda-Funktionen** die Option **Stream Manager** und dann **Bearbeiten** aus.

1. Überprüfen Sie den Status „Aktiviert“ oder „Deaktiviert“. Alle konfigurierten benutzerdefinierten Stream-Manager-Einstellungen werden ebenfalls angezeigt.

 

### So aktivieren oder deaktivieren Sie den Stream-Manager während der Gruppenerstellung (Konsole)
<a name="enable-stream-manager-console-new-group"></a>

1. <a name="console-gg-groups"></a>Erweitern Sie im Navigationsbereich der AWS IoT Konsole unter **Verwalten** die Option **Greengrass-Geräte** und wählen Sie dann **Gruppen (V1)** aus.

1. Wählen Sie **Create Group**. Ihre Auswahl auf der nächsten Seite bestimmt, wie Sie den Stream-Manager für die Gruppe konfigurieren.

1. Gehen Sie unter **Name your Group** weiter und wählen Sie eine **Greengrass-Kernseite** aus.

1. Wählen Sie **Create group** (Gruppe erstellen) aus.

1. Wählen Sie auf der Gruppenkonfigurationsseite die Registerkarte **Lambda-Funktionen**, wählen Sie **Stream Manager** und dann **Bearbeiten** aus.
   + Um den Stream-Manager mit Standardeinstellungen zu aktivieren, wählen Sie **Mit Standardeinstellungen aktivieren**.

      
   + Um den Stream-Manager mit benutzerdefinierten Einstellungen zu aktivieren, wählen Sie **Einstellungen anpassen** aus.

     1. Wählen Sie auf der Seite **Stream Manager konfigurieren** die Option **Mit benutzerdefinierten Einstellungen aktivieren** aus.

     1. Geben Sie unter **Benutzerdefinierte Einstellungen** Werte für Stream-Manager-Parameter ein. Weitere Informationen finden Sie unter [Stream-Manager-Parameter](#stream-manager-parameters). Lassen Sie die Felder leer, AWS IoT Greengrass damit ihre Standardwerte verwendet werden können.

         
   + Um den Stream-Manager zu deaktivieren, wählen Sie **Disable**.

     1. Wählen Sie auf der Seite **Stream-Manager konfigurieren** die Option **Deaktivieren** aus.

         

1. Wählen Sie **Speichern**.

1. <a name="continue-create-group"></a>Fahren Sie mit den verbleibenden Seiten fort, um Ihre Gruppe zu erstellen.

1. Laden Sie auf der Seite **Client-Geräte** Ihre Sicherheitsressourcen herunter, überprüfen Sie die Informationen und klicken Sie dann auf **Fertig stellen**.
**Anmerkung**  
Wenn der Stream-Manager aktiviert ist, müssen Sie [die Java 8-Laufzeitumgebung](stream-manager.md#stream-manager-requirements) auf dem Core-Gerät installieren, bevor Sie die Gruppe bereitstellen.

 

### So aktivieren oder deaktivieren Sie den Stream-Manager für eine vorhandene Gruppe (Konsole)
<a name="enable-stream-manager-console-existing-group"></a>

1. <a name="console-gg-groups"></a>Erweitern Sie im Navigationsbereich der AWS IoT Konsole unter **Verwalten** die Option **Greengrass-Geräte** und wählen Sie dann **Gruppen (V1)** aus.

1. <a name="group-choose-target-group"></a>Wählen Sie die Zielgruppe aus.

1. Wählen Sie die **Registerkarte Lambda-Funktionen**.

1. Wählen Sie unter **System Lambda-Funktionen** die Option **Stream Manager** und dann **Bearbeiten** aus.

1. Überprüfen Sie den Status „Aktiviert“ oder „Deaktiviert“. Alle konfigurierten benutzerdefinierten Stream-Manager-Einstellungen werden ebenfalls angezeigt.

 

### So ändern Sie die Einstellungen des Stream-Managers (Konsole)
<a name="change-stream-manager-console"></a>

1. <a name="console-gg-groups"></a>Erweitern Sie im Navigationsbereich der AWS IoT Konsole unter **Verwalten** die Option **Greengrass-Geräte** und wählen Sie dann **Gruppen (V1)** aus.

1. <a name="group-choose-target-group"></a>Wählen Sie die Zielgruppe aus.

1. Wählen Sie die **Registerkarte Lambda-Funktionen**.

1. Wählen Sie unter **System Lambda-Funktionen** die Option **Stream Manager** und dann **Bearbeiten** aus.

1. Überprüfen Sie den Status „Aktiviert“ oder „Deaktiviert“. Alle konfigurierten benutzerdefinierten Stream-Manager-Einstellungen werden ebenfalls angezeigt.

1. Wählen Sie **Speichern**.

## Konfigurieren der Stream Manager-Einstellungen (CLI)
<a name="configure-stream-manager-cli"></a>

Verwenden Sie in der die AWS CLI`GGStreamManager` Lambda-Funktion des Systems, um den Stream-Manager zu konfigurieren. System-Lambda-Funktionen sind Bestandteile der AWS IoT Greengrass Core-Software. Für Stream Manager und einige andere Lambda-Systemfunktionen können Sie die Greengrass-Funktionalität konfigurieren, indem Sie die entsprechenden `Function` `FunctionDefinitionVersion` AND-Objekte in der Greengrass-Gruppe verwalten. Weitere Informationen finden Sie unter [Überblick über das AWS IoT Greengrass Gruppenobjektmodell](deployments.md#api-overview).

Sie können die API für die folgenden Verwaltungsaufgaben verwenden. Die Beispiele in diesem Abschnitt zeigen, wie Sie die verwenden AWS CLI, aber Sie können die AWS IoT Greengrass API auch direkt aufrufen oder ein AWS SDK verwenden.
+ [Überprüfen, ob der Stream-Manager aktiviert ist](#check-stream-manager-cli)
+ [Aktivieren, deaktivieren oder konfigurieren Sie den Stream Manager](#enable-stream-manager-cli)

Änderungen werden wirksam, nachdem die Gruppe bereitgestellt wurde. Ein Tutorial, das zeigt, wie Sie eine Greengrass-Gruppe mit einer Lambda-Funktion bereitstellen, die mit dem Stream-Manager interagiert, finden Sie unter. [Datenströme in die AWS Cloud (CLI) exportieren](stream-manager-cli.md)

**Tipp**  
Um zu sehen, ob der Stream-Manager aktiviert ist und von Ihrem Kerngerät aus ausgeführt wird, können Sie den folgenden Befehl in einem Terminal auf dem Gerät ausführen.  

```
ps aux | grep -i 'streammanager'
```

 

### So prüfen Sie, ob der Stream-Manager aktiviert ist (CLI)
<a name="check-stream-manager-cli"></a>

Stream Manager ist aktiviert, wenn Ihre bereitgestellte Funktionsdefinitionsversion die `GGStreamManager` Lambda-Funktion des Systems enthält. Zur Überprüfung gehen Sie folgendermaßen vor:

1. <a name="get-group-id-latestversion"></a>Rufen Sie IDs die Greengrass-Zielgruppe und die Gruppenversion ab. Bei diesem Verfahren wird davon ausgegangen, dass es sich um die neueste Gruppen- und Gruppenversion handelt. Die folgende Abfrage gibt die zuletzt erstellte Gruppe zurück.

   ```
   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"
   ```

   Sie können auch nach Namen abfragen. Gruppennamen müssen nicht eindeutig sein, sodass mehrere Gruppen zurückgegeben werden können.

   ```
   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"
   ```
**Anmerkung**  
<a name="find-group-ids-console"></a>Sie können diese Werte auch in der AWS IoT Konsole finden. Die Gruppen-ID wird auf der Seite **Einstellungen** der Gruppe angezeigt. Die Gruppenversion IDs wird auf der Registerkarte **Bereitstellungen** der Gruppe angezeigt.

1. <a name="copy-group-id-latestversion"></a>Kopieren Sie die `LatestVersion`Werte und `Id` aus der Zielgruppe in die Ausgabe.

1. <a name="get-latest-group-version"></a>Rufen Sie die neueste Gruppenversion ab.
   + Ersetzen Sie *group-id* durch den `Id`, den Sie kopiert haben.
   + Ersetzen Sie *latest-group-version-id* durch den `LatestVersion`, den Sie kopiert haben.

   ```
   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id latest-group-version-id
   ```

1. Rufen Sie aus `FunctionDefinitionVersionArn` der Ausgabe die Version IDs der Funktionsdefinition und der Funktionsdefinition ab.
   + Die Funktionsdefinitions-ID ist die GUID, die dem `functions` Segment im Amazon-Ressourcennamen (ARN) folgt.
   + Die ID der Funktionsdefinitionsversion ist die GUID, die dem `versions`-Segment im ARN folgt.

   ```
   arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/function-definition-id/versions/function-definition-version-id
   ```

1. Rufen Sie die ID der Funktionsdefinitionsversion ab.
   + Ersetzen Sie *function-definition-id* durch die Funktionsdefinitions-ID.
   + *function-definition-version-id*Ersetzen Sie durch die Versions-ID der Funktionsdefinition.

   ```
   aws greengrass get-function-definition-version \
   --function-definition-id function-definition-id \
   --function-definition-version-id function-definition-version-id
   ```

Wenn das `functions`-Array in der Ausgabe die `GGStreamManager`-Funktion enthält, ist der Stream-Manager aktiviert. Alle Umgebungsvariablen, die für die Funktion definiert sind, stellen benutzerdefinierte Einstellungen für den Stream-Manager dar.

### Um den Stream Manager (CLI) zu aktivieren, zu deaktivieren oder zu konfigurieren
<a name="enable-stream-manager-cli"></a>

Verwenden Sie in der die AWS CLI`GGStreamManager` Lambda-Funktion des Systems, um den Stream-Manager zu konfigurieren. Änderungen werden wirksam, nachdem Sie die Gruppe bereitgestellt haben.
+ Um den Stream-Manager zu aktivieren, schließen Sie `GGStreamManager` in das `functions`-Array Ihrer Funktionsdefinitionsversion ein. Um benutzerdefinierte Einstellungen zu konfigurieren, definieren Sie Umgebungsvariablen für die entsprechenden [Stream-Manager-Parameter](#stream-manager-parameters).
+ Um den Stream-Manager zu deaktivieren, entfernen Sie `GGStreamManager` aus dem `functions`-Array Ihrer Funktionsdefinitionsversion.

**Stream-Manager mit Standardeinstellungen**  
Die folgende Beispielkonfiguration aktiviert den Stream-Manager mit Standardeinstellungen. Sie setzt die beliebige Funktions-ID auf `streamManager`.  

```
{
    "FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
    "FunctionConfiguration": {
        "MemorySize": 4194304,
        "Pinned": true,
        "Timeout": 3
    },
    "Id": "streamManager"
}
```
Was die `FunctionConfiguration` Eigenschaften angeht, wissen Sie vielleicht Folgendes:  
+ `MemorySize`ist mit den Standardeinstellungen auf 4194304 KB (4 GB) eingestellt. Sie können diesen Wert jederzeit ändern. Wir empfehlen, dass Sie einen `MemorySize` Wert von mindestens 128000 KB angeben.
+ muss `Pinned` auf `true` festgelegt sein.
+ `Timeout` ist für die Funktionsdefinitionsversion erforderlich, wird vom `GGStreamManager` jedoch nicht verwendet.

**Stream-Manager mit benutzerdefinierten Einstellungen**  <a name="enable-stream-manager-custom-settings"></a>
Die folgende Beispielkonfiguration aktiviert Stream Manager mit benutzerdefinierten Werten für die Parameter Speicherverzeichnis, Serverport und Threadpool-Größe.  

```
{
    "FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
    "FunctionConfiguration": {
        "Environment": {
            "Variables": {
                "STREAM_MANAGER_STORE_ROOT_DIR": "/data",
                "STREAM_MANAGER_SERVER_PORT": "1234",
                "STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE": "4"
            }
        },
        "MemorySize": 4194304,
        "Pinned": true,
        "Timeout": 3
    },
    "Id": "streamManager"
}
```
AWS IoT Greengrass verwendet Standardwerte für [Stream-Manager-Parameter](#stream-manager-parameters), die nicht als Umgebungsvariablen angegeben sind.

**Stream-Manager mit benutzerdefinierten Einstellungen für Amazon S3 S3-Exporte**  <a name="enable-stream-manager-custom-settings-s3"></a>
Die folgende Beispielkonfiguration aktiviert den Stream-Manager mit benutzerdefinierten Werten für das Upload-Verzeichnis und Mindestparametern für die Größe mehrteiliger Uploads.  

```
{
    "FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
    "FunctionConfiguration": {
        "Environment": {
            "Variables": {
                "STREAM_MANAGER_READ_ONLY_DIRS": "/mnt/directory-1,/mnt/directory-2,/tmp",
                "STREAM_MANAGER_EXPORTER_S3_DESTINATION_MULTIPART_UPLOAD_MIN_PART_SIZE_BYTES": "10485760"
            }
        },
        "MemorySize": 4194304,
        "Pinned": true,
        "Timeout": 3
    },
    "Id": "streamManager"
}
```

 

**Um den Stream Manager (CLI) zu aktivieren, zu deaktivieren oder zu konfigurieren**

1. <a name="get-group-id-latestversion"></a>Rufen Sie IDs die Greengrass-Zielgruppe und die Gruppenversion ab. Bei diesem Verfahren wird davon ausgegangen, dass es sich um die neueste Gruppen- und Gruppenversion handelt. Die folgende Abfrage gibt die zuletzt erstellte Gruppe zurück.

   ```
   aws greengrass list-groups --query "reverse(sort_by(Groups, &CreationTimestamp))[0]"
   ```

   Sie können auch nach Namen abfragen. Gruppennamen müssen nicht eindeutig sein, sodass mehrere Gruppen zurückgegeben werden können.

   ```
   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"
   ```
**Anmerkung**  
<a name="find-group-ids-console"></a>Sie können diese Werte auch in der AWS IoT Konsole finden. Die Gruppen-ID wird auf der Seite **Einstellungen** der Gruppe angezeigt. Die Gruppenversion IDs wird auf der Registerkarte **Bereitstellungen** der Gruppe angezeigt.

1. <a name="copy-group-id-latestversion"></a>Kopieren Sie die `LatestVersion`Werte und `Id` aus der Zielgruppe in die Ausgabe.

1. <a name="get-latest-group-version"></a>Rufen Sie die neueste Gruppenversion ab.
   + Ersetzen Sie *group-id* durch den `Id`, den Sie kopiert haben.
   + Ersetzen Sie *latest-group-version-id* durch den `LatestVersion`, den Sie kopiert haben.

   ```
   aws greengrass get-group-version \
   --group-id group-id \
   --group-version-id latest-group-version-id
   ```

1. Kopieren Sie die `CoreDefinitionVersionArn` und alle anderen Versionen ARNs aus der Ausgabe, außer`FunctionDefinitionVersionArn`. Sie verwenden diese Werte später, wenn Sie eine Gruppenversion erstellen.

1. <a name="parse-function-def-id"></a>Kopieren Sie die ID der Funktionsdefinition aus `FunctionDefinitionVersionArn`. Die ID ist die GUID, die dem `functions`-Segment im ARN folgt, wie im folgenden Beispiel gezeigt.

   ```
   arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/bcfc6b49-beb0-4396-b703-6dEXAMPLEcu5/versions/0f7337b4-922b-45c5-856f-1aEXAMPLEsf6
   ```
**Anmerkung**  
Sie können auch eine Funktionsdefinition erstellen, indem Sie den [https://docs.aws.amazon.com/cli/latest/reference/greengrass/create-function-definition.html](https://docs.aws.amazon.com/cli/latest/reference/greengrass/create-function-definition.html)Befehl ausführen und dann die ID aus der Ausgabe kopieren.

1. <a name="enable-stream-manager-function-definition-version"></a>Fügen Sie der Funktionsdefinition eine Funktionsdefinitionsversion hinzu.
   + *function-definition-id*Ersetzen Sie sie durch `Id` die, die Sie für die Funktionsdefinition kopiert haben.
   + Fügen Sie in das `functions` Array alle anderen Funktionen ein, die Sie auf dem Greengrass-Kern verfügbar machen möchten. Sie können den `get-function-definition-version`-Befehl verwenden, um die Liste der vorhandenen Funktionen abzurufen.

      
**Aktivieren des Stream-Managers mit Standardeinstellungen**  
Im folgenden Beispiel wird der Stream-Manager aktiviert, indem die `GGStreamManager` Funktion in das `functions` Array aufgenommen wird. In diesem Beispiel werden Standardwerte für die [ Stream-Manager-Parameter](#stream-manager-parameters) verwendet.  

   ```
   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[
           {
               "FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
               "FunctionConfiguration": {
                   "MemorySize":  4194304,
                   "Pinned": true,
                   "Timeout": 3
               },
               "Id": "streamManager"
           },
           {    
               "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:MyLambdaFunction:MyAlias",
               "FunctionConfiguration": {
                   "Executable": "myLambdaFunction.function_handler",
                   "MemorySize": 16000,
                   "Pinned": true,
                   "Timeout": 5
               },
               "Id": "myLambdaFunction"
           },
           ... more user-defined functions
       ]
   }'
   ```
Die `myLambdaFunction` Funktion in den Beispielen stellt eine Ihrer benutzerdefinierten Lambda-Funktionen dar.  
**Aktivieren des Stream-Managers mit benutzerdefinierten Einstellungen**  
Im folgenden Beispiel wird der Stream-Manager aktiviert, indem die `GGStreamManager`-Funktion in das `functions`-Array aufgenommen wird. Alle Stream-Manager-Einstellungen sind optional, es sei denn, Sie möchten die Standardwerte ändern. Dieses Beispiel zeigt, wie Umgebungsvariablen verwendet werden, um benutzerdefinierte Werte festzulegen.  

   ```
   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[
           {
               "FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
               "FunctionConfiguration": {
                   "Environment": {
                       "Variables": {
                           "STREAM_MANAGER_STORE_ROOT_DIR": "/data",
                           "STREAM_MANAGER_SERVER_PORT": "1234",
                           "STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE": "4"
                       }
                   },
                   "MemorySize":  4194304,
                   "Pinned": true,
                   "Timeout": 3
               },
               "Id": "streamManager"
           },
           {    
               "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:MyLambdaFunction:MyAlias",
               "FunctionConfiguration": {
                   "Executable": "myLambdaFunction.function_handler",
                   "MemorySize": 16000,
                   "Pinned": true,
                   "Timeout": 5
               },
               "Id": "myLambdaFunction"
           },
           ... more user-defined functions
       ]
   }'
   ```
Was die `FunctionConfiguration` Eigenschaften angeht, wissen Sie vielleicht Folgendes:  
   + `MemorySize`ist mit den Standardeinstellungen auf 4194304 KB (4 GB) eingestellt. Sie können diesen Wert jederzeit ändern. Wir empfehlen, dass Sie einen `MemorySize` Wert von mindestens 128000 KB angeben.
   + muss `Pinned` auf `true` festgelegt sein.
   + `Timeout` ist für die Funktionsdefinitionsversion erforderlich, wird vom `GGStreamManager` jedoch nicht verwendet.  
**Deaktivieren des Stream-Managers**  
Im folgenden Beispiel wird die `GGStreamManager`-Funktion weggelassen, wodurch der Stream-Manager deaktiviert wird.  

   ```
   aws greengrass create-function-definition-version \
   --function-definition-id function-definition-id \
   --functions '[
           {       
               "FunctionArn": "arn:aws:lambda:us-west-2:123456789012:function:MyLambdaFunction:MyAlias",
               "FunctionConfiguration": {
                   "Executable": "myLambdaFunction.function_handler",
                   "MemorySize": 16000,
                   "Pinned": true,
                   "Timeout": 5
               },
               "Id": "myLambdaFunction"
           },
           ... more user-defined functions
       ]
   }'
   ```
Wenn Sie keine Lambda-Funktionen bereitstellen möchten, können Sie die Version der Funktionsdefinition vollständig weglassen.

1. <a name="copy-function-def-version-arn"></a>Kopieren Sie den `Arn` der Funktionsdefinitionsversion aus der Ausgabe.

1. <a name="create-group-version-with-sys-lambda"></a>Erstellen Sie eine Gruppenversion, die die Lambda-Funktion des Systems enthält.
   + Ersetzen Sie *group-id* durch die `Id` für die Gruppe.
   + *core-definition-version-arn*Ersetzen Sie es durch `CoreDefinitionVersionArn` das, was Sie aus der neuesten Gruppenversion kopiert haben.
   + *function-definition-version-arn*Ersetzen Sie es durch `Arn` das, was Sie für die neue Version der Funktionsdefinition kopiert haben.
   + Ersetzen Sie die ARNs für andere Gruppenkomponenten (z. B. `SubscriptionDefinitionVersionArn` oder`DeviceDefinitionVersionArn`), die Sie aus der neuesten Gruppenversion kopiert haben.
   + Entfernen Sie alle nicht verwendeten Parameter. Entfernen Sie zum Beispiel `--resource-definition-version-arn`, wenn Ihre Gruppenversion keine Ressourcen enthält.

   ```
   aws greengrass create-group-version \
   --group-id group-id \
   --core-definition-version-arn core-definition-version-arn \
   --function-definition-version-arn function-definition-version-arn \
   --device-definition-version-arn device-definition-version-arn \
   --logger-definition-version-arn logger-definition-version-arn \
   --resource-definition-version-arn resource-definition-version-arn \
   --subscription-definition-version-arn subscription-definition-version-arn
   ```

1. <a name="copy-group-version-id"></a>Kopieren Sie die `Version` aus der Ausgabe. Dies ist die ID der neuen Gruppenversion.

1. <a name="create-group-deployment"></a>Stellen Sie die Gruppe mit der neuen Gruppenversion bereit.
   + *group-id*Ersetzen Sie sie durch `Id` die, die Sie für die Gruppe kopiert haben.
   + *group-version-id*Ersetzen Sie es durch `Version` das, was Sie für die neue Gruppenversion kopiert haben.

   ```
   aws greengrass create-deployment \
   --group-id group-id \
   --group-version-id group-version-id \
   --deployment-type NewDeployment
   ```

 

Gehen Sie wie folgt vor, wenn Sie die Stream Manager-Einstellungen später erneut bearbeiten möchten. Stellen Sie sicher, dass Sie eine Version der Funktionsdefinition erstellen, die die `GGStreamManager` Funktion mit der aktualisierten Konfiguration enthält. Die Gruppenversion muss auf alle Komponentenversionen verweisen ARNs , die Sie im Core bereitstellen möchten. Änderungen werden wirksam, nachdem die Gruppe bereitgestellt wurde.

## Weitere Informationen finden Sie auch unter
<a name="configure-stream-manager-see-also"></a>
+ [Datenströme auf dem AWS IoT Greengrass Core verwalten](stream-manager.md)
+ [Wird verwendet StreamManagerClient , um mit Streams zu arbeiten](work-with-streams.md)
+ [Konfigurationen für unterstützte AWS Cloud Ziele exportieren](stream-export-configurations.md)
+ [Datenströme in die AWS Cloud (Konsole) exportieren](stream-manager-console.md)
+ [Datenströme in die AWS Cloud (CLI) exportieren](stream-manager-cli.md)