

Aviso de fim do suporte: em 7 de outubro de 2026, AWS o suporte para o. AWS IoT Greengrass Version 1 Depois de 7 de outubro de 2026, você não poderá mais acessar os AWS IoT Greengrass V1 recursos. Para obter mais informações, visite [Migrar de AWS IoT Greengrass Version 1](https://docs.aws.amazon.com/greengrass/v2/developerguide/migrate-from-v1.html).

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Configurar o gerenciador de AWS IoT Greengrass streams
<a name="configure-stream-manager"></a>

No AWS IoT Greengrass núcleo, o gerenciador de streams pode armazenar, processar e exportar dados de dispositivos de IoT. O gerenciador de fluxo fornece parâmetros que você usa para definir configurações de tempo de execução no nível do grupo. Essas configurações se aplicam a todos os streams no núcleo do Greengrass. Você pode usar o AWS IoT console ou a AWS IoT Greengrass API para definir as configurações do gerenciador de streams. As alterações entrarão em vigor após a implantação do grupo.

**nota**  
Após configurar o gerenciador de fluxo, você pode criar e implantar aplicativos de IoT que são executados no núcleo do Greengrass e interagem com o gerenciador de fluxo. Esses aplicativos de IoT geralmente são funções do Lambda definidas pelo usuário. Para obter mais informações, consulte [Use StreamManagerClient para trabalhar com streams](work-with-streams.md).

## Parâmetros do gerenciador de fluxo
<a name="stream-manager-parameters"></a>

O gerenciador de fluxo fornece os seguintes parâmetros que permitem definir configurações no nível do grupo. Todos os parâmetros são opcionais.

**Diretório de armazenamento**  <a name="STREAM_MANAGER_STORE_ROOT_DIR"></a>
Nome do parâmetro: `STREAM_MANAGER_STORE_ROOT_DIR`  
O caminho absoluto do diretório local usado para armazenar fluxos. Esse valor deve começar com uma barra (por exemplo, `/data`).  
Para obter informações sobre como proteger dados de fluxo, consulte [Segurança de dados locais](stream-manager.md#stream-manager-security-stream-data).  
Versão mínima AWS IoT Greengrass do núcleo: 1.10.0

**Porta do servidor**  
Nome do parâmetro: `STREAM_MANAGER_SERVER_PORT`  
O número da porta local usado para se comunicar com o gerenciador de fluxo. O padrão é `8088`.  
Versão mínima AWS IoT Greengrass do núcleo: 1.10.0

**Autenticar cliente**  <a name="STREAM_MANAGER_AUTHENTICATE_CLIENT"></a>
Nome do parâmetro: `STREAM_MANAGER_AUTHENTICATE_CLIENT`  
Indica se os clientes devem ser autenticados de modo a interagir com o gerenciador de fluxo. Toda interação entre clientes e o gerenciador de streams é controlada pelo SDK AWS IoT Greengrass principal. Esse parâmetro determina quais clientes podem chamar o SDK do AWS IoT Greengrass Core para trabalhar com fluxos. Para obter mais informações, consulte [Autenticação de cliente](stream-manager.md#stream-manager-security-client-authentication).  
Os valores válidos são `true` ou `false`. O padrão é `true` (recomendado).  
+ `true`. Permite apenas funções do Lambda do Greengrass como clientes. Os clientes da função Lambda usam protocolos AWS IoT Greengrass principais internos para se autenticar com o AWS IoT Greengrass SDK principal.
+ `false`. Permite que qualquer processo executado no AWS IoT Greengrass núcleo seja um cliente. Não defina como `false` a menos que seu caso de negócios exija. Por exemplo, defina esse valor como `false` somente se os processos que não são do dispositivo central precisarem se comunicar diretamente com o gerenciador de fluxo, como [contêineres do Docker](docker-app-connector.md) em execução no núcleo.
Versão mínima AWS IoT Greengrass do núcleo: 1.10.0

**Largura máxima de banda**  
Nome do parâmetro: `STREAM_MANAGER_EXPORTER_MAX_BANDWIDTH`  
A média da largura máxima de banda (em kilobits por segundo) que pode ser usada para exportar dados. O padrão permite o uso ilimitado da largura de banda disponível.  
Versão mínima AWS IoT Greengrass do núcleo: 1.10.0

**Tamanho do grupo de threads**  
Nome do parâmetro: `STREAM_MANAGER_EXPORTER_THREAD_POOL_SIZE`  
O número máximo de threads ativos que podem ser usados para exportar dados. O padrão é `5`.  
O tamanho ideal depende do hardware, do volume do fluxo e do número planejado de fluxos de exportação. Se a velocidade de exportação for lenta, será possível ajustar essa configuração para encontrar o tamanho ideal para seu hardware e caso de negócios. A CPU e a memória do hardware do dispositivo de núcleo são fatores limitantes. Para iniciar, você pode tentar definir esse valor igual ao número de núcleos do processador no dispositivo.  
Tenha cuidado para não definir um tamanho superior ao que o seu hardware pode suportar. Cada fluxo consome recursos de hardware, portanto, você deve tentar limitar o número de fluxos de exportação em dispositivos restritos.  
Versão mínima AWS IoT Greengrass do núcleo: 1.10.0

**Argumentos JVM**  
Nome do parâmetro: `JVM_ARGS`  
Argumentos personalizados da Java Virtual Machine para passar para o gerenciador de fluxo na startup. Se houver vários argumentos, separe-os por espaços.  
Só use esse parâmetro quando precisar substituir as configurações padrão usadas pela JVM. Por exemplo, talvez seja necessário aumentar o tamanho do heap padrão caso você planeje exportar um grande número de fluxos.  
Versão mínima AWS IoT Greengrass do núcleo: 1.10.0

**Diretórios de arquivos de entrada somente leitura**  <a name="stream-manager-read-only-directories"></a>
Nome do parâmetro: `STREAM_MANAGER_READ_ONLY_DIRS`  
Uma lista separada por vírgulas de caminhos absolutos para os diretórios fora do sistema de arquivos raiz que armazenam arquivos de entrada. O gerenciador de fluxo lê e carrega os arquivos no Amazon S3 e monta os diretórios como somente leitura. Para obter mais informações, sobre como exportar para o Amazon S3, consulte [Objetos do Amazon S3](stream-export-configurations.md#export-to-s3).  
Use esse parâmetro somente se as condições a seguir forem verdadeiras:  
+ O diretório de arquivos de entrada de um fluxo que exporta para o Amazon S3 está em um dos seguintes locais:
  + Uma partição diferente do sistema de arquivos raiz.
  + Em `/tmp` no sistema de arquivos raiz.
+ A [conteinerização padrão](lambda-group-config.md#lambda-containerization-groupsettings) do grupo Greengrass é o **contêiner Greengrass**.
Valor de exemplo: `/mnt/directory-1,/mnt/directory-2,/tmp`  
Versão mínima AWS IoT Greengrass do núcleo: 1.11.0

**Tamanho mínimo para upload de várias partes**  <a name="stream-manager-minimum-part-size"></a>
Nome do parâmetro: `STREAM_MANAGER_EXPORTER_S3_DESTINATION_MULTIPART_UPLOAD_MIN_PART_SIZE_BYTES`  
O tamanho mínimo (em bytes) de uma parte em um upload multiparte para o Amazon S3. O gerenciador de fluxo usa essa configuração e o tamanho do arquivo de entrada para determinar como agrupar dados em lote em uma solicitação PUT de várias partes. O valor mínimo e padrão é de `5242880` bytes (5 MB).  
O gerenciador de fluxo usa a propriedade `sizeThresholdForMultipartUploadBytes` do fluxo para determinar se deve exportar para o Amazon S3 como um upload de uma ou várias partes. As funções do Lambda definidas pelo usuário definem esse limite quando criam um fluxo que exporta para o Amazon S3. O limite padrão é 5 MB.
Versão mínima AWS IoT Greengrass do núcleo: 1.11.0

## Definir configurações do gerenciador de fluxo (console)
<a name="configure-stream-manager-console"></a>

Você pode usar o AWS IoT console para as seguintes tarefas de gerenciamento:
+ [Verificar se o gerenciador de fluxo está habilitado](#check-stream-manager-console)
+ [Habilitar ou desabilitar o gerenciador de fluxo durante a criação do grupo](#enable-stream-manager-console-new-group)
+ [Habilitar ou desabilitar o gerenciador de fluxo para um grupo existente](#enable-stream-manager-console-existing-group)
+ [Alterar configurações do gerenciador de fluxo](#change-stream-manager-console)

As alterações entram em vigor após a implantação do grupo do Greengrass. Para ver um tutorial que mostra como implantar um grupo do Greengrass que contém uma função do Lambda que interage com o gerenciador de fluxo, consulte [Exportar fluxos de dados para o Nuvem AWS (console)](stream-manager-console.md).

**nota**  <a name="ggstreammanager-function-config-console"></a>
Quando você usa o console para habilitar o gerenciador de fluxo e implantar o grupo, o limite de memória para o gerenciador de fluxo é definido como 4194304 KB (4 GB), por padrão. É recomendável definir o tamanho da memória para pelo menos 128000 KB.

 

### Para verificar se o gerenciador de fluxo está habilitado (console)
<a name="check-stream-manager-console"></a>

1. <a name="console-gg-groups"></a>No painel de navegação do AWS IoT console, em **Gerenciar**, expanda dispositivos **Greengrass** e **escolha Grupos (**V1).

1. <a name="group-choose-target-group"></a>Selecione o grupo de destino.

1. Selecione a guia **Funções do Lambda**.

1. Em **Funções do Lambda do sistema**, selecione **Gerenciador de fluxo** e selecione **Editar**.

1. Verifique o status ativado ou desativado. Todas as configurações personalizadas do gerenciador de fluxo que estão definidas também são exibidas.

 

### Para habilitar ou desabilitar o gerenciador de fluxo durante a criação do grupo (console)
<a name="enable-stream-manager-console-new-group"></a>

1. <a name="console-gg-groups"></a>No painel de navegação do AWS IoT console, em **Gerenciar**, expanda dispositivos **Greengrass** e **escolha Grupos (**V1).

1. Selecione **Create Group**. Sua selecione na próxima página determina a configuração do gerenciador de fluxo para o grupo.

1. Vá até a seção **Nomeie seu grupo** e selecione as páginas de **Núcleo do Greengrass**.

1. Selecione **Criar grupo**.

1. Na página de configuração do grupo, selecione a guia **Funções do Lambda**, selecione **Gerenciador de fluxo** e selecione **Editar**.
   + Para habilitar o gerenciador de fluxo com configurações padrão, selecione **Habilitar com definições padrão**.

      
   + Para habilitar o gerenciador de fluxo com configurações personalizadas, selecione **Customize settings (Personalizar configurações)**.

     1. Na página **Configurar gerenciador de fluxo**, selecione **Habilitar**.

     1. Em **Custom settings (Configurações personalizadas)**, insira os valores para os parâmetros do gerenciador de fluxo. Para obter mais informações, consulte [Parâmetros do gerenciador de fluxo](#stream-manager-parameters). Deixe os campos vazios para AWS IoT Greengrass permitir o uso de seus valores padrão.

         
   + Para desativar o gerenciador de fluxo, selecione **Desativar**.

     1. Na página **Configure stream manager (Configurar gerenciador de fluxo)** selecione **Disable (Desabilitar)**.

         

1. Selecione **Salvar**.

1. <a name="continue-create-group"></a>Continue nas páginas restantes para criar seu grupo.

1. Na página **Dispositivos cliente**, faça download dos recursos de segurança, reveja as informações e, em seguida selecione **Concluir**.
**nota**  
Quando o gerenciador de fluxo estiver habilitado, [instale o Java 8 Runtime](stream-manager.md#stream-manager-requirements) no dispositivo de núcleo antes de implantar o grupo.

 

### Para habilitar ou desabilitar o gerenciador de fluxo para um grupo existente (console)
<a name="enable-stream-manager-console-existing-group"></a>

1. <a name="console-gg-groups"></a>No painel de navegação do AWS IoT console, em **Gerenciar**, expanda dispositivos **Greengrass** e **escolha Grupos (**V1).

1. <a name="group-choose-target-group"></a>Selecione o grupo de destino.

1. Selecione a guia **Funções do Lambda**.

1. Em **Funções do Lambda do sistema**, selecione **Gerenciador de fluxo** e selecione **Editar**.

1. Verifique o status ativado ou desativado. Todas as configurações personalizadas do gerenciador de fluxo que estão definidas também são exibidas.

 

### Para alterar as configurações do gerenciador de fluxo (console)
<a name="change-stream-manager-console"></a>

1. <a name="console-gg-groups"></a>No painel de navegação do AWS IoT console, em **Gerenciar**, expanda dispositivos **Greengrass** e **escolha Grupos (**V1).

1. <a name="group-choose-target-group"></a>Selecione o grupo de destino.

1. Selecione a guia **Funções do Lambda**.

1. Em **Funções do Lambda do sistema**, selecione **Gerenciador de fluxo** e selecione **Editar**.

1. Verifique o status ativado ou desativado. Todas as configurações personalizadas do gerenciador de fluxo que estão definidas também são exibidas.

1. Selecione **Salvar**.

## Definir configurações do gerenciador de fluxo (CLI)
<a name="configure-stream-manager-cli"></a>

No AWS CLI, use a função `GGStreamManager` Lambda do sistema para configurar o gerenciador de streams. As funções do System Lambda são componentes do software AWS IoT Greengrass Core. Para o gerenciador de fluxo e algumas outras funções do Lambda do sistema, você pode configurar a funcionalidade do Greengrass gerenciando os objetos `Function` e `FunctionDefinitionVersion` correspondentes no grupo Greengrass. Para obter mais informações, consulte [Visão geral do modelo de objeto de AWS IoT Greengrass grupo](deployments.md#api-overview).

É possível usar a API para as seguintes tarefas de gerenciamento. Os exemplos nesta seção mostram como usar o AWS CLI, mas você também pode chamar a AWS IoT Greengrass API diretamente ou usar um AWS SDK.
+ [Verificar se o gerenciador de fluxo está habilitado](#check-stream-manager-cli)
+ [Habilitar, desabilitar ou definir configurações do gerenciador de fluxo](#enable-stream-manager-cli)

As alterações entrarão em vigor após a implantação do grupo. Para ver um tutorial que mostra como implantar um grupo do Greengrass com uma função do Lambda que interage com o gerenciador de fluxo, consulte [Exportar fluxos de dados para o Nuvem AWS (CLI)](stream-manager-cli.md).

**dica**  
Para analisar se o gerenciador de fluxo está habilitado e em execução, você pode executar o comando a seguir em um terminal no seu dispositivo de núcleo.  

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

 

### Para verificar se o gerenciador de fluxo está habilitado (CLI)
<a name="check-stream-manager-cli"></a>

O gerenciador de fluxo será habilitado se a versão de definição de função implantada incluir a função do Lambda do sistema `GGStreamManager`. Para verificar, faça o seguinte;

1. <a name="get-group-id-latestversion"></a>Obtenha a versão IDs do grupo-alvo do Greengrass e do grupo. Esse procedimento pressupõe que esse seja o grupo e a versão mais recente do grupo. A consulta a seguir retorna o grupo criado mais recentemente.

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

   Ou é possível consultar por nome. Os nomes de grupo não precisam ser exclusivos, portanto, vários grupos podem ser retornados.

   ```
   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"
   ```
**nota**  
<a name="find-group-ids-console"></a>Você também pode encontrar esses valores no AWS IoT console. O ID do grupo é exibido na página **Settings (Configurações)** do grupo. IDs As versões do grupo são exibidas na guia **Implantações** do grupo.

1. <a name="copy-group-id-latestversion"></a>Copie os valores `Id` e `LatestVersion` do grupo de destino na saída.

1. <a name="get-latest-group-version"></a>Obtenha a versão do grupo mais recente.
   + Substitua *group-id* pelo `Id` que você copiou.
   + Substitua *latest-group-version-id* pelo `LatestVersion` que você copiou.

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

1. `FunctionDefinitionVersionArn`Na saída, obtenha a definição IDs da função e a versão da definição da função.
   + O ID de definição de função é o GUID que segue o segmento `functions` no nome do recurso da Amazon (ARN).
   + O ID de versão de definição de função é o GUID que segue o segmento `versions` no ARN.

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

1. Obtenha o ID da versão de definição de função.
   + *function-definition-id*Substitua pelo ID da definição da função.
   + *function-definition-version-id*Substitua pelo ID da versão da definição da função.

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

Se a matriz `functions` na saída incluir a função `GGStreamManager`, o gerenciador de fluxo será habilitado. Quaisquer variáveis de ambiente definidas para a função representam configurações personalizadas para o gerenciador de fluxo.

### Habilitar, desabilitar ou definir as configurações do gerenciador de fluxo (CLI)
<a name="enable-stream-manager-cli"></a>

No AWS CLI, use a função `GGStreamManager` Lambda do sistema para configurar o gerenciador de streams. As alterações entrarão em vigor após a implantação do grupo.
+ Para habilitar o gerenciador de fluxo, inclua `GGStreamManager` na matriz `functions` da sua versão de definição de função. Para definir configurações personalizadas, defina variáveis de ambiente para os [parâmetros correspondentes do gerenciador de fluxo](#stream-manager-parameters).
+ Para desabilitar o gerenciador de fluxo, remova `GGStreamManager` da matriz `functions` da sua versão de definição de função.

** gerenciador de fluxo com configurações padrão**  
O exemplo de configuração a seguir habilita o gerenciador de fluxo com configurações padrão. Ele define o ID da função arbitrária como `streamManager`.  

```
{
    "FunctionArn": "arn:aws:lambda:::function:GGStreamManager:1",
    "FunctionConfiguration": {
        "MemorySize": 4194304,
        "Pinned": true,
        "Timeout": 3
    },
    "Id": "streamManager"
}
```
Para as propriedades `FunctionConfiguration`, talvez você saiba o seguinte:  
+ `MemorySize` está definido para 4194304 KB (4 GB) com as configurações padrão. Sempre há a possibilidade de alterar esse valor. É recomendável definir o `MemorySize` para pelo menos 128000 KB.
+ `Pinned` deve ser definido como `true`.
+ O `Timeout` é exigido pela versão de definição de função, mas o `GGStreamManager` não o utiliza.

** gerenciador de fluxo com configurações personalizadas**  <a name="enable-stream-manager-custom-settings"></a>
O exemplo de configuração a seguir habilita o gerenciador de fluxo com os valores personalizados para o diretório de armazenamento, a porta do servidor e os parâmetros de tamanho do grupo de threads.  

```
{
    "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 usa valores padrão para [parâmetros do gerenciador de fluxo](#stream-manager-parameters) que não são especificados como variáveis de ambiente.

**Gerenciador de fluxo com configurações personalizadas para exportações do Amazon S3**  <a name="enable-stream-manager-custom-settings-s3"></a>
O exemplo de configuração a seguir habilita o gerenciador de fluxo com valores personalizados para o diretório de upload e com parâmetros mínimos de tamanho de upload de várias partes.  

```
{
    "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"
}
```

 

**Habilitar, desabilitar ou definir as configurações do gerenciador de fluxo (CLI)**

1. <a name="get-group-id-latestversion"></a>Obtenha a versão IDs do grupo-alvo do Greengrass e do grupo. Esse procedimento pressupõe que esse seja o grupo e a versão mais recente do grupo. A consulta a seguir retorna o grupo criado mais recentemente.

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

   Ou é possível consultar por nome. Os nomes de grupo não precisam ser exclusivos, portanto, vários grupos podem ser retornados.

   ```
   aws greengrass list-groups --query "Groups[?Name=='MyGroup']"
   ```
**nota**  
<a name="find-group-ids-console"></a>Você também pode encontrar esses valores no AWS IoT console. O ID do grupo é exibido na página **Settings (Configurações)** do grupo. IDs As versões do grupo são exibidas na guia **Implantações** do grupo.

1. <a name="copy-group-id-latestversion"></a>Copie os valores `Id` e `LatestVersion` do grupo de destino na saída.

1. <a name="get-latest-group-version"></a>Obtenha a versão do grupo mais recente.
   + Substitua *group-id* pelo `Id` que você copiou.
   + Substitua *latest-group-version-id* pelo `LatestVersion` que você copiou.

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

1. Copie a `CoreDefinitionVersionArn` e todas as outras versões ARNs da saída, exceto`FunctionDefinitionVersionArn`. Você usa esses valores ao criar uma nova versão do grupo.

1. <a name="parse-function-def-id"></a>No `FunctionDefinitionVersionArn` na saída, copie o ID da definição de função. O ID é o GUID que segue o segmento `functions` no ARN, conforme mostrado no exemplo a seguir.

   ```
   arn:aws:greengrass:us-west-2:123456789012:/greengrass/definition/functions/bcfc6b49-beb0-4396-b703-6dEXAMPLEcu5/versions/0f7337b4-922b-45c5-856f-1aEXAMPLEsf6
   ```
**nota**  
Ou você pode criar uma definição de função executando o comando [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) e copiar o ID da saída.

1. <a name="enable-stream-manager-function-definition-version"></a>Adicione uma versão de definição de função à definição da função.
   + *function-definition-id*Substitua pelo `Id` que você copiou para a definição da função.
   + Na matriz `functions`, inclua todas as outras funções que você deseja disponibilizar no núcleo do Greengrass. Você pode usar o comando `get-function-definition-version` para obter a lista de funções existentes.

      
**Habilitar o gerenciador de fluxo com configurações padrão**  
O exemplo a seguir habilita o gerenciador de fluxo, incluindo a função `GGStreamManager`, na matriz `functions`. Este exemplo usa valores padrão para os [parâmetros do gerenciador de fluxo](#stream-manager-parameters).  

   ```
   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
       ]
   }'
   ```
A função `myLambdaFunction` nos exemplos representa uma de suas funções do Lambda definidas pelo usuário.  
**Habilitar o gerenciador de fluxo com configurações personalizadas**  
O exemplo a seguir habilita o gerenciador de fluxo, incluindo a função `GGStreamManager`, na matriz `functions`. Todas as configurações do gerenciador de fluxo são opcionais, a menos que você queira alterar os valores padrão. Este exemplo mostra como usar variáveis de ambiente para definir valores personalizados.  

   ```
   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
       ]
   }'
   ```
Para as propriedades `FunctionConfiguration`, talvez você saiba o seguinte:  
   + `MemorySize` está definido para 4194304 KB (4 GB) com as configurações padrão. Sempre há a possibilidade de alterar esse valor. É recomendável definir o `MemorySize` para pelo menos 128000 KB.
   + `Pinned` deve ser definido como `true`.
   + O `Timeout` é exigido pela versão de definição de função, mas o `GGStreamManager` não o utiliza.  
**Desabilitar o gerenciador de fluxo**  
O exemplo a seguir omite a função `GGStreamManager`, que desabilita o gerenciador de fluxo.  

   ```
   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
       ]
   }'
   ```
Se não quiser implantar nenhuma função do Lambda, você poderá omitir completamente a versão de definição de função.

1. <a name="copy-function-def-version-arn"></a>Copie o `Arn` da versão da definição de função da saída.

1. <a name="create-group-version-with-sys-lambda"></a>Crie uma versão do grupo que contém a função do Lambda definida pelo sistema.
   + *group-id*Substitua `Id` pelo para o grupo.
   + *core-definition-version-arn*Substitua pelo `CoreDefinitionVersionArn` que você copiou da versão mais recente do grupo.
   + *function-definition-version-arn*Substitua pelo `Arn` que você copiou para a nova versão de definição de função.
   + Substitua o ARNs por outros componentes do grupo (por exemplo, `SubscriptionDefinitionVersionArn` ou`DeviceDefinitionVersionArn`) que você copiou da versão mais recente do grupo.
   + Remova todos os parâmetros inutilizados. Por exemplo, remova a versão `--resource-definition-version-arn` caso a versão do grupo não contenha recursos.

   ```
   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>Copie a `Version` da saída. Este é o ID da nova versão do grupo.

1. <a name="create-group-deployment"></a>Implante o grupo com a nova versão do grupo.
   + *group-id*Substitua pelo `Id` que você copiou para o grupo.
   + *group-version-id*Substitua pelo `Version` que você copiou para a nova versão do grupo.

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

 

Siga este procedimento se quiser editar as configurações do gerenciador de fluxo posteriormente. Assegure-se de criar uma versão de definição de função que inclua a função do `GGStreamManager` com a configuração atualizada. A versão do grupo deve fazer referência a todas as versões do componente ARNs que você deseja implantar no núcleo. As alterações entrarão em vigor após a implantação do grupo.

## Consulte também
<a name="configure-stream-manager-see-also"></a>
+ [Gerencie fluxos de dados no núcleo AWS IoT Greengrass](stream-manager.md)
+ [Use StreamManagerClient para trabalhar com streams](work-with-streams.md)
+ [Configurações de exportação para destinos compatíveis Nuvem AWS](stream-export-configurations.md)
+ [Exportar fluxos de dados para o Nuvem AWS (console)](stream-manager-console.md)
+ [Exportar fluxos de dados para o Nuvem AWS (CLI)](stream-manager-cli.md)