

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

# Adicione filtros de caminho aos destinos AWS IoT SiteWise do Edge
<a name="destinations-add-path-filters"></a>

Adicione filtros de caminho a um destino. Os filtros de caminho usam a sintaxe de tópico do MQTT, onde `#` é um caractere curinga que corresponde a qualquer número de níveis e um `+` caractere curinga que corresponde a um único nível. Você pode adicionar vários destinos a um gateway, cada um com seu próprio conjunto de filtros de caminho inscritos na telemetria do seu equipamento.

Siemens Industrial Edgeos gateways usam um prefixo para compatibilidade. Para obter mais informações, consulte [Prefixos para filtros de caminho](sitewise-edge-on-siemens.md#siemens-path-filters).

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

**Para adicionar filtros de caminho**

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

1. No painel de navegação, escolha **Gateways de borda**.

1. Selecione o gateway ao qual você deseja adicionar filtros de caminho.

1. Na seção **Filtros de caminho**, em **Adicionar destino**, escolha **Adicionar filtro de caminho**.

1. Insira o filtro de caminho no qual você deseja que esse destino se inscreva. Você pode usar caracteres curinga (`#`e`+`) para se inscrever em vários caminhos.

1. Escolha **Adicionar filtro de caminho** para adicionar o filtro de caminho à lista.

1. Repita as etapas para adicionar filtros de caminho adicionais, se necessário.

1. Depois de adicionar todos os filtros de caminho necessários, escolha **Criar**.

------
#### [ AWS CLI for self-hosted gateways ]

**Example : Configuração do filtro de caminho**  

```
{
  "destinations": [
    {
      ...
    }
  ],
  "filters": [
    {
      "type": "PATH",
      "config": {
        "paths": [
          "home/+/sensor1/temperature",
          "home/livingroom/sensor1/temperature",
          "home/livingroom/sensor1/temperature",
          "building/#"
        ]
      }
    }
  ]
}
```

------
#### [ AWS CLI for Siemens IEgateways ]

**Example : Configuração de prefixo para filtros de caminho**  
Capture todos os dados usando os prefixos data (`ie/d`) e metadata (`ie/m`) para cada filtro de caminho.  

```
{
  "destinations": [
    {
      ...
    }
  ],
  "filters": [
    {
      "type": "PATH",
      "config": {
        "paths": [
          "ie/d/home/+/sensor12/temperature",
          "ie/m/home/livingroom/sensor12/temperature",
          "ie/d/home/livingroom/sensor13/temperature2",
          "ie/m/home/livingroom/sensor13/temperature2",
          "ie/d/building/#",
          "ie/m/building/#"
        ]
      }
    }
  ]
}
```

------

**nota**  
Copie filtros de caminho entre destinos baixando a lista de filtros de caminho. Para obter mais informações, consulte [Baixe todos os filtros de caminho em um destino (console)](destinations-manage.md#destinations-download-list).

## Carregue filtros de caminho em massa
<a name="destinations-path-filters-upload-file"></a>

Para fazer upload de filtros de caminho em massa, use um arquivo CSV ou de texto. AWS IoT SiteWise remove automaticamente as duplicatas exatas ao fazer upload de arquivos. Por exemplo, `windfarm/site1/` e `windfarm/site1/` são duplicatas exatas que são AWS IoT SiteWise capturadas porque a string é exatamente a mesma. As duplicatas parciais não são removidas e resultam em cobranças adicionais. Por exemplo, `windfarm/#` e `windfarm/site1` são tópicos sobrepostos porque já estão `windfarm/site1` abrangidos por. `windfarm/#`

**nota**  
Evite duplicatas para evitar cobranças adicionais. O arquivo carregado deve estar no formato.csv ou .txt. Ele não pode conter nenhum cabeçalho e deve consistir em uma única coluna. Na coluna, liste seus filtros de caminho, com cada filtro em uma linha separada. Nenhuma outra informação deve ser incluída no arquivo.

**Requisitos de upload de arquivos**

Esses são requisitos adicionais de filtro de caminho.
+ Você pode fazer upload de um arquivo.csv ou .txt. Arquivos em outros formatos não são compatíveis.
+ Os arquivos CSV (.csv) não podem ter cabeçalhos e devem conter apenas uma coluna.
+ Você pode ter um filtro de caminho em cada linha.
+ Os arquivos enviados não podem estar vazios.
+ Ao usar `#` como curinga, ele deve ser o último caractere no filtro de tópico. Por exemplo, `topic/#` ou como um caractere independente em um determinado nível de tópico. No entanto, observe que `#` também pode ser usado como um caractere regular em um nome de nível de tópico, como `factory/machine#1/topic`. Para obter mais informações, consulte [Caracteres especiais nos nomes dos filtros de caminho](gw-destinations.md#path-filters-special-characters)
  + Você também pode usar o `+` personagem. Por exemplo, use `factory/+/temp` para obter todas as temperaturas para fábricas em vez de `factory/machine2/temp` e `factory/machine3/temp` individualmente.