

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á.

# Roteador de assinatura legado
<a name="legacy-subscription-router-component"></a>

O roteador de assinatura antigo (`aws.greengrass.LegacySubscriptionRouter`) gerencia as assinaturas no dispositivo principal do Greengrass. As assinaturas são um recurso da AWS IoT Greengrass V1 que define os tópicos que as funções Lambda podem usar para mensagens MQTT em um dispositivo principal. Para obter mais informações, consulte [Assinaturas gerenciadas no fluxo de trabalho de mensagens MQTT](https://docs.aws.amazon.com/greengrass/v1/developerguide/gg-sec.html#gg-msg-workflow) no *Guia do desenvolvedor do AWS IoT Greengrass V1*.

Você pode usar esse componente para habilitar assinaturas para componentes de conectores e componentes da função Lambda que usam o SDK principal. AWS IoT Greengrass 

**nota**  <a name="legacy-subscription-router-requirement-note"></a>
O componente antigo do roteador de assinatura é necessário somente se sua função Lambda usar a `publish()` função no SDK AWS IoT Greengrass principal. Se você atualizar o código da função Lambda para usar a interface de comunicação entre processos (IPC) na AWS IoT Device SDK V2, não precisará implantar o componente legado do roteador de assinatura. Para obter mais informações, consulte os seguintes serviços de [comunicação entre processos](interprocess-communication.md):  
[Publicar/assinar mensagens locais](ipc-publish-subscribe.md)
[Publique/assine mensagens MQTT AWS IoT Core](ipc-iot-core-mqtt.md)

**Topics**
+ [Versões](#legacy-subscription-router-component-versions)
+ [Tipo](#legacy-subscription-router-component-type)
+ [Sistema operacional](#legacy-subscription-router-component-os-support)
+ [Requisitos](#legacy-subscription-router-component-requirements)
+ [Dependências](#legacy-subscription-router-component-dependencies)
+ [Configuração](#legacy-subscription-router-component-configuration)
+ [Arquivo de log local](#legacy-subscription-router-component-log-file)
+ [Changelog](#legacy-subscription-router-component-changelog)

## Versões
<a name="legacy-subscription-router-component-versions"></a>

Esse componente tem as seguintes versões:
+ 2.1.x
+ 2.0.x

## Tipo
<a name="legacy-subscription-router-component-type"></a>

<a name="public-component-type-generic"></a>Esse <a name="public-component-type-generic-phrase"></a>é um componente genérico (`aws.greengrass.generic`). O [Greengrass nucleus](greengrass-nucleus-component.md) executa os scripts do ciclo de vida do componente.

<a name="public-component-type-more-information"></a>Para obter mais informações, consulte [Tipos de componente](develop-greengrass-components.md#component-types).

## Sistema operacional
<a name="legacy-subscription-router-component-os-support"></a>

Esse componente pode ser instalado somente nos dispositivos principais do Linux.

## Requisitos
<a name="legacy-subscription-router-component-requirements"></a>

Esse componente tem os seguintes requisitos:
+ O roteador de assinatura legado tem suporte para ser executado em uma VPC.

## Dependências
<a name="legacy-subscription-router-component-dependencies"></a>

Quando você implanta um componente, AWS IoT Greengrass também implanta versões compatíveis de suas dependências. Isso significa que é preciso atender aos requisitos do componente e de todas as dependências dele para implantá-lo com êxito. Nesta seção, há uma lista de todas as dependências das [versões lançadas](#legacy-subscription-router-component-changelog) desse componente e as restrições de versão semântica que definem as versões dos componentes para cada dependência. Também é possível visualizar as dependências de cada versão do componente no [console do AWS IoT Greengrass](https://console.aws.amazon.com//greengrass). Na página de detalhes do componente, procure a lista de **dependências**.

------
#### [ 2.1.15 ]

A tabela a seguir lista as dependências da versão 2.1.15 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.0.0 <2.17.0 | Flexível | 

------
#### [ 2.1.14 ]

A tabela a seguir lista as dependências da versão 2.1.14 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.0.0 <2.16.0 | Flexível | 

------
#### [ 2.1.13 ]

A tabela a seguir lista as dependências da versão 2.1.13 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.0.0 <2.15.0 | Flexível | 

------
#### [ 2.1.12 ]

A seguinte tabela lista as dependências da versão 2.1.12 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.0.0 <2.14.0 | Flexível | 

------
#### [ 2.1.11 ]

A seguinte tabela lista as dependências da versão 2.1.11 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.0.0 <2.13.0 | Flexível | 

------
#### [ 2.1.10 ]

A tabela a seguir lista as dependências da versão 2.1.10 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.0.0 <2.12.0 | Flexível | 

------
#### [ 2.1.9 ]

A tabela a seguir lista as dependências da versão 2.1.9 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.0.0 <2.11.0 | Flexível | 

------
#### [ 2.1.8 ]

A tabela a seguir lista as dependências da versão 2.1.8 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.0.0 <2.10.0 | Flexível | 

------
#### [ 2.1.7 ]

A tabela a seguir lista as dependências da versão 2.1.7 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.0.0 <2.9.0 | Flexível | 

------
#### [ 2.1.6 ]

A tabela a seguir lista as dependências da versão 2.1.6 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.0.0 <2.8.0 | Flexível | 

------
#### [ 2.1.5 ]

A tabela a seguir lista as dependências da versão 2.1.5 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.0.0 <2.7.0 | Flexível | 

------
#### [ 2.1.4 ]

A tabela a seguir lista as dependências da versão 2.1.4 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.0.0 <2.6.0 | Flexível | 

------
#### [ 2.1.3 ]

A tabela a seguir lista as dependências da versão 2.1.3 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.0.0 <2.5.0 | Flexível | 

------
#### [ 2.1.2 ]

A tabela a seguir lista as dependências da versão 2.1.2 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.0.0 <2.4.0 | Flexível | 

------
#### [ 2.1.1 ]

A tabela a seguir lista as dependências da versão 2.1.1 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.0.0 <2.3.0 | Flexível | 

------
#### [ 2.1.0 ]

A tabela a seguir lista as dependências da versão 2.1.0 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.0.0 <2.2.0 | Flexível | 

------
#### [ 2.0.3 ]

A seguinte tabela lista as dependências da versão 2.0.3 desse componente.


| Dependência | Versões compatíveis | Tipo de dependência | 
| --- | --- | --- | 
| [Greengrass nucleus](greengrass-nucleus-component.md) | >=2.0.3 <2.1.0 | Flexível | 

------

Para obter mais informações sobre as dependências dos componentes, consulte [referência de fórmula do componente](component-recipe-reference.md#recipe-reference-component-dependencies).

## Configuração
<a name="legacy-subscription-router-component-configuration"></a>

Esse componente fornece os seguintes parâmetros de configuração que podem ser personalizados ao implantar o componente.

------
#### [ v2.1.x ]

`subscriptions`  
<a name="legacy-subscription-router-component-configuration-subscriptions-intro"></a>(Opcional) As assinaturas a serem ativadas no dispositivo principal. Esse é um objeto, em que cada chave é um ID exclusivo e cada valor é um objeto que define a assinatura desse conector. Você deve configurar uma assinatura ao implantar um componente de conector V1 ou uma função Lambda que usa AWS IoT Greengrass o SDK principal.  
Cada objeto de assinatura contém as seguintes informações:    
`id`  <a name="legacy-subscription-router-component-configuration-subscription-id"></a>
O ID exclusivo dessa assinatura. Esse ID deve corresponder à chave desse objeto de assinatura.  
`source`  
A função Lambda que usa o SDK AWS IoT Greengrass principal para publicar mensagens MQTT sobre os tópicos que você especifica em. `subject` Especifique um dos seguintes:  
+ <a name="legacy-subscription-router-component-configuration-subscription-source-target-component-name"></a>O nome de um componente da função do Lambda no dispositivo principal. Especifique o nome do componente com o prefixo `component:`, como **component:com.example.HelloWorldLambda**.
+ <a name="legacy-subscription-router-component-configuration-subscription-source-target-function-arn"></a>O nome do recurso da Amazon (ARN) de uma função do Lambda no dispositivo principal.
**Importante**  <a name="legacy-subscription-router-function-version-requirement"></a>
Se a versão da função do Lambda mudar, será necessário configurar a assinatura com a nova versão da função. Caso contrário, esse componente não roteará as mensagens até que a versão corresponda à assinatura.  
É necessário especificar um nome do recurso da Amazon (ARN) que inclua a versão da função a ser importada. Você não pode usar aliases de versão, como `$LATEST`.
Para implantar uma assinatura para um componente do conector V1, especifique o nome do componente ou o ARN da função do Lambda do componente do conector.  
`subject`  <a name="legacy-subscription-router-component-configuration-subscription-subject"></a>
O tópico ou filtro de tópicos do MQTT em que a fonte e o destino podem publicar e receber mensagens. Esse valor aceita os curingas de tópico `+` e `#`.  
`target`  
<a name="legacy-subscription-router-component-configuration-subscription-target-intro"></a>O destino que recebe as mensagens MQTT nos tópicos especificados em `subject`. A assinatura especifica que a `source` função publica mensagens MQTT em AWS IoT Core ou para uma função Lambda no dispositivo principal. Especifique um dos seguintes:  
+ <a name="legacy-subscription-router-component-configuration-subscription-target-cloud"></a>`cloud`. A `source` função publica mensagens MQTT para. AWS IoT Core
+ <a name="legacy-subscription-router-component-configuration-subscription-source-target-component-name"></a>O nome de um componente da função do Lambda no dispositivo principal. Especifique o nome do componente com o prefixo `component:`, como **component:com.example.HelloWorldLambda**.
+ <a name="legacy-subscription-router-component-configuration-subscription-source-target-function-arn"></a>O nome do recurso da Amazon (ARN) de uma função do Lambda no dispositivo principal.
**Importante**  <a name="legacy-subscription-router-function-version-requirement"></a>
Se a versão da função do Lambda mudar, será necessário configurar a assinatura com a nova versão da função. Caso contrário, esse componente não roteará as mensagens até que a versão corresponda à assinatura.  
É necessário especificar um nome do recurso da Amazon (ARN) que inclua a versão da função a ser importada. Você não pode usar aliases de versão, como `$LATEST`.
Padrão: sem assinaturas

**Example Exemplo de atualização de configuração (definindo uma assinatura para AWS IoT Core)**  
O exemplo a seguir especifica que o componente `com.example.HelloWorldLambda` da função Lambda publica a mensagem AWS IoT Core MQTT no tópico. `hello/world`  

```
{
  "subscriptions": {
    "Greengrass_HelloWorld_to_cloud": {
      "id": "Greengrass_HelloWorld_to_cloud",
      "source": "component:com.example.HelloWorldLambda",
      "subject": "hello/world",
      "target": "cloud"
    }
  }
}
```

**Example Exemplo de atualização de configuração (definindo uma assinatura para outra função do Lambda)**  
O exemplo a seguir especifica que o componente `com.example.HelloWorldLambda` da função do Lambda publica mensagens MQTT no componente da função do Lambda `com.example.MessageRelay` no tópico `hello/world`.  

```
{
  "subscriptions": {
    "Greengrass_HelloWorld_to_MessageRelay": {
      "id": "Greengrass_HelloWorld_to_MessageRelay",
      "source": "component:com.example.HelloWorldLambda",
      "subject": "hello/world",
      "target": "component:com.example.MessageRelay"
    }
  }
}
```

------
#### [ v2.0.x ]

`subscriptions`  
<a name="legacy-subscription-router-component-configuration-subscriptions-intro"></a>(Opcional) As assinaturas a serem ativadas no dispositivo principal. Esse é um objeto, em que cada chave é um ID exclusivo e cada valor é um objeto que define a assinatura desse conector. Você deve configurar uma assinatura ao implantar um componente de conector V1 ou uma função Lambda que usa AWS IoT Greengrass o SDK principal.  
Cada objeto de assinatura contém as seguintes informações:    
`id`  <a name="legacy-subscription-router-component-configuration-subscription-id"></a>
O ID exclusivo dessa assinatura. Esse ID deve corresponder à chave desse objeto de assinatura.  
`source`  
A função Lambda que usa o SDK AWS IoT Greengrass principal para publicar mensagens MQTT sobre os tópicos que você especifica em. `subject` Especifique o seguinte:  
+ <a name="legacy-subscription-router-component-configuration-subscription-source-target-function-arn"></a>O nome do recurso da Amazon (ARN) de uma função do Lambda no dispositivo principal.
**Importante**  <a name="legacy-subscription-router-function-version-requirement"></a>
Se a versão da função do Lambda mudar, será necessário configurar a assinatura com a nova versão da função. Caso contrário, esse componente não roteará as mensagens até que a versão corresponda à assinatura.  
É necessário especificar um nome do recurso da Amazon (ARN) que inclua a versão da função a ser importada. Você não pode usar aliases de versão, como `$LATEST`.
Para implantar uma assinatura para um componente do conector V1, especifique o ARN da função do Lambda do componente do conector.  
`subject`  <a name="legacy-subscription-router-component-configuration-subscription-subject"></a>
O tópico ou filtro de tópicos do MQTT em que a fonte e o destino podem publicar e receber mensagens. Esse valor aceita os curingas de tópico `+` e `#`.  
`target`  
<a name="legacy-subscription-router-component-configuration-subscription-target-intro"></a>O destino que recebe as mensagens MQTT nos tópicos especificados em `subject`. A assinatura especifica que a `source` função publica mensagens MQTT em AWS IoT Core ou para uma função Lambda no dispositivo principal. Especifique um dos seguintes:  
+ <a name="legacy-subscription-router-component-configuration-subscription-target-cloud"></a>`cloud`. A `source` função publica mensagens MQTT para. AWS IoT Core
+ <a name="legacy-subscription-router-component-configuration-subscription-source-target-function-arn"></a>O nome do recurso da Amazon (ARN) de uma função do Lambda no dispositivo principal.
**Importante**  <a name="legacy-subscription-router-function-version-requirement"></a>
Se a versão da função do Lambda mudar, será necessário configurar a assinatura com a nova versão da função. Caso contrário, esse componente não roteará as mensagens até que a versão corresponda à assinatura.  
É necessário especificar um nome do recurso da Amazon (ARN) que inclua a versão da função a ser importada. Você não pode usar aliases de versão, como `$LATEST`.
Padrão: sem assinaturas

**Example Exemplo de atualização de configuração (definindo uma assinatura para AWS IoT Core)**  
O exemplo a seguir especifica que a `Greengrass_HelloWorld` função publica a mensagem MQTT AWS IoT Core no tópico. `hello/world`  

```
"subscriptions": {
  "Greengrass_HelloWorld_to_cloud": {
    "id": "Greengrass_HelloWorld_to_cloud",
    "source": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:5",
    "subject": "hello/world",
    "target": "cloud"
  }
}
```

**Example Exemplo de atualização de configuração (definindo uma assinatura para outra função do Lambda)**  
O exemplo a seguir especifica que a função `Greengrass_HelloWorld` publica mensagens MQTT em `Greengrass_MessageRelay` no tópico `hello/world`.  

```
"subscriptions": {
  "Greengrass_HelloWorld_to_MessageRelay": {
    "id": "Greengrass_HelloWorld_to_MessageRelay",
    "source": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_HelloWorld:5",
    "subject": "hello/world",
    "target": "arn:aws:lambda:us-west-2:123456789012:function:Greengrass_MessageRelay:5"
  }
}
```

------

## Arquivo de log local
<a name="legacy-subscription-router-component-log-file"></a>

Esse componente não gera logs.

## Changelog
<a name="legacy-subscription-router-component-changelog"></a>

A tabela a seguir descreve as alterações em cada versão do componente.


|  Versão  |  Alterações  | 
| --- | --- | 
| 2.1.16 | Atualiza a versão do componente para a versão 2.17.0 do núcleo Greengrass. | 
| 2.1.15 | Versão atualizada para a versão 2.16.0 do Greengrass nucleus. | 
| 2.1.14 | Versão atualizada para o Greengrass nucleus versão 2.15.0. | 
| 2.1.13 | Versão atualizada para o Greengrass nucleus versão 2.14.0. | 
| 2.1.12 | Versão atualizada para o lançamento da versão 2.13.0 do núcleo do Greengrass. | 
| 2.1.11 | Versão atualizada para o núcleo do Greengrass 2.12.0. | 
| 2.1.10 | Versão atualizada para o lançamento da versão 2.11.0 do núcleo do Greengrass. | 
| 2.1.9 | Versão atualizada para o lançamento da versão 2.10.0 do núcleo do Greengrass. | 
| 2.1.8 | Versão atualizada para o Greengrass nucleus versão 2.9.0. | 
| 2.1.7 | Versão atualizada para o lançamento da versão 2.8.0 do núcleo do Greengrass. | 
| 2.1.6 | Versão atualizada para o lançamento da versão 2.7.0 do núcleo do Greengrass. | 
| 2.1.5 | Versão atualizada para o lançamento da versão 2.6.0 do núcleo do Greengrass. | 
| 2.1.4 | Versão atualizada para o lançamento da versão 2.5.0 do núcleo do Greengrass. | 
| 2.1.3 | Versão atualizada para o lançamento da versão 2.4.0 do núcleo do Greengrass. | 
| 2.1.2 | Versão atualizada para o lançamento da versão 2.3.0 do núcleo do Greengrass. | 
| 2.1.1 | Versão atualizada para o Greengrass nucleus versão 2.2.0. | 
| 2.1.0 |  <a name="changelog-legacy-subscription-router-2.1.0"></a>[See the AWS documentation website for more details](http://docs.aws.amazon.com/pt_br/greengrass/v2/developerguide/legacy-subscription-router-component.html)  | 
| 2.0.3 | Versão inicial. | 