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

# Gerenciar endpoints do dispositivo principal do
<a name="manage-core-device-endpoints"></a>

Ao usar a descoberta na nuvem, você armazena os endpoints do agente MQTT para dispositivos principais no serviço de AWS IoT Greengrass nuvem. Os dispositivos cliente se conectam AWS IoT Greengrass para recuperar esses endpoints e outras informações para seus dispositivos principais associados.

Para cada dispositivo principal, você pode gerenciar endpoints automática ou manualmente.
+ **Gerencie terminais automaticamente com detector de IP**

  É possível implantar o [componente detector de IP](ip-detector-component.md) para gerenciar automaticamente os endpoints do dispositivo principal se tiver uma configuração de rede não complexa, como quando os dispositivos cliente estão na mesma rede do dispositivo principal. Você não pode usar o componente detector de IP se o dispositivo principal estiver atrás de um roteador que encaminha a porta do agente MQTT para o dispositivo principal, por exemplo.

  O componente detector de IP também é útil se você implantar em grupos de coisas, porque ele gerencia os endpoints de todos os dispositivos principais do grupo de coisas. Para obter mais informações, consulte [Use o detector de IP para gerenciar automaticamente os endpoints](#use-ip-detector).
+ **Gerencie manualmente os endpoints**

  Se você não puder usar o componente detector de IP, deverá gerenciar manualmente os endpoints principais do dispositivo. É possível atualizar esses endpoints com o console da ou a API da. Para obter mais informações, consulte [Gerenciar endpoints manualmente](#manually-manage-endpoints).

**Topics**
+ [Use o detector de IP para gerenciar automaticamente os endpoints](#use-ip-detector)
+ [Gerenciar endpoints manualmente](#manually-manage-endpoints)

## Use o detector de IP para gerenciar automaticamente os endpoints
<a name="use-ip-detector"></a>

Se você tiver uma configuração de rede simples, como os dispositivos cliente na mesma rede do dispositivo principal, poderá implantar o [componente detector de IP](ip-detector-component.md) para fazer o seguinte:
+ Monitore as informações de conectividade de rede local do dispositivo principal do Greengrass. Essas informações incluem os endpoints de rede do dispositivo principal e a porta em que o agente MQTT opera.
+ Relate as informações de conectividade do dispositivo principal ao serviço de AWS IoT Greengrass nuvem.

O componente detector de IP substitui os endpoints que você define manualmente.

**Importante**  
A AWS IoT política do dispositivo principal deve permitir a `greengrass:UpdateConnectivityInfo` permissão para usar o componente detector de IP. Para obter mais informações, consulte [AWS IoT políticas para operações de plano de dados](device-auth.md#iot-policies) e [Configure a política da AWS IoT coisa](connect-client-devices.md#configure-iot-policy-requirement).

É possível executar uma das seguintes ações para implantar o componente detector de IP:
+ Usar a página **Configurar a descoberta** no console. Para obter mais informações, consulte [Configurar a descoberta na nuvem (console)](connect-client-devices.md#configure-cloud-discovery-console).
+ Criar e revisar as implantações para incluir o detector de IP. Você pode usar o console ou AWS CLI a AWS API para gerenciar implantações. Para obter mais informações, consulte [Criar implantações](create-deployments.md).

### Implantar o componente detector de IP (console)
<a name="deploy-ip-detector-console"></a>

1. No menu de navegação do [console do AWS IoT Greengrass](https://console.aws.amazon.com/greengrass), selecione **Componentes**.

1. Na página **Componentes**, escolha a guia **Componentes públicos** e **aws.greengrass.clientdevices.IPDetector**.

1. Na página **aws.greengrass.clientdevices.IPDetector**, escolha **Implantar**.

1. <a name="deploy-component-choose-deployment-step"></a>Em **Adicionar à implantação**, escolha uma implantação existente para revisar ou opte por criar uma nova e, em seguida, escolha **Avançar**.

1. <a name="deploy-component-choose-target-step"></a>Se você criar uma nova implantação, escolha o dispositivo principal ou grupo de objetos de destino para ela. Na página **Especificar destino**, em **Destino de implantação**, escolha um dispositivo principal ou grupo de objetos e, depois, **Avançar**.

1. Na página **Selecionar componentes**, verifique se o componente **aws.greengrass.clientdevices.IPDetector** está selecionado e escolha **Avançar**.

1. Na página **Configurar componentes**, selecione **aws.greengrass.clientdevices.IPDetector** e faça o seguinte:

   1. Escolha **Configurar componente**.

   1. No modal **Configurar aws.greengrass.clientdevices.IPDetector**, em **Atualização de configuração**, em **Configuração para mesclar**, você pode inserir uma atualização de configuração para configurar o componente do detector de IP. É possível especificar uma das seguintes opções de configuração:
      + `defaultPort` (opcional): <a name="ip-detector-component-configuration-default-port-definition"></a>a porta do agente MQTT para relatar quando esse componente detecta endereços IP. É necessário especificar esse parâmetro se configurar o agente MQTT para usar uma porta diferente da porta padrão 8883. 
      + `includeIPv4LoopbackAddrs`— <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>(Opcional) Você pode ativar essa opção para detectar e relatar endereços de IPv4 loopback. Esses são endereços IP, como, por exemplo, `localhost`, em que um dispositivo pode se comunicar consigo mesmo. Use essa opção em ambientes de teste em que o dispositivo principal e o dispositivo cliente são executados no mesmo sistema. 
      + `includeIPv4LinkLocalAddrs`— <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(Opcional) Você pode ativar essa opção para detectar e relatar endereços IPv4 [locais de links](https://en.wikipedia.org/wiki/Link-local_address). Use essa opção se a rede do dispositivo principal não tiver o Protocolo de Configuração Dinâmica de Host (DHCP) ou endereços IP atribuídos estaticamente. 
      + `includeIPv6LoopbackAddrs`— <a name="ip-detector-component-configuration-include-ipv6-loopback-addrs-definition"></a>(Opcional) Você pode ativar essa opção para detectar e relatar endereços de IPv6 loopback. Esses são endereços IP, como, por exemplo, `localhost`, em que um dispositivo pode se comunicar consigo mesmo. Use essa opção em ambientes de teste em que o dispositivo principal e o dispositivo cliente são executados no mesmo sistema. É necessário definir `includeIPv4Addrs` como `false` e `includeIPv6Addrs` como `true` para usar essa opção. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.
      + `includeIPv6LinkLocalAddrs`— <a name="ip-detector-component-configuration-include-ipv6-link-local-addrs-definition"></a>(Opcional) Você pode ativar essa opção para detectar e relatar endereços IPv6 [locais de links](https://en.wikipedia.org/wiki/Link-local_address). Use essa opção se a rede do dispositivo principal não tiver o Protocolo de Configuração Dinâmica de Host (DHCP) ou endereços IP atribuídos estaticamente. É necessário definir `includeIPv4Addrs` como `false` e `includeIPv6Addrs` como `true` para usar essa opção. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.
      + `includeIPv4Addrs` (opcional): <a name="ip-detector-component-configuration-include-ipv4-addrs-definition"></a>o padrão é definido como verdadeiro. Você pode ativar essa opção para publicar IPv4 endereços encontrados no dispositivo principal. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.
      + `includeIPv6Addrs`— <a name="ip-detector-component-configuration-include-ipv6-addrs-definition"></a>(Opcional) Você pode ativar essa opção para publicar IPv6 endereços encontrados no dispositivo principal. Defina `includeIPv4Addrs` como `false` para usar essa opção. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.

      A atualização de configuração pode ser semelhante ao exemplo a seguir.

      ```
      {
        "defaultPort": "8883",
        "includeIPv4LoopbackAddrs": false,
        "includeIPv4LinkLocalAddrs": false
      }
      ```

   1. Escolha **Confirmar** para fechar o modal e, em seguida, escolha **Avançar**.

1. <a name="deploy-component-configure-advanced-settings-step"></a>Na página **Definir configurações avançadas**, mantenha as configurações padrão e escolha **Avançar**.

1. <a name="deploy-component-review-and-deploy-step"></a>Na página **Pré-visualizar**, escolha **Implantar**.

   A implantação pode levar até um minuto para ser concluída.

### Implantar o componente detector de IP (AWS CLI)
<a name="deploy-ip-detector-cli"></a>

Para implantar o componente detector de IP, crie um documento de implantação que inclua `aws.greengrass.clientdevices.IPDetector` no objeto `components` e especifique a atualização de configuração do componente. Siga as instruções em [Criar implantações](create-deployments.md) para criar uma nova implantação ou revisar uma existente.

É possível especificar qualquer uma das seguintes opções para configurar o componente detector de IP ao criar o documento de implantação:
+ `defaultPort` (opcional): <a name="ip-detector-component-configuration-default-port-definition"></a>a porta do agente MQTT para relatar quando esse componente detecta endereços IP. É necessário especificar esse parâmetro se configurar o agente MQTT para usar uma porta diferente da porta padrão 8883. 
+ `includeIPv4LoopbackAddrs`— <a name="ip-detector-component-configuration-include-ipv4-loopback-addrs-definition"></a>(Opcional) Você pode ativar essa opção para detectar e relatar endereços de IPv4 loopback. Esses são endereços IP, como, por exemplo, `localhost`, em que um dispositivo pode se comunicar consigo mesmo. Use essa opção em ambientes de teste em que o dispositivo principal e o dispositivo cliente são executados no mesmo sistema. 
+ `includeIPv4LinkLocalAddrs`— <a name="ip-detector-component-configuration-include-ipv4-link-local-addrs-definition"></a>(Opcional) Você pode ativar essa opção para detectar e relatar endereços IPv4 [locais de links](https://en.wikipedia.org/wiki/Link-local_address). Use essa opção se a rede do dispositivo principal não tiver o Protocolo de Configuração Dinâmica de Host (DHCP) ou endereços IP atribuídos estaticamente. 
+ `includeIPv6LoopbackAddrs`— <a name="ip-detector-component-configuration-include-ipv6-loopback-addrs-definition"></a>(Opcional) Você pode ativar essa opção para detectar e relatar endereços de IPv6 loopback. Esses são endereços IP, como, por exemplo, `localhost`, em que um dispositivo pode se comunicar consigo mesmo. Use essa opção em ambientes de teste em que o dispositivo principal e o dispositivo cliente são executados no mesmo sistema. É necessário definir `includeIPv4Addrs` como `false` e `includeIPv6Addrs` como `true` para usar essa opção. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.
+ `includeIPv6LinkLocalAddrs`— <a name="ip-detector-component-configuration-include-ipv6-link-local-addrs-definition"></a>(Opcional) Você pode ativar essa opção para detectar e relatar endereços IPv6 [locais de links](https://en.wikipedia.org/wiki/Link-local_address). Use essa opção se a rede do dispositivo principal não tiver o Protocolo de Configuração Dinâmica de Host (DHCP) ou endereços IP atribuídos estaticamente. É necessário definir `includeIPv4Addrs` como `false` e `includeIPv6Addrs` como `true` para usar essa opção. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.
+ `includeIPv4Addrs` (opcional): <a name="ip-detector-component-configuration-include-ipv4-addrs-definition"></a>o padrão é definido como verdadeiro. Você pode ativar essa opção para publicar IPv4 endereços encontrados no dispositivo principal. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.
+ `includeIPv6Addrs`— <a name="ip-detector-component-configuration-include-ipv6-addrs-definition"></a>(Opcional) Você pode ativar essa opção para publicar IPv6 endereços encontrados no dispositivo principal. Defina `includeIPv4Addrs` como `false` para usar essa opção. É necessário ter o detector de IP versão 2.2.0 ou mais recente para usar essa opção.

O exemplo de documento de implantação parcial a seguir especifica o relatório da porta 8883 como a porta do agente MQTT.

```
{
  ...,
  "components": {
    ...,
    "aws.greengrass.clientdevices.IPDetector": {
      "componentVersion": "2.1.1",
      "configurationUpdate": {
        "merge": "{\"defaultPort\":\"8883\",}"
      }
    }
  }
}
```

## Gerenciar endpoints manualmente
<a name="manually-manage-endpoints"></a>

É possível gerenciar manualmente os endpoints do agente MQTT para os dispositivos principais.

Cada endpoint do agente MQTT tem as seguintes informações:

**Endpoint** (`HostAddress`)  
Um endereço IP ou endereço DNS em que os dispositivos clientes podem se conectar a um agente MQTT no dispositivo principal.

**Porta** (`PortNumber`)  
A porta em que o agente MQTT opera no dispositivo principal.  
É possível configurar essa porta no [componente de agente Moquette MQTT](mqtt-broker-moquette-component.md), cujo padrão é usar a porta 8883.

**Metadados** (`Metadata`)  
Metadados adicionais a serem fornecidos aos dispositivos clientes que se conectam a esse endpoint.

**Topics**
+ [Gerenciar endpoints (console)](#manually-manage-endpoints-console)
+ [Gerenciar endpoints (AWS CLI)](#manually-manage-endpoints-cli)
+ [Gerenciar endpoints (API)](#manually-manage-endpoints-api)

### Gerenciar endpoints (console)
<a name="manually-manage-endpoints-console"></a>

Você pode usar o AWS IoT Greengrass console para visualizar, atualizar e remover endpoints de um dispositivo principal.

**Para gerenciar endpoints para um dispositivo principal (console)**

1. <a name="navigate-greengrass-console"></a>Navegue até o [console do AWS IoT Greengrass](https://console.aws.amazon.com/greengrass).

1. Escolha **Dispositivos principais**.

1. Escolha o dispositivo principal a ser gerenciado.

1. Na página de detalhes do dispositivo principal, escolha a guia **Dispositivos clientes**.

1. Na seção de **endpoints do agente MQTT**, você pode ver os endpoints do agente MQTT do dispositivo principal. Escolha **Gerenciar endpoints**.

1. No modal **Gerenciar endpoints**, adicione ou remova os endpoints do agente MQTT para o dispositivo principal.

1. Selecione **Atualizar**.

### Gerenciar endpoints (AWS CLI)
<a name="manually-manage-endpoints-cli"></a>

Você pode usar o AWS Command Line Interface (AWS CLI) para gerenciar endpoints de um dispositivo principal.

**nota**  
Como o suporte ao dispositivo cliente AWS IoT Greengrass V2 é compatível com versões anteriores AWS IoT Greengrass V1, você pode usar AWS IoT Greengrass V2 nossas operações de AWS IoT Greengrass V1 API para gerenciar os endpoints principais do dispositivo.

**Para obter endpoints para um dispositivo principal (AWS CLI)**
+ Use um dos comandos a seguir:
  + [greengrass v2: get-connectivity-info](https://docs.aws.amazon.com/cli/latest/reference/greengrassv2/get-connectivity-info.html)
  + [capim verde: get-connectivity-info](https://docs.aws.amazon.com/cli/latest/reference/greengrass/get-connectivity-info.html)

**Para atualizar os endpoints de um dispositivo principal (AWS CLI)**
+ Use um dos comandos a seguir:
  + [greengrass v2: update-connectivity-info](https://docs.aws.amazon.com/cli/latest/reference/greengrassv2/update-connectivity-info.html)
  + [capim verde: update-connectivity-info](https://docs.aws.amazon.com/cli/latest/reference/greengrass/update-connectivity-info.html)

### Gerenciar endpoints (API)
<a name="manually-manage-endpoints-api"></a>

Você pode usar a AWS API para gerenciar endpoints para um dispositivo principal.

**nota**  
Como o suporte ao dispositivo cliente AWS IoT Greengrass V2 é compatível com versões anteriores AWS IoT Greengrass V1, você pode usar AWS IoT Greengrass V2 nossas operações de AWS IoT Greengrass V1 API para gerenciar os endpoints principais do dispositivo.

**Para obter endpoints para um dispositivo principal (AWS API)**
+ Use uma das seguintes operações:
  + [V2: GetConnectivityInfo](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_GetConnectivityInfo.html)
  + [V1: GetConnectivityInfo](https://docs.aws.amazon.com/greengrass/v1/apireference/getconnectivityinfo-get.html)

**Para atualizar os endpoints de um dispositivo principal (AWS API)**
+ Use uma das seguintes operações:
  + [V2: UpdateConnectivityInfo](https://docs.aws.amazon.com/greengrass/v2/APIReference/API_UpdateConnectivityInfo.html)
  + [V1: UpdateConnectivityInfo](https://docs.aws.amazon.com/greengrass/v1/apireference/updateconnectivityinfo-put.html)