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á.
# Destinos e filtros de caminho
Os destinos no AWS IoT SiteWise Edge fornecem uma maneira flexível e eficiente de gerenciar como seus dados industriais fluem dos dispositivos de borda para a nuvem. Esta seção explica como configurar destinos, usar filtros de caminho para rotear fluxos de dados específicos e escolher o tipo de destino certo para seu caso de uso.
Você pode usar destinos e filtros de caminho em gateways V3 auto-hospedados habilitados para MQTT e gateways usados em conjunto com o aplicativo Edge hospedado em. AWS IoT SiteWise Siemens Industrial Edge Destinos e filtros de caminho não funcionam com o Classic Streams, gateways V2.
**Topics**
+ [AWS IoT SiteWise Entenda os destinos Edge](#source-destination)
+ [Entenda os filtros de caminho para destinos AWS IoT SiteWise do Edge](#destinations-path-filters)
+ [Adicione um destino em tempo real do AWS IoT SiteWise Edge](destinations-real-time.md)
+ [Adicione um destino em AWS IoT SiteWise buffer usando o Amazon S3](destinations-buffered.md)
+ [Adicione filtros de caminho aos destinos AWS IoT SiteWise do Edge](destinations-add-path-filters.md)
+ [Gerenciar destinos AWS IoT SiteWise do Edge](destinations-manage.md)
## AWS IoT SiteWise Entenda os destinos Edge
Use os destinos do AWS IoT SiteWise Edge para determinar para onde enviar seus dados de origem. Você pode escolher o destino dos dados com base nas características específicas de que precisa, como economia, baixa latência ou requisitos de armazenamento. Integre dados de dispositivos capturados por AWS IoT SiteWise nossos parceiros ou aplicativos personalizados para publicar e assinar filtros de caminho (tópicos) na borda. Em seguida, você pode modelar, transferir e armazenar os dados do seu dispositivo na nuvem.
**nota**
Para o uso total de todos os recursos de destino em gateways auto-hospedados, atualize para as versões mais recentes do editor de IoT SiteWise e do coletor IoT OPC UA. SiteWise O suporte de streaming continua em streams clássicos, gateways V2, para manter a compatibilidade com as configurações existentes. Para obter mais informações, consulte [Streams clássicos, gateways V2 para Edge AWS IoT SiteWise](classic-streams-v2-gateway.md).
**Topics**
+ [Como os destinos SiteWise Edge aprimoram o gerenciamento de dados](#how-destinations-work)
+ [Tipos de destino](#destination-types)
+ [Compare a funcionalidade de destino entre as versões do gateway](#destinations-vs-publisher-component)
+ [Limitações de destino](#destinations-limitiations)
+ [Casos de uso para destinos SiteWise Edge](#destinations-use-cases)
### Como os destinos SiteWise Edge aprimoram o gerenciamento de dados
Exporte dados da borda para AWS IoT SiteWise em tempo real ou em lotes usando o Amazon S3.
Os destinos aprimoram a flexibilidade e a escalabilidade em seu AWS IoT SiteWise ambiente. Os destinos implementam um modelo centralizado de gerenciamento de dados, em que as fontes publicam dados em um sistema central. Os destinos determinam para onde seus dados são enviados usando filtros de caminho. Os destinos podem se inscrever em vários filtros de caminho.
Os gateways habilitados para MQTT, sejam eles auto-hospedados ou em execuçãoSiemens Industrial Edge, usam o MQTT para comunicação local e vêm com um destino padrão em tempo real com filtros definidos como. `#` Isso significa que, por padrão, todas as mensagens em todos os tópicos são publicadas no destino AWS IoT SiteWise em tempo real. Para obter mais informações, consulte [Entenda os filtros de caminho para destinos AWS IoT SiteWise do EdgeUnderstand path filters](#destinations-path-filters). Você pode adicionar um destino em tempo real em cada gateway.
### Tipos de destino
Ao configurar um destino para seu gateway, você tem duas opções principais: configuração em tempo real usando AWS IoT SiteWise e uma configuração em buffer usando o Amazon S3. Cada tipo de destino tem seu próprio conjunto de configurações e considerações.
**AWS IoT SiteWise configurações em tempo real**
Escolha essa opção para enviar dados diretamente para o armazenamento AWS IoT SiteWise de camada ativa para facilitar a ingestão e o monitoramento de dados em tempo real. As configurações em tempo real gerenciam o fluxo de dados, principalmente quando um gateway enfrenta problemas de conectividade com a nuvem. Durante a perda da conexão, os dados são temporariamente armazenados localmente no gateway. Depois que a conexão é restabelecida, os dados armazenados são enviados automaticamente para a nuvem.
Você pode ajustar vários aspectos do processo de publicação de dados, como a quantidade máxima de dados a serem armazenados localmente, a taxa na qual os dados são enviados para a nuvem após a reconexão e quando excluí-los após o armazenamento atingir sua capacidade.
Para obter mais informações sobre níveis AWS IoT SiteWise de armazenamento, consulte,[Gerencie o armazenamento de dados em AWS IoT SiteWise](manage-data-storage.md).
**AWS IoT SiteWise armazenado em buffer usando as configurações do Amazon S3**
Esse tipo de destino permite que você armazene dados localmente no gateway e os envie periodicamente para um bucket do Amazon S3 em lotes. Os dados são armazenados no eficiente formato Parquet, que é otimizado para cargas de trabalho analíticas. Quando os dados estiverem no Amazon S3, você poderá importá-los AWS IoT SiteWise para armazenamento, processamento e análise.
Escolha essa opção para ingerir dados em lotes e armazenar dados históricos de forma econômica. Você pode configurar a localização preferida para o bucket do Amazon S3 e a frequência com que deseja fazer upload dos dados no Amazon S3. Também é possível escolher o que fazer com os dados após a ingestão no AWS IoT SiteWise. Você pode optar por ter os dados disponíveis no Amazon S3 SiteWise e no Amazon S3 ou pode optar por excluí-los automaticamente do Amazon S3.
### Compare a funcionalidade de destino entre as versões do gateway
O recurso de destinos nos gateways habilitados para MQTT simplifica o gerenciamento do fluxo de dados. Os destinos simplificam o gerenciamento de dados por meio da configuração centralizada do roteamento de dados para vários terminais. Essa abordagem elimina a necessidade de configurações de transmissão individuais complexas, tornando o sistema geral mais flexível e fácil de gerenciar.
Em comparação, o Classic streams, V2 gateway e SiteWise Edge transmite dados das fontes de dados para os editores por meio de AWS IoT Greengrass fluxos, configurando destinos de dados individualmente para cada fonte de dados.
Com o recurso de AWS IoT SiteWise destino, a configuração de roteamento do editor é consolidada. A configuração de destino permite gerenciar destinos e filtros de caminho de forma centralizada. Você pode adicionar facilmente um destino, gerenciar filtros de caminho, excluir filtros ou destinos desnecessários, dependendo de suas necessidades.
Além disso, o recurso de destinos utiliza o MQTT (Message Queuing Telemetry Transport), um protocolo padrão do setor amplamente usado em aplicações industriais de IoT. Essa adoção do MQTT ajuda AWS IoT SiteWise a facilitar a integração com vários dispositivos e sistemas.
### Limitações de destino
As limitações atuais para destinos nos gateways SiteWise Edge incluem:
+ O pacote de processamento de dados não é compatível com gateways habilitados para MQTT.
+ O suporte ao tipo de dados é limitado aos tipos de AWS IoT SiteWise dados. Para obter informações sobre como habilitar a conversão de tipo de dados, consulte[Converter tipos de dados incompatíveis](string-conversion.md).
### Casos de uso para destinos SiteWise Edge
SiteWise Os destinos periféricos são utilizados em diversas aplicações. Aqui estão alguns exemplos importantes:
**Automação industrial***Monitoramento em tempo real e manutenção preditiva*
Em ambientes industriais, sensores e dispositivos no chão de fábrica podem publicar dados no SiteWise Edge. Os destinos podem ser configurados para filtrar e rotear dados relevantes, permitindo monitoramento e análise em tempo real do desempenho da máquina. Você pode se inscrever em tópicos relevantes do MQTT usando filtros de caminho, processar os dados e depois publicar os dados processados. Dessa forma, você pode rotear seletivamente os dados processados para serviços analíticos AWS em nuvem ou sistemas locais. Os fabricantes podem então implementar estratégias de manutenção preditiva, otimizar os processos de produção e reduzir o tempo de inatividade.
**Edifícios inteligentes***Eficiência energética e otimização da ocupação*
Os sistemas de automação predial geram fluxos de dados para monitorar e controlar vários aspectos de um edifício, como sistemas HVAC, iluminação e controle de acesso. Com o SiteWise Edge, esses fluxos de dados podem ser ingeridos, processados e roteados para destinos diferentes. Os gerentes das instalações podem configurar destinos para filtrar e encaminhar dados relevantes, habilitando recursos avançados, como medidas de eficiência energética e otimização de ocupação, garantindo a privacidade e a conformidade dos dados.
Esses casos de uso demonstram como o recurso Destinations no SiteWise Edge pode ser aproveitado em vários setores para ingerir, processar e rotear dados com eficiência. Isso permite recursos avançados, como monitoramento em tempo real, manutenção preditiva, eficiência energética e diagnóstico remoto, garantindo a privacidade e a conformidade dos dados.
## Entenda os filtros de caminho para destinos AWS IoT SiteWise do Edge
**Topics**
+ [Requisitos de filtro de caminho](#path-filter-requirements)
+ [Práticas recomendadas para filtros de caminho](#create-effective-path-filters)
+ [Filtros de caminho para servidores OPC UA](#path-filters-opcua)
+ [Caracteres especiais nos nomes dos filtros de caminho](#path-filters-special-characters)
Cada destino é configurado para rotear dados para o Amazon S3 AWS IoT SiteWise ou para o Amazon S3. Os filtros de caminho permitem que você selecione dados específicos para filtrar ao receber mensagens MQTT para um destino. Os filtros de caminho representam os nomes lógicos dos seus fluxos de dados, atuando como assinaturas dos tópicos desejados do MQTT.
No MQTT, os dados são organizados em tópicos, que são sequências hierárquicas separadas por barras (). `/` Por exemplo, um dispositivo pode publicar dados de temperatura no tópico`home/livingroom/sensor1/temperature`. Aqui, `home/livingroom/sensor1` representa o caminho ou o nome lógico do sensor e `temperature` é o tipo de dados que está sendo publicado.
Você pode usar filtros de caminho para se inscrever em tópicos específicos ou em uma variedade de tópicos usando curingas (`+`e`#`). O `+` curinga corresponde a um único nível na hierarquia de tópicos. Por exemplo, `home/+/sensor1/temperature` combinaria `home/livingroom/sensor1/temperature` `home/bedroom/sensor1/temperature` e. O `#` curinga, quando usado no final de um filtro, corresponde a vários níveis.
Você também pode usar uma variedade de caracteres normalmente não permitidos na especificação MQTT em um nome de filtro de caminho. Esses caracteres não funcionam como curingas quando usados em um nome. AWS IoT SiteWise converte esses caracteres usando a codificação para garantir a conformidade com o MQTT e, ao mesmo tempo, preservar sua estrutura de nomenclatura original. Esse recurso é particularmente útil para acomodar as convenções de nomenclatura existentes de outros sistemas. Para obter mais informações, consulte [Caracteres especiais nos nomes dos filtros de caminho](#path-filters-special-characters).
Ao selecionar cuidadosamente os filtros de caminho apropriados, você pode controlar quais dados são enviados para um destino específico. Adapte o fluxo de dados aos requisitos do seu sistema de IoT usando filtros de caminho.
### Requisitos de filtro de caminho
Ao inserir filtros de caminho usando o Console do AWS IoT SiteWise, lembre-se do seguinte:
+ Os filtros de caminho são delimitados por uma nova linha, com cada linha representando um filtro de caminho separado.
+ Os filtros de caminho individuais podem ter entre 1 e 65.535 bytes.
+ Um filtro de caminho não pode ficar em branco.
+ Valores nulos (U\$10000) não são permitidos.
+ Você pode inserir até 100 filtros de caminho ou 65.535 caracteres por vez, qualquer que seja o limite atingido primeiro.
+ O limite geral é de 20.000 filtros de caminho para todos os destinos em um gateway combinados.
+ Você pode usar `$` caracteres`%`,`#`,`+`, e nos nomes dos filtros de caminho, mas os converte AWS IoT SiteWise automaticamente em codificação de URI.
### Práticas recomendadas para filtros de caminho
Ao criar filtros de caminho para seus AWS IoT SiteWise destinos, considere as estratégias a seguir para gerenciar seus dados com eficiência.
+ Estruture seus filtros para espelhar sua hierarquia de dispositivos. Por exemplo, em um ambiente de fabricação`factory/+/machine/#`, captura dados de todas as máquinas em diferentes linhas de produção.
+ Use níveis específicos para tipos de dispositivos, localizações ou funções. Por exemplo, .`factory/assembly-line/robot/temperature` Ou, na agricultura inteligente`farm/+/crop/+/moisture`, monitorar os níveis de umidade de várias culturas em diferentes campos.
+ Use curingas estrategicamente: use `+` para variações em um único nível e `#` para capturar todos os níveis subsequentes. Por exemplo`building/+/+/energy-consumption`, monitora o uso de energia em diferentes zonas e andares de um edifício. Isso pressupõe que o primeiro `+` capture todos os andares e o segundo `+` capture todas as zonas.
+ Equilibre especificidade e flexibilidade criando filtros específicos o suficiente para capturar dados relevantes, mas flexíveis o suficiente para acomodar futuras mudanças. Por exemplo, `site/+/equipment-type/+/measurement` permite a adição de novos locais ou tipos de equipamentos sem alterar a estrutura do filtro.
Teste seus filtros minuciosamente para garantir que eles capturem os dados pretendidos e estejam alinhados com a arquitetura e os objetivos do seu sistema de IoT.
### Filtros de caminho para servidores OPC UA
Para servidores OPC UA, seus filtros de caminho devem corresponder aos nomes das tags OPC UA. O nível final do seu filtro de caminho deve corresponder exatamente ao nome da tag OPC UA. Por exemplo, se sua tag OPC UA for`Device1.Temperature`, seu filtro de caminho pode ser`factory/line1/Device1.Temperature`. Você pode usar curingas nos níveis anteriores, como `factory/+/Device1.Temperature` para capturar a etiqueta em várias linhas de produção. Se você tiver caracteres especiais nos nomes dos filtros de caminho, consulte [Caracteres especiais nos nomes dos filtros de caminho](#path-filters-special-characters) para obter mais informações.
### Caracteres especiais nos nomes dos filtros de caminho
AWS IoT SiteWise acomoda caracteres comumente usados em protocolos industriais como OPC UA, que normalmente não são permitidos em nomes de tópicos padrão do MQTT. Esse recurso facilita a integração mais suave de sistemas industriais com arquiteturas baseadas em MQTT.
**nota**
Embora nosso tratamento de caracteres especiais seja útil para integração e migração, é recomendável alinhar-se às convenções de nomenclatura padrão do MQTT para novas implementações, quando possível, para garantir uma compatibilidade mais ampla.
Ao receber dados de fontes industriais, AWS IoT SiteWise normaliza os nomes dos tópicos usando a codificação URI para caracteres especiais:
+ `%`torna-se `%25` (codificado primeiro como o caractere de escape)
+ `#` se torna `%23`
+ `+` se torna `%2B`
+ `$`torna-se `%24` (somente quando está no início de um tópico)
Essa codificação garante que os dados de origem contendo esses caracteres especiais do MQTT possam ser usados com segurança como nomes de tópicos do MQTT, preservando as convenções de nomenclatura industrial originais.
**Example : Caracteres especiais nos nomes dos filtros de caminho**
Aqui estão alguns exemplos de como os nomes de tópicos industriais podem aparecer nos filtros de AWS IoT SiteWise caminho:
+ `Factory1/Line#2/Sensor+3` se torna `Factory1/Line%232/Sensor%2B3`
+ `Plant%A/Unit$1/Temp` se torna `Plant%25A/Unit%241/Temp`
+ `Site1/#Section/+Node` se torna `Site1/%23Section/%2BNode`
Ao criar assinaturas ou visualizar nomes de tópicos em AWS IoT SiteWise, você verá as versões originais não codificadas. A codificação é tratada automaticamente para garantir a conformidade com o MQTT.
# Adicione um destino em tempo real do AWS IoT SiteWise Edge
O tipo de destino em tempo real permite que você transmita dados de IoT diretamente de seus dispositivos e gateways para o AWS IoT SiteWise armazenamento em tempo real. Essa opção é ideal para casos de uso que exigem ingestão e processamento imediatos de dados à medida que são gerados, sem a necessidade de lotes ou armazenamento em buffer. Você só pode ter um destino em tempo real configurado em cada gateway, pois ele transmite dados continuamente para AWS IoT SiteWise.
**nota**
A duplicação TQVs pode resultar em cobrança dupla.
**Para adicionar um destino em tempo real**
Use o AWS IoT SiteWise console ou AWS CLI adicione um destino em tempo real ao seu gateway SiteWise Edge habilitado para MQTT.
------
#### [ Console ]
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 um destino.
1. Na seção **Destinos**, escolha **Adicionar destino**.
1. Na página **Adicionar destino**, insira **os detalhes do destino**:
1. Um nome para seu destino no campo **Nome do destino**.
1. Selecione o **AWS IoT SiteWise tempo real** para o **tipo de destino**.
1. Configure a ordem de publicação do gateway definindo a **Ordem de publicação** como **Publicar primeiro os dados mais antigos** ou **Publicar os dados mais recentes primeiro**. Por padrão, o gateway publica primeiro os dados mais antigos.
1. Use o **Tempo máximo de espera do lote** para definir um tempo máximo de espera do editor antes de enviar um lote de dados AWS IoT SiteWise. Essa configuração se aplica a cada alias. Os dados são armazenados localmente até que:
+ O tempo definido já passou, ou
+ 10 entradas time-quality-value (TQV) são recebidas para o alias
Qualquer condição atendida primeiro aciona o lote a ser enviado para a nuvem.
1. Para compactar dados carregados, marque a caixa de seleção **Ativar compactação ao carregar dados**. Deixar o gateway compactar seus dados antes de enviá-los para a nuvem reduz o uso da largura de banda.
1. Para filtrar dados expirados do editor, marque a caixa de seleção **Excluir dados expirados**. Essa seleção envia somente dados ativos e atuais para AWS IoT SiteWise.
1. No campo **Período limite**, insira a frequência com que os dados devem ser considerados expirados em seu conjunto de dados. Você pode determinar se os dados são contados em termos de minutos ou dias. O período mínimo de corte é de cinco minutos. O prazo máximo de corte é de sete dias.
1. Opcionalmente, defina as **configurações de armazenamento local**:
1. Defina a frequência do **período de retenção** — A quantidade de tempo em que o gateway armazena localmente dados anteriores ao período limite. O período mínimo de retenção é de um minuto.
O período máximo de retenção é de 30 dias e maior ou igual ao período de rotação.
1. Definir o **período de rotação** — O intervalo de tempo a ser especificado ao salvar dados anteriores ao período limite de um único arquivo. O gateway transfere um lote de dados para o seguinte diretório local no final de cada período de alternância: `/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports`.
A retenção deve ser maior que um minuto e igual ao período de retenção.
1. Forneça o valor da **capacidade de armazenamento (GB)** para definir o tamanho máximo dos dados armazenados localmente em GB. Se os dados excederem o tamanho máximo de armazenamento local determinado, o gateway começará a excluir primeiro os dados mais antigos. O gateway continua sendo excluído até que o tamanho dos dados armazenados localmente seja igual ou menor que a cota.
A capacidade de armazenamento deve ser maior ou igual a um GB.
1. Adicione filtros de caminho ao seu destino. Para obter mais informações, consulte, [Adicione filtros de caminho aos destinos AWS IoT SiteWise do Edge](destinations-add-path-filters.md).
Para obter mais informações, consulte [Tipos de destino](gw-destinations.md#destination-types).
------
#### [ AWS CLI ]
**Example : Crie um novo destino AWS IoT SiteWise em tempo real**
Use a [UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API para configurar o editor.
Defina o parâmetro `capabilityNamespace` como `iotsitewise:publisher:3`.
```
{
"sources": [
{
"type": "MQTT"
}
],
"destinations": [
{
"type": "SITEWISE_REALTIME",
"name": "your-destination-name",
"config": {
"publishingOrder": "TIME_ORDER",
"enableCompression": true,
"maxBatchWaitTime": "10s"
},
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"#"
]
}
}
]
}
]
}
```
Para atualizar um destino existente AWS IoT SiteWise em tempo real, primeiro use a `DescribeGatewayCapabilityConfiguration` API para encontrar `destinationId` o.
**Example : Atualize um destino AWS IoT SiteWise em tempo real**
Use a [UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API para configurar o editor.
Defina o parâmetro `capabilityNamespace` como `iotsitewise:publisher:3`.
```
{
"sources": [
{
"type": "MQTT"
}
],
"destinations": [
{
"id": "your-existing-destination-id",
"type": "SITEWISE_REALTIME",
"name": "your-destination-name",
"config": {
"publishingOrder": "TIME_ORDER",
"enableCompression": true,
"dropPolicy": {
"cutoffAge": "7d",
"exportPolicy": {
"retentionPeriod": "7d",
"rotationPeriod": "6h",
"exportSizeLimitGB": 10
}
},
"maxBatchWaitTime": "10s"
},
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"#"
]
}
}
]
}
]
}
```
As opções de configuração a seguir são específicas para gateways que usam o `iotsitewise:publisher:3` namespace.
`sources`
Define as fontes de dados para as quais transferir dados de seu equipamento industrial AWS IoT SiteWise. Para gateways habilitados para MQTT, use. `MQTT`
Tipo: matriz de objetos
Obrigatório: Sim
`destinations`
Define para onde enviar os dados. Os destinos são em tempo real ou armazenados em buffer usando o Amazon S3. É necessário pelo menos um objeto de destino, mas você pode adicionar uma matriz vazia. Você pode ter um destino em tempo real para cada gateway. Para obter mais informações, consulte [AWS IoT SiteWise Entenda os destinos Edge](gw-destinations.md#source-destination).
Tipo: matriz de objetos
Obrigatório: Sim
`id`
O identificador exclusivo do destino. Você pode fornecer uma ID de destino existente ou deixá-la em branco. Se você não especificar um ID, um UUID será gerado por padrão.
Tipo: string
Obrigatório: não
`type`
Tipo de destino. As opções incluem: `SITEWISE_REALTIME` `SITEWISE_BUFFERED` e.
+ `SITEWISE_REALTIME`— Envie dados diretamente para o AWS IoT SiteWise armazenamento em tempo real.
+ `SITEWISE_BUFFERED`— Envie dados para o Amazon S3 em lotes no formato Parquet e, em seguida, importe para o armazenamento. AWS IoT SiteWise
Tipo: String
Obrigatório: Sim
`name`
Um nome exclusivo para o destino.
Tipo: String
Obrigatório: Sim
`config`
Configuração específica para o tipo de destino no formato JSON. A configuração varia entre destinos em tempo real e em buffer.
Tipo: objeto
Obrigatório: Sim
Ordem de publicação
Determina a ordem na qual os dados são publicados. Os dados são publicados com base em seu registro de data e hora. As opções incluem `TIME_ORDER` `RECENT_DATA` e.
+ `TIME_ORDER`(padrão) — Publica primeiro os dados mais antigos.
+ `RECENT_DATA`— Publica primeiro os dados mais recentes.
Tipo: string
Obrigatório: não
Ativar compactação
Quando definido como`true`, ativa a compactação de dados antes de enviar para AWS IoT SiteWise. Deixar o gateway compactar seus dados antes de enviá-los para a nuvem reduz o uso da largura de banda. O valor padrão é `true`.
Tipo: booliano
Obrigatório: não
Política de descarte
Define como lidar com dados mais antigos.
Tipo: objeto
Obrigatório: não
+ `cutoffAge`
A idade máxima dos dados a serem publicados é especificada em dias, horas e minutos. Por exemplo, `7d` ou `1d7h16m`. Dados mais antigos do que os especificados não são enviados para AWS IoT SiteWise.
Os dados anteriores ao período limite não são publicados na nuvem. A idade limite deve ser entre cinco minutos e sete dias.
Você pode usar `m`, `h` e `d` ao especificar uma idade limite. Observe que `m` representa minutos, `h` representa horas e `d` representa dias.
Tipo: String
Obrigatório: Sim
+ `exportPolicy`
Define como lidar com dados que excedem a idade limite.
Tipo: objeto
Obrigatório: não
+ `retentionPeriod`
Seu gateway SiteWise Edge exclui todos os dados na borda anteriores ao período limite do armazenamento local após serem armazenados pelo período de retenção especificado. O período de retenção deve ser entre um minuto e 30 dias e maior ou igual ao período de alternância.
Você pode usar `m`, `h` e `d` ao especificar um período de retenção. Observe que `m` representa minutos, `h` representa horas e `d` representa dias.
Tipo: string
Obrigatório: não
+ `rotationPeriod`
O intervalo de tempo para agrupar e salvar dados anteriores ao período limite em um único arquivo. O gateway SiteWise Edge transfere um lote de dados para o seguinte diretório local no final de cada período de rotação:`/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports`. O período de alternância deve ser maior que um minuto e menor ou igual ao período de retenção.
Você pode usar `m`, `h` e `d` ao especificar um período de alternância. Observe que `m` representa minutos, `h` representa horas e `d` representa dias.
Tipo: string
Obrigatório: não
+ `exportSizeLimitGB`
O tamanho máximo permitido de dados armazenados localmente, em GB. Se essa cota for violada, o SiteWise Edge Gateway começará a excluir os dados mais antigos até que o tamanho dos dados armazenados localmente seja igual ou menor que a cota. O valor desse parâmetro deve ser maior ou igual a 1.
Tipo: inteiro
Obrigatório: não
`maxBatchWaitTime`
Define um tempo máximo para o editor esperar antes de enviar um lote de dados AWS IoT SiteWise. Essa configuração se aplica a cada alias. Os dados são armazenados localmente até que:
+ O tempo definido já passou, ou
+ 10 entradas time-quality-value (TQV) são recebidas para o alias
Use `m``h`, e `d` para especificar um horário limite. Observe que `m` representa minutos, `h` representa horas e `d` representa dias.
Tipo: string
Obrigatório: não
`filters`
Filtros a serem aplicados aos dados. É necessário pelo menos um filtro.
Tipo: String
Obrigatório: Sim
`type`
Tipo de filtro. Use `PATH`.
Tipo: String
Obrigatório: Sim
`config`
Configuração específica para o tipo de filtro no formato JSON. É necessário pelo menos um objeto, mas a matriz pode estar vazia.
Tipo: objeto
Obrigatório: Sim
+ `paths`
Uma variedade de filtros de caminho. Para obter mais informações, consulte [Entenda os filtros de caminho para destinos AWS IoT SiteWise do EdgeUnderstand path filters](gw-destinations.md#destinations-path-filters). O caminho padrão é `#`.
Tipo: matriz de strings
Obrigatório: Sim
------
# Adicione um destino em AWS IoT SiteWise buffer usando o Amazon S3
O tipo de destino armazenado em buffer permite que você economize nos custos de ingestão AWS IoT SiteWise caso não precise dos dados em tempo real. Ele permite que você armazene temporariamente seus dados de IoT em um bucket do Amazon S3 antes de importá-los. AWS IoT SiteWise Ou você pode simplesmente carregar seus dados no S3 para armazenamento, independentemente de planejar importá-los AWS IoT SiteWise. Isso é útil para agrupar e armazenar dados em buffer de seus dispositivos e gateways antes de inseri-los. AWS IoT SiteWise Com essa opção, os dados são carregados no bucket S3 especificado no formato Parquet em uma frequência configurada. Em seguida, você pode importar esses dados para AWS IoT SiteWise armazenamento para análise e processamento adicionais.
**Para adicionar um destino armazenado em buffer usando o Amazon S3**
Use o AWS IoT SiteWise console ou AWS CLI adicione um destino que armazene dados usando o Amazon S3 em SiteWise seu gateway Edge.
------
#### [ Console ]
Use o Console de gerenciamento da AWS para adicionar um AWS IoT SiteWise destino armazenado em buffer usando o Amazon S3.
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 um destino.
1. Na seção **Destinos**, escolha **Adicionar destino**.
1. Na página **Adicionar destino**, insira **os detalhes do destino**:
1. Um nome para seu destino no campo **Nome do destino**.
1. **Selecione em **AWS IoT SiteWise buffer usando o Amazon S3** como tipo de destino.** AWS IoT SiteWise armazenado em buffer usando o Amazon S3 envia dados para o Amazon Simple Storage Service em lotes, no formato Parquet, e depois importa os dados para o armazenamento. AWS IoT SiteWise
1. Insira a URL do Amazon S3 para o local onde você deseja armazenar seus dados de gateway. Você pode procurar o caminho escolhendo **Browse S3**. Depois que um bucket é adicionado, você também pode ver o bucket escolhendo **Exibir**.
1. Especifique com que frequência seu gateway deve carregar dados para o Amazon S3 inserindo um período de tempo e selecionando um incremento de tempo para a frequência de upload de **dados**. O valor da frequência deve ser maior que 0 e menor ou igual a 30 dias.
1. Em **Configurações de armazenamento de dados**, determine o que fazer com os dados do gateway após importá-los para AWS IoT SiteWise. Há duas decisões a serem tomadas em relação ao armazenamento de dados:
+ Se você quiser copiar dados importados para o AWS IoT SiteWise armazenamento, marque a caixa de seleção **Copiar dados para armazenamento**. Essa opção duplica os dados importados do seu bucket AWS IoT SiteWise Amazon S3 configurado no armazenamento.
+ Se você optar por importar seus dados do seu bucket do Amazon S3 para o AWS IoT SiteWise armazenamento, você também pode especificar se os dados importados devem ser excluídos após a conclusão da importação. Marque a caixa **de seleção Excluir dados do Amazon S3** para excluir a data importada do bucket do Amazon S3 configurado após importá-la para o armazenamento. AWS IoT SiteWise
1. Adicione filtros de caminho ao seu destino. Para obter mais informações, consulte, [Adicione filtros de caminho aos destinos AWS IoT SiteWise do Edge](destinations-add-path-filters.md).
------
#### [ AWS CLI ]
**Example : Crie um novo AWS IoT SiteWise destino armazenado em buffer usando o Amazon S3**
Use a [UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API para configurar o editor.
Defina o parâmetro `capabilityNamespace` como `iotsitewise:publisher:3`.
```
{
"sources": [
{
"type": "MQTT"
}
],
"destinations": [
{
"type": "SITEWISE_BUFFERED",
"name": "your-s3-destination-name",
"config": {
"targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/Optional/SomeFolder",
"publishPolicy": {
"publishFrequency": "15m",
"localSizeLimitGB": 10
},
"siteWiseImportPolicy": {
"enableSiteWiseStorageImport": true,
"enableDeleteAfterImport": true,
"bulkImportJobRoleArn": "arn:aws:iam::123456789012:role/your-role-name"
}
},
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"#"
]
}
}
]
}
]
}
```
**Example : Atualize um AWS IoT SiteWise destino armazenado em buffer usando o Amazon S3**
Para atualizar um destino existente AWS IoT SiteWise em tempo real, primeiro use a `DescribeGatewayCapabilityConfiguration` API para encontrar `destinationId` o.
O namespace do publicador: `iotsitewise:publisher:3`
```
{
"sources": [
{
"type": "MQTT"
}
],
"destinations": [
{
"id": "your-existing-destination-id",
"type": "SITEWISE_BUFFERED",
"name": "your-s3-destination-name",
"config": {
"targetBucketArn": "arn:aws:s3:::amzn-s3-demo-bucket/Optional/SomeFolder",
"publishPolicy": {
"publishFrequency": "15m",
"localSizeLimitGB": 10
},
"siteWiseImportPolicy": {
"enableSiteWiseStorageImport": true,
"enableDeleteAfterImport": true,
"bulkImportJobRoleArn": "arn:aws:iam::123456789012:role/your-role-name"
}
},
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"#"
]
}
}
]
}
]
}
```
As opções de configuração a seguir são específicas para gateways habilitados para MQTT usando o namespace. `iotsitewise:publisher:3`
`sources`
Define as fontes de dados para as quais transferir dados de seu equipamento industrial AWS IoT SiteWise. Para gateways habilitados para MQTT, use. `MQTT`
Tipo: matriz de objetos
Obrigatório: Sim
`destinations`
Define para onde enviar os dados. Os destinos são em tempo real ou armazenados em buffer usando o Amazon S3. É necessário pelo menos um objeto de destino, mas você pode adicionar uma matriz vazia. Você pode ter um destino em tempo real para cada gateway. Para obter mais informações, consulte [AWS IoT SiteWise Entenda os destinos Edge](gw-destinations.md#source-destination).
Tipo: matriz de objetos
Obrigatório: Sim
`id`
O identificador exclusivo do destino. Você pode fornecer uma ID de destino existente ou deixá-la em branco para que uma nova ID seja gerada automaticamente para o destino.
Tipo: string
Obrigatório: não
`type`
Tipo de destino. As opções incluem: `SITEWISE_REALTIME` `SITEWISE_BUFFERED` e. Selecione `SITEWISE_BUFFERED`.
+ `SITEWISE_REALTIME`(padrão) — Envie dados diretamente para o AWS IoT SiteWise armazenamento em tempo real. Para obter mais informações, consulte [Adicione um destino em tempo real do AWS IoT SiteWise Edge](destinations-real-time.md).
+ `SITEWISE_BUFFERED`— Envie dados para o Amazon S3 em lotes no formato Parquet e, em seguida, importe para o armazenamento. AWS IoT SiteWise
Tipo: String
Obrigatório: Sim
`name`
Um nome exclusivo para o destino.
Tipo: String
Obrigatório: Sim
`config`
Configuração específica para o tipo de destino no formato JSON. A configuração varia entre destinos em tempo real e em buffer.
Tipo: objeto
Obrigatório: Sim
`targetBucketArn`
O ARN do bucket de publicação. Escolha o mesmo Região da AWS para ambos AWS IoT SiteWise e para o Amazon S3. Se um prefixo for escolhido, ele deverá ter entre 1 e 255 caracteres.
AWS IoT SiteWise, incluindo o gateway, terá acesso a todo o bucket S3 especificado. Recomendamos usar um bucket dedicado para ingestão de dados em buffer.
Tipo: String
Obrigatório: Sim
`publishPolicy`
Detalhes da política de publicação.
Tipo: objeto
Obrigatório: Sim
`publishFrequency`
A frequência com que o gateway SiteWise Edge publica no bucket do Amazon S3. A frequência de upload de dados para o Amazon S3 deve ser maior que 0 minutos e menor ou igual a 30 dias. Você pode usar `m``h`, e `d` ao especificar uma idade de frequência de publicação. Observe que `m` representa minutos, `h` representa horas e `d` representa dias. O valor padrão é 15 minutos.
Tipo: String
Obrigatório: Sim
`localSizeLimitGB`
O tamanho máximo dos arquivos gravados no disco local em GB. Se esse limite for violado, o publicador publicará todos os dados armazenados em buffer no destino.
Tipo: inteiro
Obrigatório: Sim
`siteWiseImportPolicy`
Detalhes da política de importação para importação de dados para o. AWS IoT SiteWise
Tipo: objeto
Obrigatório: Sim
`enableSiteWiseStorageImport`
Defina isso `true` para importar dados de um bucket do Amazon S3 para AWS IoT SiteWise armazenamento. Inicialmente, ele faz uma cópia dos dados em AWS IoT SiteWise. Em seguida, se você `enableDeleteAfterImport` definir como verdadeiro, os dados no S3 serão excluídos após a cópia para o. AWS IoT SiteWise Aplicam-se implicações de preços. O valor padrão é `true`.
Tipo: booliano
Obrigatório: Sim
`enableDeleteAfterImport`
Defina isso `true` para excluir o arquivo no bucket do Amazon S3 após a ingestão no armazenamento. AWS IoT SiteWise O valor padrão é `true`.
Tipo: booliano
Obrigatório: Sim
`bulkImportJobRoleArn`
O ARN da função do IAM que AWS IoT SiteWise pressupõe a leitura de dados em buffer do Amazon S3 durante a ingestão de dados. Essa função é usada quando um dispositivo de borda é chamado AWS IoT SiteWise APIs para iniciar o processo de importação em massa.
Se `enableSiteWiseStorageImport` estiver definido como`true`, esse parâmetro será obrigatório.
Tipo: string
Obrigatório: não
------
Adicione filtros de caminho para seu destino. Para obter mais informações, consulte [Adicione filtros de caminho aos destinos AWS IoT SiteWise do Edge](destinations-add-path-filters.md).
# Adicione filtros de caminho aos destinos AWS IoT SiteWise do Edge
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
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.
# Gerenciar destinos AWS IoT SiteWise do Edge
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
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
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)
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
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
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.
------