

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 destinos AWS IoT SiteWise do Edge
<a name="destinations-manage"></a>

Depois de adicionar destinos, você pode realizar várias operações para gerenciá-los, como editar configurações de destino, excluir destinos e gerenciar filtros de caminho.

## Editar um destino
<a name="destinations-edit"></a>

Selecione o botão de rádio ao lado do destino na tabela e escolha o botão **Editar** para editar um destino.

------
#### [ Console ]

**Para editar um destino usando o AWS IoT SiteWise console**

1. Abra o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Na navegação à esquerda, escolha **Gateways Edge** na seção **Edge**.

1. Selecione o gateway apropriado.

1. Na seção **Destinos**, escolha o destino que você deseja editar e escolha **Editar**.

1. Modifique o destino e escolha **Salvar**.

------
#### [ AWS CLI ]

**Para editar um destino usando AWS CLI**
+ Você pode editar um destino modificando as informações de configuração do recurso JSON.

  ```
  aws iotsitewise update-gateway-capability-configuration \
  --gateway-id your-gateway-id \
  --capability-namespace "iotsitewise:publisher:3" \
  --capability-configuration '{
      "sources": [
          {
              "type": "MQTT"
          }
      ],
      "destinations": [
          {
              "id": "your-existing-destination-id",
              "type": "SITEWISE_REALTIME",
              "name": "your-updated-destination-name",
              "config": {
                  "publishingOrder": "TIME_ORDER",
                  "enableCompression": true,
                  "dropPolicy": {
                      "cutoffAge": "10d",
                      "exportPolicy": {
                          "retentionPeriod": "10d",
                          "rotationPeriod": "6h",
                          "exportSizeLimitGB": 10
                      }
                  },
                  "maxBatchWaitTime": "15s"
              },
              "filters": [
                  {
                    ...
                  }
              ]
          }
      ]
  }'
  ```

**nota**  
Você não pode atualizar o destino `type` ou`capability-namespace`. Por exemplo, você não pode mudar de um tipo de `SITEWISE_REALTIME` para`SITEWISE_BUFFERED`. Você pode ter um destino em tempo real para cada gateway habilitado para MQTT.

------

## Excluir um destino
<a name="destinations-delete"></a>

Se você não precisar mais de um destino, poderá excluí-lo do seu gateway SiteWise Edge.

------
#### [ Console ]

**Para excluir um destino usando o AWS IoT SiteWise console**

1. Abra o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Na navegação à esquerda, escolha **Gateways Edge** na seção **Edge**.

1. Selecione o gateway apropriado.

1. Na seção **Destinos**, escolha o destino que você deseja excluir e escolha **Excluir**. Uma tela de confirmação é exibida.

1. Para confirmar sua escolha de excluir o destino, digite “excluir” na caixa de confirmação.

------
#### [ AWS CLI ]

**Para excluir um destino usando AWS CLI**
+ Exclua a configuração do recurso do gateway especificando o ID do gateway e modificando a configuração do recurso para remover o destino que você deseja excluir.

  ```
  aws iotsitewise update-gateway-capability-configuration \
    --gateway-id your-gateway-id \
    --capability-namespace "iotsitewise:publisher:3" \
    --capability-configuration '{
      "sources": [
          {
              "type": "MQTT"
          }
      ],
      "destinations": []
  }'
  ```

**nota**  
A matriz de destinos pode estar vazia (`[]`), mas o próprio objeto de destinos deve ser incluído na configuração do recurso.

------

## Baixe todos os filtros de caminho em um destino (console)
<a name="destinations-download-list"></a>

Baixe um arquivo CSV contendo todos os seus filtros de caminho no AWS IoT SiteWise console. Você pode usar uma lista baixada de filtros de caminho para compartilhar facilmente listas de filtros de caminho entre destinos de gateway.

**Para baixar um arquivo CSV de todos os filtros de caminho usando o console AWS IoT SiteWise**

1. Abra o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Na navegação à esquerda, escolha **Gateways Edge** na seção **Edge**.

1. Selecione o gateway que contém seus filtros de caminho.

1. Escolha **Adicionar destino** ou **Editar destino**.

1. Navegue até a seção **Filtros de caminho** e escolha **Baixar CSV**.

**nota**  
O arquivo CSV inclui todos os filtros de caminho em um destino específico, independentemente de quais você selecionou na lista de filtros de caminho.

## Editar um filtro de caminho
<a name="destinations-edit-path-filter"></a>

Você pode editar filtros de caminho individuais para refinar quais dados seu destino recebe.

------
#### [ Console ]

Usando o AWS IoT SiteWise console, você pode editar cada filtro de caminho individual em cada caixa de texto respectiva.

**Para editar um filtro de caminho usando o AWS IoT SiteWise console**

1. Abra o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Na navegação à esquerda, escolha **Gateways Edge** na seção **Edge**.

1. Selecione o gateway que contém seus filtros de caminho.

1. Selecione o destino apropriado.

1. Escolha **Editar**.

1. Escolha a caixa de texto para a linha que contém o filtro de caminho que você deseja editar.

1. Atualize o texto do filtro de caminho, garantindo que a caixa de seleção do filtro de caminho editado esteja marcada.

1. Escolha **Salvar**.

------
#### [ AWS CLI ]

Para editar filtros de caminho para um destino usando o AWS CLI, primeiro recupere a configuração atual, modifique-a e, em seguida, atualize-a usando o `update-gateway-capability-configuration` comando.

**Para editar um filtro de caminho usando AWS CLI**

1. Recupere a configuração de capacidade atual:

   ```
   aws iotsitewise describe-gateway-capability-configuration \
     --gateway-id your-gateway-id \
     --capability-namespace "iotsitewise:publisher:3" \
     --query "capabilityConfiguration"
   ```

1. Edite o JSON para modificar os filtros de caminho conforme necessário.

1. Atualize a configuração do recurso com os filtros de caminho modificados:

   ```
   aws iotsitewise update-gateway-capability-configuration \
     --gateway-id your-gateway-id \
     --capability-namespace "iotsitewise:publisher:3" \
     --capability-configuration json-containing-your-updated-path-filters
   ```

------

## Excluir um filtro de caminho
<a name="destinations-delete-path-filter"></a>

Você pode excluir filtros de caminho de um destino para controlar os dados que ele recebe das fontes do MQTT e dos pipelines de processamento de dados.

------
#### [ Console ]

**Para excluir um filtro de caminho usando o AWS IoT SiteWise console**

1. Abra o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Na navegação à esquerda, escolha **Gateways Edge** na seção **Edge**.

1. Selecione o gateway que contém seus filtros de caminho.

1. Selecione o destino apropriado.

1. Escolha **Editar**.

1. Na tela **Editar destino**, na seção **Filtros de caminho**, selecione um ou mais filtros de caminho a serem excluídos.

1. Escolha **Excluir**. Uma mensagem de confirmação de exclusão é exibida. Se quiser continuar com a exclusão dos filtros de caminho, escolha **Excluir** na tela de confirmação.

------
#### [ AWS CLI ]

**Para excluir um destino usando AWS CLI**
+ Exclua um filtro de caminho removendo-o da configuração do recurso.

  ```
  aws iotsitewise update-gateway-capability-configuration \
    --gateway-id your-gateway-id \
    --capability-namespace "iotsitewise:publisher:3" \
    --capability-configuration '{
      "sources": [
          {
              "type": "MQTT"
          }
      ],
      "destinations": [
          {
              "id": "your-destination-id",
              "type": "SITEWISE_REALTIME",
              "name": "your-destination-name",
              "config": {
                  ...
              },
              "filters": [
                  {
                      "type": "PATH",
                      "config": {
                          "paths": [
                              "/path1",
                              "/path2",
                              "/delete-a-path-to-remove-it"
                          ]
                      }
                  }
              ]
          }
      ]
  }
  ```

**nota**  
A matriz de filtros pode estar vazia (`[]`), mas o próprio objeto de filtros deve ser incluído na configuração do recurso.

------