Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Filtros de destinos y rutas
Los destinos en AWS IoT SiteWise Edge proporcionan una forma flexible y eficiente de gestionar la forma en que los datos industriales fluyen desde los dispositivos periféricos a la nube. En esta sección se explica cómo configurar los destinos, usar filtros de ruta para enrutar flujos de datos específicos y elegir el tipo de destino adecuado para su caso de uso.
Puede usar filtros de destinos y rutas en las puertas de enlace V3 autohospedadas y habilitadas para MQTT y las que se utilizan junto con la aplicación Edge alojada en ellas. AWS IoT SiteWise Siemens Industrial Edge Los filtros de destinos y rutas no funcionan con las pasarelas Classic Streams y V2.
**Topics**
+ [Comprenda los destinos de AWS IoT SiteWise Edge](#source-destination)
+ [Conozca los filtros de ruta para los destinos de AWS IoT SiteWise Edge](#destinations-path-filters)
+ [Agregue un destino de AWS IoT SiteWise Edge en tiempo real](destinations-real-time.md)
+ [Añadir un destino almacenado en AWS IoT SiteWise búfer mediante Amazon S3](destinations-buffered.md)
+ [Agregue filtros de ruta a los destinos de AWS IoT SiteWise Edge](destinations-add-path-filters.md)
+ [Administre los destinos de AWS IoT SiteWise Edge](destinations-manage.md)
## Comprenda los destinos de AWS IoT SiteWise Edge
Utilice los destinos de AWS IoT SiteWise Edge para determinar dónde enviar los datos de origen. Puede elegir el destino de sus datos en función de las características específicas que necesite, como la rentabilidad, la baja latencia o los requisitos de almacenamiento. Integre los datos de los dispositivos capturados por AWS IoT SiteWise nuestros socios o aplicaciones personalizadas para publicar y suscribirse a los filtros de rutas (temas) periféricos. A continuación, puede modelar, transferir y almacenar los datos de su dispositivo en la nube.
**nota**
Para aprovechar al máximo todas las funciones de destino en las pasarelas autohospedadas, actualice a las versiones más recientes del SiteWise editor de IoT y del recopilador SiteWise OPC UA de IoT. La compatibilidad con las transmisiones clásicas continúa en las pasarelas V2 para mantener la compatibilidad con las configuraciones existentes. Para obtener más información, consulte [Transmisiones clásicas, pasarelas V2 para Edge AWS IoT SiteWise](classic-streams-v2-gateway.md)
**Topics**
+ [Cómo los destinos SiteWise Edge mejoran la gestión de datos](#how-destinations-work)
+ [Tipos de destino](#destination-types)
+ [Compare la funcionalidad de destino entre las versiones de puerta de enlace](#destinations-vs-publisher-component)
+ [Limitaciones de destino](#destinations-limitiations)
+ [Casos de uso para destinos de SiteWise Edge](#destinations-use-cases)
### Cómo los destinos SiteWise Edge mejoran la gestión de datos
Exporte datos desde la periferia a AWS IoT SiteWise en tiempo real o por lotes con Amazon S3.
Los destinos mejoran la flexibilidad y la escalabilidad de su entorno. AWS IoT SiteWise Los destinos implementan un modelo de administración de datos centralizado, en el que las fuentes publican los datos en un sistema central. Los destinos determinan dónde se envían los datos mediante filtros de ruta. Los destinos pueden suscribirse a varios filtros de ruta.
Las pasarelas habilitadas para MQTT, ya sean autohospedadas o en ejecuciónSiemens Industrial Edge, utilizan MQTT para la comunicación local e incluyen un destino en tiempo real predeterminado con filtros configurados en. `#` Esto significa que, de forma predeterminada, todos los mensajes sobre todos los temas se publican en el destino en tiempo real. AWS IoT SiteWise Para obtener más información, consulte [Conozca los filtros de ruta para los destinos de AWS IoT SiteWise EdgeEntendimiento de filtros de ruta](#destinations-path-filters). Puede añadir un destino en tiempo real en cada puerta de enlace.
### Tipos de destino
Al configurar un destino para su puerta de enlace, tiene dos opciones principales: configuración en tiempo real mediante AWS IoT SiteWise Amazon S3 y configuración en búfer. Cada tipo de destino tiene su propio conjunto de ajustes y consideraciones.
**AWS IoT SiteWise ajustes en tiempo real**
Elija esta opción para enviar los datos directamente al almacenamiento de AWS IoT SiteWise nivel avanzado para facilitar la ingesta y el monitoreo de los datos en tiempo real. La configuración en tiempo real gestiona el flujo de datos, especialmente cuando una puerta de enlace tiene problemas de conectividad con la nube. Durante la pérdida de la conexión, los datos se almacenan temporalmente de forma local en la puerta de enlace. Una vez que se restablece la conexión, los datos almacenados se envían automáticamente a la nube.
Puede ajustar varios aspectos del proceso de publicación de datos, como la cantidad máxima de datos que se deben almacenar localmente, la velocidad a la que se envían los datos a la nube al volver a conectarse y cuándo se eliminan los datos una vez que el almacenamiento alcanza su capacidad máxima.
Para obtener más información sobre los niveles AWS IoT SiteWise de almacenamiento, consulte,[Gestione el almacenamiento de datos en AWS IoT SiteWise](manage-data-storage.md).
**AWS IoT SiteWise almacenado en búfer mediante la configuración de Amazon S3**
Este tipo de destino le permite almacenar datos en búfer local en la puerta de enlace y enviarlos periódicamente a un bucket de Amazon S3 por lotes. Los datos se almacenan en el eficiente formato Parquet, que está optimizado para las cargas de trabajo analíticas. Una vez que los datos estén en Amazon S3, podrá importarlos AWS IoT SiteWise para almacenarlos, procesarlos y analizarlos.
Elija esta opción para ingerir datos en lotes y almacenar los datos históricos de forma rentable. Puede configurar la ubicación del bucket de Amazon S3 que prefiera y la frecuencia con la que desea que se carguen los datos en Amazon S3. También puede elegir qué hacer con los datos después de su ingesta en AWS IoT SiteWise. Puede elegir que los datos estén disponibles tanto SiteWise en Amazon S3 como en Amazon S3 o puede optar por eliminarlos automáticamente de Amazon S3.
### Compare la funcionalidad de destino entre las versiones de puerta de enlace
La función de destinos de las pasarelas habilitadas para MQTT agiliza la gestión del flujo de datos. Los destinos simplifican la administración de datos mediante la configuración centralizada del enrutamiento de datos a varios puntos finales. Este enfoque elimina la necesidad de configuraciones complejas de flujos individuales, lo que hace que el sistema en general sea más flexible y fácil de administrar.
En comparación, SiteWise Edge, la pasarela Classic Streams, V2, transmite los datos de las fuentes de datos a los editores mediante AWS IoT Greengrass transmisiones, configurando los destinos de los datos de forma individual para cada fuente de datos.
Con la función de AWS IoT SiteWise destino, se consolida la configuración de enrutamiento del editor. La configuración de destinos le permite gestionar los destinos y los filtros de rutas de forma centralizada. Puede añadir fácilmente un destino, gestionar los filtros de ruta y eliminar filtros o destinos innecesarios, según sus necesidades.
Además, la función de destinos utiliza MQTT (Message Queuing Telemetry Transport), un protocolo estándar del sector que se utiliza ampliamente en aplicaciones industriales de IoT. La adopción del MQTT ayuda AWS IoT SiteWise a facilitar la integración con varios dispositivos y sistemas.
### Limitaciones de destino
Las limitaciones actuales para los destinos de las pasarelas SiteWise Edge incluyen:
+ El paquete de procesamiento de datos no es compatible con las pasarelas habilitadas para MQTT.
+ La compatibilidad con los tipos de datos se limita a los tipos de datos. AWS IoT SiteWise Para obtener información sobre cómo habilitar la conversión de tipos de datos, consulte[Conversión de tipos de datos no admitidos](string-conversion.md).
### Casos de uso para destinos de SiteWise Edge
SiteWise Los destinos periféricos se utilizan en diversas aplicaciones. Estos son algunos ejemplos clave:
**Automatización industrial***Supervisión en tiempo real y mantenimiento predictivo*
En entornos industriales, los sensores y dispositivos de la fábrica pueden publicar datos en SiteWise Edge. Los destinos se pueden configurar para filtrar y enrutar los datos relevantes, lo que permite monitorear y analizar el rendimiento de la máquina en tiempo real. Puede suscribirse a los temas relevantes de MQTT mediante filtros de ruta, procesar los datos y, a continuación, publicar los datos procesados. De esta forma, puede enrutar de forma selectiva los datos procesados a servicios analíticos AWS en la nube o a sistemas locales. De este modo, los fabricantes pueden implementar estrategias de mantenimiento predictivo, optimizar los procesos de producción y reducir el tiempo de inactividad.
**Edificios inteligentes***Eficiencia energética y optimización de la ocupación*
Los sistemas de automatización de edificios generan flujos de datos para monitorear y controlar varios aspectos de un edificio, como los sistemas de climatización, la iluminación y el control de acceso. Con SiteWise Edge, estos flujos de datos se pueden ingerir, procesar y enrutar a diferentes destinos. Los administradores de las instalaciones pueden configurar los destinos para filtrar y reenviar los datos relevantes, lo que permite funciones avanzadas, como las medidas de eficiencia energética y la optimización de la ocupación, al tiempo que garantizan la privacidad de los datos y el cumplimiento.
Estos casos de uso demuestran cómo se puede aprovechar la función de destinos de SiteWise Edge en varios sectores para ingerir, procesar y enrutar datos de manera eficiente. Esto permite funciones avanzadas, como la supervisión en tiempo real, el mantenimiento predictivo, la eficiencia energética y el diagnóstico remoto, al tiempo que garantiza la privacidad de los datos y el cumplimiento.
## Conozca los filtros de ruta para los destinos de AWS IoT SiteWise Edge
**Topics**
+ [Requisitos de filtro de ruta](#path-filter-requirements)
+ [Prácticas recomendadas para los filtros de rutas](#create-effective-path-filters)
+ [Filtros de ruta para servidores OPC UA](#path-filters-opcua)
+ [Caracteres especiales en los nombres de los filtros de ruta](#path-filters-special-characters)
Cada destino está configurado para enrutar los datos a Amazon S3 AWS IoT SiteWise o a Amazon S3. Los filtros de ruta le permiten seleccionar datos específicos para filtrarlos al recibir mensajes MQTT para un destino. Los filtros de ruta representan los nombres lógicos de sus flujos de datos y actúan como suscripciones a los temas de MQTT que desee.
En MQTT, los datos se organizan en temas, que son cadenas jerárquicas separadas por barras diagonales (). `/` Por ejemplo, un dispositivo podría publicar datos de temperatura en el tema. `home/livingroom/sensor1/temperature` Aquí, `home/livingroom/sensor1` representa la ruta o el nombre lógico del sensor y `temperature` es el tipo de datos que se va a publicar.
Puede usar filtros de ruta para suscribirse a temas específicos o a una variedad de temas mediante caracteres comodín (`+`y`#`). El `+` comodín coincide con un único nivel de la jerarquía de temas. Por ejemplo, `home/+/sensor1/temperature` coincidiría con `home/livingroom/sensor1/temperature` y. `home/bedroom/sensor1/temperature` El `#` comodín, cuando se usa al final de un filtro, coincide con varios niveles.
También puede utilizar una variedad de caracteres que normalmente no están permitidos en la especificación MQTT dentro del nombre de un filtro de ruta. Estos caracteres no funcionan como caracteres comodín cuando se utilizan dentro de un nombre. AWS IoT SiteWise convierte estos caracteres mediante codificación para garantizar el cumplimiento de MQTT y, al mismo tiempo, conservar la estructura de nomenclatura original. Esta función es especialmente útil para adaptarse a las convenciones de nomenclatura existentes en otros sistemas. Para obtener más información, consulte [Caracteres especiales en los nombres de los filtros de ruta](#path-filters-special-characters).
Al seleccionar cuidadosamente los filtros de ruta adecuados, puede controlar qué datos se envían a un destino específico. Adapte el flujo de datos a los requisitos de su sistema de IoT mediante filtros de ruta.
### Requisitos de filtro de ruta
Al introducir filtros de ruta mediante el Consola de AWS IoT SiteWise, tenga en cuenta lo siguiente:
+ Los filtros de ruta están delimitados por una nueva línea, y cada línea representa un filtro de ruta independiente.
+ Los filtros de ruta individuales pueden tener entre 1 y 65.535 bytes.
+ Un filtro de ruta no puede estar en blanco.
+ No se permiten valores nulos (U\$10000).
+ Puede introducir hasta 100 filtros de ruta o 65 535 caracteres a la vez, el límite que se alcance primero.
+ El límite total es de 20 000 filtros de ruta para todos los destinos de una pasarela juntos.
+ Puede utilizar los `$` caracteres`%`, `#``+`, y en los nombres de los filtros de ruta, pero los convierte AWS IoT SiteWise automáticamente en codificación URI.
### Prácticas recomendadas para los filtros de rutas
Al crear filtros de ruta para sus AWS IoT SiteWise destinos, tenga en cuenta las siguientes estrategias para gestionar sus datos de forma eficaz.
+ Estructura los filtros para que reflejen la jerarquía de dispositivos. Por ejemplo, en un entorno de fabricación`factory/+/machine/#`, captura datos de todas las máquinas de diferentes líneas de producción.
+ Utilice niveles específicos para los tipos, ubicaciones o funciones de los dispositivos. Por ejemplo, `factory/assembly-line/robot/temperature`. O, en la agricultura inteligente`farm/+/crop/+/moisture`, para monitorear los niveles de humedad de varios cultivos en diferentes campos.
+ Aprovecha los comodines de forma estratégica: `+` úsalos para las variaciones de un solo nivel y `#` para capturar todos los niveles subsiguientes. Por ejemplo`building/+/+/energy-consumption`, rastrea el consumo de energía en diferentes zonas y pisos de un edificio. Esto supone que la primera `+` captura todos los pisos y la segunda `+` captura todas las zonas.
+ Equilibre la especificidad y la flexibilidad mediante la creación de filtros que sean lo suficientemente específicos como para capturar datos relevantes, pero lo suficientemente flexibles como para adaptarse a futuros cambios. Por ejemplo, `site/+/equipment-type/+/measurement` permite añadir nuevos sitios o tipos de equipos sin cambiar la estructura del filtro.
Pruebe sus filtros minuciosamente para asegurarse de que capturan los datos previstos y se alinean con la arquitectura y los objetivos de su sistema de IoT.
### Filtros de ruta para servidores OPC UA
En el caso de los servidores OPC UA, los filtros de ruta deben corresponder a los nombres de las etiquetas OPC UA. El nivel final del filtro de ruta debe coincidir exactamente con el nombre de la etiqueta OPC UA. Por ejemplo, si tu etiqueta OPC UA lo es`Device1.Temperature`, es posible que tu filtro de ruta lo sea. `factory/line1/Device1.Temperature` Puede utilizar caracteres comodín en los niveles anteriores, por ejemplo, `factory/+/Device1.Temperature` para capturar la etiqueta en varias líneas de producción. Si tiene caracteres especiales en los nombres de los filtros de ruta, consulte [Caracteres especiales en los nombres de los filtros de ruta](#path-filters-special-characters) para obtener más información.
### Caracteres especiales en los nombres de los filtros de ruta
AWS IoT SiteWise admite caracteres que se utilizan habitualmente en protocolos industriales como OPC UA, que normalmente no están permitidos en los nombres de temas estándar de MQTT. Esta función facilita una integración más fluida de los sistemas industriales con las arquitecturas basadas en MQTT.
**nota**
Si bien nuestro manejo de caracteres especiales es útil para la integración y la migración, se recomienda seguir las convenciones de nomenclatura estándar de MQTT para las nuevas implementaciones siempre que sea posible, a fin de garantizar una compatibilidad más amplia.
Al recibir datos de fuentes industriales, AWS IoT SiteWise normaliza los nombres de los temas mediante la codificación URI para los caracteres especiales:
+ `%`se convierte en `%25` (codificado primero como el carácter de escape)
+ `#` se convertirá en `%23`
+ `+` se convertirá en `%2B`
+ `$`se convierte `%24` (solo cuando está al principio de un tema)
Esta codificación garantiza que los datos de origen que contienen estos caracteres especiales de MQTT se puedan utilizar de forma segura como nombres de temas de MQTT, conservando al mismo tiempo las convenciones de nomenclatura industrial originales.
**Example : Caracteres especiales en los nombres de los filtros de rutas**
Estos son algunos ejemplos de cómo pueden aparecer los nombres de temas industriales en los filtros de AWS IoT SiteWise rutas:
+ `Factory1/Line#2/Sensor+3` se convertirá en `Factory1/Line%232/Sensor%2B3`
+ `Plant%A/Unit$1/Temp` se convertirá en `Plant%25A/Unit%241/Temp`
+ `Site1/#Section/+Node` se convertirá en `Site1/%23Section/%2BNode`
Al crear suscripciones o consultar los nombres de los temas AWS IoT SiteWise, verás las versiones originales sin codificar. La codificación se gestiona automáticamente para garantizar la conformidad con el MQTT.
# Agregue un destino de AWS IoT SiteWise Edge en tiempo real
El tipo de destino en tiempo real le permite transmitir datos de IoT directamente desde sus dispositivos y pasarelas al AWS IoT SiteWise almacenamiento en tiempo real. Esta opción es ideal para casos de uso que requieren la ingesta y el procesamiento inmediatos de los datos a medida que se generan, sin necesidad de almacenarlos en lotes ni almacenarlos en búfer. Solo puede configurar un destino en tiempo real en cada puerta de enlace, ya que transmite datos de forma continua. AWS IoT SiteWise
**nota**
Si se duplica, se TQVs puede duplicar la carga.
**Para añadir un destino en tiempo real**
Utilice la AWS IoT SiteWise consola o añada un destino en tiempo real AWS CLI a su puerta de enlace habilitada para MQTT de SiteWise Edge.
------
#### [ Console ]
1. Abra la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. En el panel de navegación, seleccione **Puertas de enlace Edge**.
1. Seleccione la puerta de enlace a la que desee añadir un destino.
1. En la sección **Destinos**, selecciona **Añadir destino**.
1. En la página **Añadir destino**, introduce los **detalles del destino**:
1. Un nombre para el destino en el campo **Nombre del destino**.
1. Selecciona el **AWS IoT SiteWise tiempo real** para el **tipo de destino**.
1. Configure el orden de publicación de la pasarela configurando el **orden de publicación** para **Publicar primero los datos más antiguos** o **Publicar primero los datos más recientes**. De forma predeterminada, la puerta de enlace publica primero los datos más antiguos.
1. Utilice el **tiempo máximo de espera por lotes** para establecer un tiempo máximo de espera para el publicador antes de enviar un lote de datos AWS IoT SiteWise. Esta configuración se aplica a cada alias. Los datos se almacenan localmente hasta que:
+ Ha transcurrido el tiempo establecido, o
+ Se reciben 10 entradas time-quality-value (TQV) para el alias
La condición que se cumpla primero hace que el lote se envíe a la nube.
1. Para comprimir los datos cargados, active la casilla **Activar la compresión al cargar datos**. Dejar que la puerta de enlace comprima los datos antes de subirlos a la nube reduce el uso de ancho de banda.
1. Para filtrar los datos del editor caducados, selecciona la casilla **Excluir los datos caducados**. Esta selección solo envía los datos activos y actuales a AWS IoT SiteWise.
1. En el campo **Período límite**, introduce la frecuencia con la que los datos deben considerarse caducados en tu conjunto de datos. Puedes determinar si los datos se cuentan en minutos o en días. El período límite mínimo es de cinco minutos. El período límite máximo es de siete días.
1. Si lo desea, configure los ajustes de **almacenamiento local**:
1. Establezca la frecuencia del **período de retención**: la cantidad de tiempo que la puerta de enlace almacena localmente los datos que son anteriores al período límite. El período mínimo de retención es de un minuto.
El período máximo de retención es de 30 días y es superior o igual al período de rotación.
1. Establezca el **período de rotación**: el intervalo de tiempo que se debe especificar al guardar datos anteriores al período límite de un solo archivo. La puerta de enlace transfiere un lote de datos al siguiente directorio local al final de cada periodo de rotación: `/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports`.
La retención debe ser superior a un minuto e igual al período de retención.
1. Indique el valor de la **capacidad de almacenamiento (GB)** para establecer el tamaño máximo de los datos almacenados localmente en GB. Si los datos superan el tamaño máximo de almacenamiento local determinado, la puerta de enlace comienza a eliminar primero los datos más antiguos. La puerta de enlace continúa eliminando hasta que el tamaño de los datos almacenados localmente sea igual o inferior a la cuota.
La capacidad de almacenamiento debe ser superior o igual a un GB.
1. Añada filtros de ruta a su destino. Para obtener más información, consulte, [Agregue filtros de ruta a los destinos de AWS IoT SiteWise Edge](destinations-add-path-filters.md).
Para obtener más información, consulte [Tipos de destino](gw-destinations.md#destination-types).
------
#### [ AWS CLI ]
**Example : Crea un nuevo destino AWS IoT SiteWise en tiempo real**
Utilice la [UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API para configurar el publicador.
Establezca el 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 actualizar un destino AWS IoT SiteWise en tiempo real existente, utilice primero la `DescribeGatewayCapabilityConfiguration` API para encontrar el`destinationId`.
**Example : Actualiza un destino AWS IoT SiteWise en tiempo real**
Utilice la [UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API para configurar el publicador.
Establezca el 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": [
"#"
]
}
}
]
}
]
}
```
Las siguientes opciones de configuración son específicas de las puertas de enlace que utilizan el `iotsitewise:publisher:3` espacio de nombres.
`sources`
Define las fuentes de datos a las que se transferirán los datos de su equipo industrial. AWS IoT SiteWise Para las pasarelas habilitadas para MQTT, utilice. `MQTT`
Tipo: matriz de objetos
Obligatorio: sí
`destinations`
Define dónde enviar los datos. Los destinos se transmiten en tiempo real o se almacenan en búfer mediante Amazon S3. Se requiere al menos un objeto de destino, pero puede añadir una matriz vacía. Puede tener un destino en tiempo real para cada puerta de enlace. Para obtener más información, consulte [Comprenda los destinos de AWS IoT SiteWise Edge](gw-destinations.md#source-destination).
Tipo: matriz de objetos
Obligatorio: sí
`id`
El identificador único del destino. Puede proporcionar un identificador de destino existente o dejarlo en blanco. Si no especificas un ID, se generará un UUID de forma predeterminada.
Tipo: cadena
Requerido: no
`type`
Tipo de destino. Las opciones incluyen: `SITEWISE_REALTIME` y. `SITEWISE_BUFFERED`
+ `SITEWISE_REALTIME`— Envíe los datos directamente al AWS IoT SiteWise almacenamiento en tiempo real.
+ `SITEWISE_BUFFERED`— Envíe los datos a Amazon S3 en lotes en formato Parquet y, a continuación, impórtelos al AWS IoT SiteWise almacenamiento.
Tipo: cadena
Obligatorio: sí
`name`
Un nombre único para el destino.
Tipo: cadena
Obligatorio: sí
`config`
Configuración específica para el tipo de destino en formato JSON. La configuración varía entre destinos en tiempo real y en búfer.
Tipo: objeto
Obligatorio: sí
Orden de publicación
Determina el orden en el que se publican los datos. Los datos se publican en función de su marca de tiempo. Las opciones incluyen `TIME_ORDER` y. `RECENT_DATA`
+ `TIME_ORDER`(predeterminado): publica primero los datos más antiguos.
+ `RECENT_DATA`— Publica primero los datos más recientes.
Tipo: cadena
Requerido: no
Habilite la compresión
Si se establece en`true`, habilita la compresión de datos antes de enviarlos a. AWS IoT SiteWise Dejar que la puerta de enlace comprima los datos antes de subirlos a la nube reduce el uso de ancho de banda. El valor predeterminado es `true`.
Tipo: Booleano
Obligatorio: no
Política de abandono
Define cómo gestionar los datos antiguos.
Tipo: objeto
Obligatorio: no
+ `cutoffAge`
La antigüedad máxima de los datos que se van a publicar se especifica en días, horas y minutos. Por ejemplo, `7d` o `1d7h16m`. Los datos anteriores a los especificados no se envían a AWS IoT SiteWise.
Los datos anteriores al período límite no se publican en la nube. La antigüedad límite debe ser de entre cinco minutos y siete días.
Puede utilizar `m`, `h` y `d` cuando especifique una edad límite. Tenga en cuenta que `m` representa minutos, `h` representa horas y `d` representa días.
Tipo: cadena
Obligatorio: sí
+ `exportPolicy`
Define cómo gestionar los datos que superan la edad límite.
Tipo: objeto
Obligatorio: no
+ `retentionPeriod`
La puerta de enlace SiteWise Edge elimina del almacenamiento local cualquier dato periférico anterior al período límite una vez que se haya almacenado durante el período de retención especificado. El periodo de retención debe ser de entre un minuto y 30 días, y mayor o igual que el periodo de rotación.
Puede utilizar `m`, `h` y `d` cuando especifique un periodo de retención. Tenga en cuenta que `m` representa minutos, `h` representa horas y `d` representa días.
Tipo: cadena
Requerido: no
+ `rotationPeriod`
El intervalo de tiempo en que los datos se procesan por lotes y se guardan en un único archivo que es anterior al periodo límite. La puerta de enlace SiteWise Edge transfiere un lote de datos al siguiente directorio local al final de cada período de rotación:. `/greengrass/v2/work/aws.iot.SiteWiseEdgePublisher/exports` El periodo de rotación debe ser mayor que un minuto y menor o igual que el periodo de retención.
Puede utilizar `m`, `h` y `d` cuando especifique un periodo de rotación. Tenga en cuenta que `m` representa minutos, `h` representa horas y `d` representa días.
Tipo: cadena
Requerido: no
+ `exportSizeLimitGB`
El tamaño máximo permitido de datos almacenados localmente, en GB. Si se supera esta cuota, la puerta de enlace SiteWise Edge comienza a eliminar los primeros datos hasta que el tamaño de los datos almacenados localmente sea igual o inferior a la cuota. El valor de este parámetro debe ser mayor o igual que 1.
Tipo: entero
Obligatorio: no
`maxBatchWaitTime`
Establece un tiempo máximo que debe esperar el publicador antes de enviar un lote de datos a AWS IoT SiteWise. Esta configuración se aplica a cada alias. Los datos se almacenan localmente hasta que:
+ Ha transcurrido el tiempo establecido, o
+ Se reciben 10 entradas time-quality-value (TQV) para el alias
Utilice `m``h`, y `d` para especificar una hora límite. Tenga en cuenta que `m` representa minutos, `h` representa horas y `d` representa días.
Tipo: cadena
Requerido: no
`filters`
Filtros que se van a aplicar a los datos. Se requiere al menos un filtro.
Tipo: cadena
Obligatorio: sí
`type`
Tipo de filtro. Utilice `PATH`.
Tipo: cadena
Obligatorio: sí
`config`
Configuración específica del tipo de filtro en formato JSON. Se requiere al menos un objeto, pero la matriz puede estar vacía.
Tipo: objeto
Obligatorio: sí
+ `paths`
Conjunto de filtros de ruta. Para obtener más información, consulte [Conozca los filtros de ruta para los destinos de AWS IoT SiteWise EdgeEntendimiento de filtros de ruta](gw-destinations.md#destinations-path-filters). La ruta predeterminada es `#`.
Tipo: matriz de cadenas
Obligatorio: sí
------
# Añadir un destino almacenado en AWS IoT SiteWise búfer mediante Amazon S3
El tipo de destino almacenado en búfer te permite ahorrar en costes de ingesta AWS IoT SiteWise si no necesitas los datos en tiempo real. Le permite almacenar temporalmente sus datos de IoT en un bucket de Amazon S3 antes de importarlos AWS IoT SiteWise. O simplemente puede cargar sus datos a S3 para almacenarlos, independientemente de si planea importarlos o no AWS IoT SiteWise. Esto resulta útil para agrupar y almacenar en búfer los datos de sus dispositivos y pasarelas antes de incorporarlos. AWS IoT SiteWise Con esta opción, los datos se cargan en el bucket S3 especificado en formato Parquet con una frecuencia configurada. A continuación, puede importar estos datos al AWS IoT SiteWise almacenamiento para su posterior análisis y procesamiento.
**Para añadir un destino almacenado en búfer mediante Amazon S3**
Utilice la AWS IoT SiteWise consola o AWS CLI añada un destino que almacene datos en búfer mediante Amazon S3 a su puerta de enlace SiteWise Edge.
------
#### [ Console ]
Úselo Consola de administración de AWS para añadir un AWS IoT SiteWise destino almacenado en búfer mediante Amazon S3.
1. Abra la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. En el panel de navegación, seleccione **Puertas de enlace Edge**.
1. Seleccione la puerta de enlace a la que quiere añadir un destino.
1. En la sección **Destinos**, selecciona **Añadir destino**.
1. En la página **Añadir destino**, introduce los **detalles del destino**:
1. Un nombre para el destino en el campo **Nombre del destino**.
1. Seleccione **AWS IoT SiteWise Almacenado en búfer mediante Amazon S3 como Tipo** de **destino.** AWS IoT SiteWise almacenado en búfer mediante Amazon S3 envía los datos a Amazon Simple Storage Service por lotes, en formato Parquet, y después los importa al almacenamiento. AWS IoT SiteWise
1. Introduzca la URL de Amazon S3 de la ubicación en la que desee almacenar los datos de la puerta de enlace. Para buscar la ruta, seleccione **Browse S3**. Una vez agregado un depósito, también puede verlo seleccionando **Ver**.
1. Especifique la frecuencia con la que su puerta de enlace debe cargar datos a Amazon S3 introduciendo un período de tiempo y seleccionando un incremento de tiempo para la **frecuencia de carga de datos**. El valor de frecuencia debe ser superior a 0 e inferior o igual a 30 días.
1. En **Configuración de almacenamiento de datos**, determine qué hacer con los datos de la puerta de enlace después de importarlos a AWS IoT SiteWise. Hay dos decisiones que se deben tomar en relación con el almacenamiento de datos:
+ Si desea copiar los datos importados al AWS IoT SiteWise almacenamiento, active la casilla **Copiar los datos al almacenamiento**. Esta opción duplica los datos importados del bucket de Amazon S3 configurado en el AWS IoT SiteWise almacenamiento.
+ Si decide importar los datos de su bucket de Amazon S3 al AWS IoT SiteWise almacenamiento, también puede especificar si los datos importados se deben eliminar una vez finalizada la importación. Seleccione la casilla **Eliminar datos de Amazon S3** para eliminar la fecha importada del bucket de Amazon S3 configurado después de importarla al AWS IoT SiteWise almacenamiento.
1. Añada filtros de ruta a su destino. Para obtener más información, consulte, [Agregue filtros de ruta a los destinos de AWS IoT SiteWise Edge](destinations-add-path-filters.md).
------
#### [ AWS CLI ]
**Example : Cree un nuevo AWS IoT SiteWise destino almacenado en búfer mediante Amazon S3**
Utilice la [UpdateGatewayCapabilityConfiguration](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateGatewayCapabilityConfiguration.html)API para configurar el publicador.
Establezca el 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 : Actualizar un AWS IoT SiteWise destino almacenado en búfer mediante Amazon S3**
Para actualizar un destino AWS IoT SiteWise en tiempo real existente, utilice primero la `DescribeGatewayCapabilityConfiguration` API para encontrar el. `destinationId`
Espacio de nombres del 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": [
"#"
]
}
}
]
}
]
}
```
Las siguientes opciones de configuración son específicas de las puertas de enlace habilitadas para MQTT que utilizan el espacio de nombres. `iotsitewise:publisher:3`
`sources`
Define las fuentes de datos a las que se transferirán los datos de su equipo industrial. AWS IoT SiteWise Para las pasarelas habilitadas para MQTT, utilice. `MQTT`
Tipo: matriz de objetos
Obligatorio: sí
`destinations`
Define dónde enviar los datos. Los destinos se transmiten en tiempo real o se almacenan en búfer mediante Amazon S3. Se requiere al menos un objeto de destino, pero puede añadir una matriz vacía. Puede tener un destino en tiempo real para cada puerta de enlace. Para obtener más información, consulte [Comprenda los destinos de AWS IoT SiteWise Edge](gw-destinations.md#source-destination).
Tipo: matriz de objetos
Obligatorio: sí
`id`
El identificador único del destino. Puede proporcionar un identificador de destino existente o dejarlo en blanco para que se genere automáticamente un nuevo identificador para el destino.
Tipo: cadena
Requerido: no
`type`
Tipo de destino. Las opciones incluyen: `SITEWISE_REALTIME` y`SITEWISE_BUFFERED`. Elija `SITEWISE_BUFFERED`.
+ `SITEWISE_REALTIME`(predeterminado): envía los datos directamente al AWS IoT SiteWise almacenamiento en tiempo real. Para obtener más información, consulte [Agregue un destino de AWS IoT SiteWise Edge en tiempo real](destinations-real-time.md).
+ `SITEWISE_BUFFERED`— Envíe los datos a Amazon S3 en lotes en formato Parquet y, a continuación, impórtelos al AWS IoT SiteWise almacenamiento.
Tipo: cadena
Obligatorio: sí
`name`
Un nombre único para el destino.
Tipo: cadena
Obligatorio: sí
`config`
Configuración específica para el tipo de destino en formato JSON. La configuración varía entre destinos en tiempo real y en búfer.
Tipo: objeto
Obligatorio: sí
`targetBucketArn`
El ARN del bucket en el que se va a publicar. Elija lo mismo Región de AWS para Amazon S3 AWS IoT SiteWise y para Amazon S3. Si elige un prefijo, debe tener entre 1 y 255 caracteres.
AWS IoT SiteWise, incluida la puerta de enlace, tendrá acceso a todo el bucket de S3 especificado. Recomendamos utilizar un depósito dedicado para la ingesta de datos almacenados en búfer.
Tipo: cadena
Obligatorio: sí
`publishPolicy`
Detalles de la política de publicación.
Tipo: objeto
Obligatorio: sí
`publishFrequency`
La frecuencia con la que la puerta de enlace SiteWise Edge publica en el bucket de Amazon S3. La frecuencia de carga de datos a Amazon S3 debe ser superior a 0 minutos e inferior o igual a 30 días. Puede usar `m``h`, y `d` cuando especifique una frecuencia de publicación, la antigüedad. Tenga en cuenta que `m` representa minutos, `h` representa horas y `d` representa días. El valor predeterminado es 15 minutos.
Tipo: cadena
Obligatorio: sí
`localSizeLimitGB`
El tamaño máximo de los archivos escritos en el disco local en GB. Si se supera este umbral, el publicador publica todos los datos almacenados en el búfer en su destino.
Tipo: entero
Obligatorio: sí
`siteWiseImportPolicy`
Detalles de la política de importación para importar datos a AWS IoT SiteWise.
Tipo: objeto
Obligatorio: sí
`enableSiteWiseStorageImport`
`true`Configúrelo para importar datos de un bucket de Amazon S3 al AWS IoT SiteWise almacenamiento. Inicialmente hace una copia de los datos en AWS IoT SiteWise. A continuación, si se establece en `enableDeleteAfterImport` true, los datos de S3 se eliminan después de copiarlos a AWS IoT SiteWise. Se aplican las implicaciones de precio. El valor predeterminado es `true`.
Tipo: Booleano
Obligatorio: sí
`enableDeleteAfterImport`
`true`Configúrelo para eliminar el archivo del bucket de Amazon S3 después de introducirlo en el AWS IoT SiteWise almacenamiento. El valor predeterminado es `true`.
Tipo: Booleano
Obligatorio: sí
`bulkImportJobRoleArn`
El ARN de la función de IAM que AWS IoT SiteWise asume leer los datos almacenados en búfer de Amazon S3 durante la ingesta de datos. Esta función se utiliza cuando un dispositivo perimetral solicita iniciar el proceso de AWS IoT SiteWise APIs importación masiva.
Si `enableSiteWiseStorageImport` se establece en`true`, este parámetro es obligatorio.
Tipo: cadena
Requerido: no
------
Añada filtros de ruta para su destino. Para obtener más información, consulte [Agregue filtros de ruta a los destinos de AWS IoT SiteWise Edge](destinations-add-path-filters.md).
# Agregue filtros de ruta a los destinos de AWS IoT SiteWise Edge
Agregue filtros de ruta a un destino. Los filtros de ruta utilizan la sintaxis de temas de MQTT, donde `#` es un carácter comodín que coincide con cualquier número de niveles y `+` es un carácter comodín que coincide con un único nivel. Puede añadir varios destinos a una puerta de enlace, cada uno con su propio conjunto de filtros de ruta suscritos a la telemetría de su equipo.
Siemens Industrial Edgelas pasarelas utilizan un prefijo para garantizar la compatibilidad. Para obtener más información, consulte [Prefijos para filtros de ruta](sitewise-edge-on-siemens.md#siemens-path-filters).
------
#### [ Console ]
**Para añadir filtros de ruta**
1. Abra la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. En el panel de navegación, seleccione **Puertas de enlace Edge**.
1. Seleccione la puerta de enlace a la que desee añadir filtros de ruta.
1. En la sección **Filtros de ruta**, en **Agregar destino**, elija **Agregar filtro de ruta**.
1. Introduce el filtro de ruta al que quieres que se suscriba este destino. Puede utilizar caracteres comodín (`#`y`+`) para suscribirse a varias rutas.
1. Seleccione **Añadir filtro de ruta** para añadir el filtro de ruta a la lista.
1. Repita los pasos para añadir filtros de ruta adicionales, si es necesario.
1. Una vez que haya agregado todos los filtros de ruta necesarios, elija **Crear**.
------
#### [ AWS CLI for self-hosted gateways ]
**Example : Configuración del filtro de ruta**
```
{
"destinations": [
{
...
}
],
"filters": [
{
"type": "PATH",
"config": {
"paths": [
"home/+/sensor1/temperature",
"home/livingroom/sensor1/temperature",
"home/livingroom/sensor1/temperature",
"building/#"
]
}
}
]
}
```
------
#### [ AWS CLI for Siemens IEgateways ]
**Example : Configuración de prefijos para filtros de ruta**
Capture todos los datos utilizando los prefijos de datos (`ie/d`) y metadatos (`ie/m`) de cada filtro de ruta.
```
{
"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 los filtros de ruta entre destinos descargando la lista de filtros de ruta. Para obtener más información, consulte [Descargue todos los filtros de rutas de un destino (consola)](destinations-manage.md#destinations-download-list).
## Cargue filtros de ruta de forma masiva
Para cargar filtros de ruta de forma masiva, usa un archivo CSV o de texto. AWS IoT SiteWise elimina automáticamente los duplicados exactos al subir archivos. Por ejemplo, `windfarm/site1/` y `windfarm/site1/` son duplicados exactos los que AWS IoT SiteWise captan porque la cadena es exactamente la misma. Los duplicados parciales no se eliminan y conllevan cargos adicionales. Por ejemplo, `windfarm/#` y `windfarm/site1` son temas que se superponen porque `windfarm/site1` ya están abarcados por. `windfarm/#`
**nota**
Evite los duplicados para evitar cargos adicionales. El archivo cargado debe estar en formato.csv o.txt. No puede contener ningún encabezado y debe constar de una sola columna. En la columna, haz una lista de los filtros de ruta, con cada filtro en una línea independiente. No se debe incluir ninguna otra información en el archivo.
**Requisitos de carga de archivos**
Estos son requisitos de filtro de rutas adicionales.
+ Puede cargar un archivo.csv o.txt. No se admite ningún otro formato de archivo.
+ Los archivos CSV (.csv) no pueden tener encabezados y solo deben contener una columna.
+ Puede tener un filtro de ruta en cada línea.
+ Los archivos cargados no pueden estar vacíos.
+ Cuando se usa `#` como comodín, debe ser el último carácter del filtro de temas. Por ejemplo, `topic/#` o como un carácter independiente por tema en particular. Sin embargo, tenga en cuenta que `#` también se puede usar como un carácter normal dentro de un nombre por tema, como `factory/machine#1/topic`. Para obtener más información consulte [Caracteres especiales en los nombres de los filtros de ruta](gw-destinations.md#path-filters-special-characters)
+ También puedes usar el `+` personaje. Por ejemplo, úselo `factory/+/temp` para obtener todas las temperaturas de las fábricas en lugar de hacerlo `factory/machine2/temp` de `factory/machine3/temp` forma individual.
# Administre los destinos de AWS IoT SiteWise Edge
Tras añadir destinos, puede realizar varias operaciones para gestionarlos, como editar las configuraciones de los destinos, eliminar destinos y gestionar los filtros de rutas.
## Editar un destino
Seleccione el botón de radio situado junto al destino en la tabla y pulse el botón **Editar** para editar un destino.
------
#### [ Console ]
**Para editar un destino mediante la AWS IoT SiteWise consola**
1. Abra la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. En el panel de navegación de la izquierda, selecciona **las puertas de enlace Edge** en la sección **Edge**.
1. Seleccione la puerta de enlace adecuada.
1. En la sección **Destinos**, elija el destino que desee editar y, a continuación, elija **Editar**.
1. Modifica el destino y, a continuación, selecciona **Guardar**.
------
#### [ AWS CLI ]
**Para editar un destino mediante AWS CLI**
+ Puede editar un destino modificando la información de configuración de la capacidad de 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**
No puedes actualizar el destino `type` o`capability-namespace`. Por ejemplo, no puedes cambiar de un tipo de `SITEWISE_REALTIME` a`SITEWISE_BUFFERED`. Puede tener un destino en tiempo real para cada puerta de enlace habilitada para MQTT.
------
## Eliminar un destino
Si ya no necesita un destino, puede eliminarlo de su puerta de enlace SiteWise Edge.
------
#### [ Console ]
**Para eliminar un destino mediante la AWS IoT SiteWise consola**
1. Abra la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. En el panel de navegación de la izquierda, selecciona **las puertas de enlace Edge** en la sección **Edge**.
1. Seleccione la puerta de enlace adecuada.
1. En la sección **Destinos**, elija el destino que desee eliminar y, a continuación, elija **Eliminar**. Aparece una pantalla de confirmación.
1. Para confirmar su elección de eliminar el destino, escriba «eliminar» en el cuadro de confirmación.
------
#### [ AWS CLI ]
**Para eliminar un destino mediante AWS CLI**
+ Elimine la configuración de la capacidad de la puerta de enlace especificando el ID de la puerta de enlace y modificando la configuración de la capacidad para eliminar el destino que desea eliminar.
```
aws iotsitewise update-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--capability-configuration '{
"sources": [
{
"type": "MQTT"
}
],
"destinations": []
}'
```
**nota**
La matriz de destinos puede estar vacía (`[]`), pero el propio objeto de destino debe incluirse en la configuración de la capacidad.
------
## Descargue todos los filtros de rutas de un destino (consola)
Descarga un archivo CSV que contenga todos los filtros de rutas de la AWS IoT SiteWise consola. Puede utilizar una lista descargada de filtros de rutas para compartir fácilmente las listas de filtros de rutas entre los destinos de las puertas de enlace.
**Para descargar un archivo CSV de todos los filtros de rutas mediante la AWS IoT SiteWise consola**
1. Abra la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. En el panel de navegación de la izquierda, selecciona **las puertas de enlace Edge** en la sección **Edge**.
1. Seleccione la puerta de enlace que contiene los filtros de ruta.
1. Elija **Agregar destino** o **Editar destino**.
1. Ve a la sección **Filtros de ruta** y selecciona **Descargar CSV**.
**nota**
El archivo CSV incluye todos los filtros de ruta de un destino concreto, independientemente de los que haya seleccionado de la lista de filtros de ruta.
## Edita un filtro de ruta
Puede editar filtros de ruta individuales para refinar los datos que recibe su destino.
------
#### [ Console ]
Con la AWS IoT SiteWise consola, puede editar cada filtro de ruta individual dentro de cada cuadro de texto correspondiente.
**Para editar un filtro de ruta mediante la AWS IoT SiteWise consola**
1. Abra la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. En el panel de navegación de la izquierda, selecciona **las puertas de enlace Edge** en la sección **Edge**.
1. Seleccione la puerta de enlace que contiene los filtros de ruta.
1. Seleccione el destino apropiado.
1. Elija **Edit (Edición de)**.
1. Seleccione el cuadro de texto de la fila que contiene el filtro de ruta que desee editar.
1. Actualice el texto del filtro de ruta y asegúrese de que la casilla de verificación del filtro de ruta editado esté seleccionada.
1. Seleccione **Save**.
------
#### [ AWS CLI ]
Para editar los filtros de ruta de un destino mediante el AWS CLI, primero recupere la configuración actual, modifíquela y, a continuación, actualícela mediante el `update-gateway-capability-configuration` comando.
**Para editar un filtro de ruta mediante AWS CLI**
1. Recupere la configuración de capacidad actual:
```
aws iotsitewise describe-gateway-capability-configuration \
--gateway-id your-gateway-id \
--capability-namespace "iotsitewise:publisher:3" \
--query "capabilityConfiguration"
```
1. Edite el JSON para modificar los filtros de ruta según sea necesario.
1. Actualice la configuración de la capacidad con los filtros de ruta 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
```
------
## Elimine un filtro de ruta
Puede eliminar los filtros de ruta de un destino para controlar los datos que recibe de las fuentes de MQTT y de las canalizaciones de procesamiento de datos.
------
#### [ Console ]
**Para eliminar un filtro de ruta mediante la consola AWS IoT SiteWise**
1. Abra la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. En el panel de navegación de la izquierda, selecciona **las puertas de enlace Edge** en la sección **Edge**.
1. Seleccione la puerta de enlace que contiene los filtros de ruta.
1. Seleccione el destino apropiado.
1. Elija **Edit (Edición de)**.
1. En la pantalla **Editar destino**, en la sección **Filtros de ruta**, seleccione uno o más filtros de ruta que desee eliminar.
1. Elija **Eliminar**. Aparece un mensaje de confirmación de eliminación. Si desea continuar con la eliminación de los filtros de ruta, seleccione **Eliminar** en la pantalla de confirmación.
------
#### [ AWS CLI ]
**Para eliminar un destino mediante AWS CLI**
+ Elimine un filtro de ruta eliminándolo de la configuración de capacidades.
```
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**
La matriz de filtros puede estar vacía (`[]`), pero el propio objeto de filtros debe incluirse en la configuración de la capacidad.
------