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.
# Gestione los flujos de datos para AWS IoT SiteWise
Un flujo de datos es el recurso que contiene datos históricos de series temporales. Cada flujo de datos se identifica con un alias único, lo que facilita el seguimiento del origen de cada dato. Los flujos de datos se crean automáticamente AWS IoT SiteWise cuando se reciben los primeros datos de series temporales. Si los datos de la primera serie temporal se identifican con un alias, AWS IoT SiteWise crea un nuevo flujo de datos con ese alias, siempre que a ninguna propiedad de activo se le haya asignado ese alias. Como alternativa, si los datos de la primera serie temporal se identifican con un identificador de activo y un identificador de propiedad, AWS IoT SiteWise crea un nuevo flujo de datos y lo asocia a la propiedad del activo.
Hay dos formas de asignar un alias a una propiedad de un activo. El método utilizado depende de si los datos se envían AWS IoT SiteWise primero o si se crea primero un activo.
+ Si los datos se envían AWS IoT SiteWise primero, se crea automáticamente un flujo de datos con el alias asignado. Cuando el activo se cree más adelante, utilice la [ AssociateTimeSeriesToAssetProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_AssociateTimeSeriesToAssetProperty.html)API para asociar el flujo de datos y su alias a la propiedad del activo.
+ Si primero se crea un activo, utilice la [ UpdateAssetProperty](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_UpdateAssetProperty.html)API para asignar un alias a una propiedad del activo. Cuando los datos se envíen posteriormente a AWS IoT SiteWise, el flujo de datos se crea automáticamente y se asocia a la propiedad del activo.
Actualmente, solo puede asociar flujos de datos con mediciones. Las *Mediciones* son un tipo de propiedad de activo que representan flujos de datos de sensores sin procesar de los dispositivos, como valores de temperatura con marca de tiempo o valores de revoluciones por minuto (RPM) con marca de tiempo.
Cuando estas mediciones definen métricas o transformaciones, los datos entrantes desencadenan cálculos específicos. Es importante tener en cuenta que una propiedad de activo solo se puede enlazar a un flujo de datos a la vez.
AWS IoT SiteWise utiliza `TimeSeries` el recurso Amazon Resource Name (ARN) para determinar los cargos de almacenamiento. Para obtener más información, consulte [AWS IoT SiteWise Precios](https://aws.amazon.com/iot-sitewise/pricing/).
En las siguientes secciones, se muestra cómo utilizar la AWS IoT SiteWise consola o la API para gestionar los flujos de datos.
**Topics**
+ [
# Configuración de permisos y ajustes
](manage-data-streams-configuration.md)
+ [
# Asocie un flujo de datos a una propiedad de un activo
](manage-data-streams-method.md)
+ [
# Desasocie un flujo de datos de una propiedad de activo
](disassociate-data-streams-method.md)
+ [
# Eliminación de un flujo de datos
](delete-data-streams-method.md)
+ [
# Actualice el alias de una propiedad de un activo
](update-data-streams-method.md)
+ [
# Escenarios habituales
](data-ingestion-scenarios.md)
# Configuración de permisos y ajustes
Los flujos de datos se crean automáticamente AWS IoT SiteWise cuando se reciben los primeros datos de series temporales. Si los datos ingeridos no están asociados a una propiedad de activo, AWS IoT SiteWise crea un nuevo flujo de datos disociado que se puede configurar para asociarse a una propiedad de activo. Configure el control de acceso de la puerta de enlace a AWS IoT SiteWise la que se envían los datos mediante políticas de IAM para especificar el tipo de datos que se van a ingerir.
La siguiente política de IAM desactiva la ingesta de datos disociados de la puerta de enlace y, al mismo tiempo, permite la ingesta de datos a los flujos de datos asociados a una propiedad de activo:
**Example Política de usuario de IAM que desactiva la ingesta disociada de datos desde la puerta de enlace**
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "AllowPutAssetPropertyValuesUsingAssetIdAndPropertyId",
"Effect": "Allow",
"Action": "iotsitewise:BatchPutAssetPropertyValue",
"Resource": "arn:aws:iotsitewise:*:*:asset/*"
},
{
"Sid": "AllowPutAssetPropertyValuesUsingAliasWithAssociatedAssetProperty",
"Effect": "Allow",
"Action": "iotsitewise:BatchPutAssetPropertyValue",
"Resource": "arn:aws:iotsitewise:*:*:time-series/*",
"Condition": {
"StringLikeIfExists": {
"iotsitewise:isAssociatedWithAssetProperty": "true"
}
}
},
{
"Sid": "DenyPutAssetPropertyValuesUsingAliasWithNoAssociatedAssetProperty",
"Effect": "Deny",
"Action": "iotsitewise:BatchPutAssetPropertyValue",
"Resource": "arn:aws:iotsitewise:*:*:time-series/*",
"Condition": {
"StringLikeIfExists": {
"iotsitewise:isAssociatedWithAssetProperty": "false"
}
}
}
]
}
```
**Example Política de usuario de IAM que desactiva toda la ingesta de datos desde la puerta de enlace**
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Sid": "DenyPutAssetPropertyValues",
"Effect": "Deny",
"Action": "iotsitewise:BatchPutAssetPropertyValue",
"Resource": [
"arn:aws:iotsitewise:*:*:asset/*",
"arn:aws:iotsitewise:*:*:time-series/*"
]
}
]
}
```
# Asocie un flujo de datos a una propiedad de un activo
Administre sus flujos de datos con Consola de AWS IoT SiteWise o AWS CLI.
------
#### [ Console ]
Utilice la AWS IoT SiteWise consola para gestionar sus flujos de datos.
**Para administrar flujos de datos (consola)**
1. Vaya a la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. En el panel de navegación, seleccione **Flujos de datos**.
1. Elija un flujo de datos filtrando por el alias del flujo de datos o seleccionando **Flujos de datos diasociados** en el menú desplegable de filtros.
1. Seleccione el flujo de datos que desee actualizar. Puede seleccionar varios flujos de datos. Haga clic en **Administrar flujos de datos** en la esquina superior derecha.
1. Seleccione el flujo de datos que desee asociar en **Actualizar asociaciones de flujos de datos** y haga clic en el botón **Elegir medición**.
1. En la sección **Elegir medición**, busque la propiedad de medición de activos correspondiente. Seleccione la medida y, a continuación, haga clic en **Elegir**.
1. Realice los pasos 4 y 5 para otros flujos de datos seleccionados en el paso 3. Asigne propiedades de activos a todos los flujos de datos.
1. Elija **Actualizar** para confirmar los cambios. Aparece un cartel de confirmación de que la actualización se ha realizado correctamente.
------
#### [ AWS CLI ]
Para asociar un flujo de datos (identificado por su alias) a una propiedad de activo (identificada por su IDs), ejecute el siguiente comando:
```
aws iotsitewise associate-time-series-to-asset-property \
--alias \
--assetId \
--propertyId
```
------
# Desasocie un flujo de datos de una propiedad de activo
------
#### [ Console ]
Utilice la AWS IoT SiteWise consola para desasociar el flujo de datos de una propiedad de activo.
**Para desasociar los flujos de datos de una propiedad de activo (consola)**
1. Vaya a la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. En el panel de navegación, seleccione **Flujos de datos**.
1. Elija un flujo de datos filtrando por el alias del flujo de datos o seleccionando **Flujos de datos asociados** en el menú desplegable del filtro.
1. Seleccione el flujo de datos que desee desasociar. La columna de **alias del flujo de datos** debe contener un alias. Las columnas **Nombre del activo** **y Nombre de la propiedad del** activo deben contener los valores de la propiedad del activo a la que está asociado el flujo de datos. Puede seleccionar varios flujos de datos.
1. Haga clic en **Administrar flujos de datos** en la esquina superior derecha.
1. En la sección **Actualizar asociaciones de flujos de datos**, haga clic en la **X** de la columna **Nombre de la medición**. Debería aparecer un `submitted` estado en la columna **Estado**.
1. Seleccione **Actualizar** para confirmar los cambios. El flujo de datos ahora está disociado de la propiedad del activo y el alias se utiliza ahora para identificar el flujo de datos.
------
#### [ AWS CLI ]
Para desasociar un flujo de datos de una propiedad de activo (identificada por su `ID` s y su alias), ejecute el siguiente comando:
```
aws iotsitewise disassociate-time-series-from-asset-property \
--alias \
--assetId \
--propertyId
```
El flujo de datos ahora está disociado de la propiedad del activo y el alias se utiliza para identificar el flujo de datos. El alias ya no está asociado a la propiedad del activo, ya que ahora está asociado al flujo de datos.
------
# Eliminación de un flujo de datos
Cuando se elimina una propiedad de un modelo de activos, AWS IoT SiteWise elimina las propiedades y sus flujos de datos de todos los activos gestionados por el modelo de activos. También elimina todas las propiedades y sus flujos de datos de un activo cuando se elimina el activo. Si se deben conservar los datos de un flujo de datos, se deben disociar de la propiedad del activo antes de eliminarlos.
**aviso**
Cuando se elimina una propiedad de un activo, también se elimina el flujo de datos asociado. Para conservar el flujo de datos, desasócielo primero de la propiedad del activo, antes de eliminar la propiedad del modelo de activo o eliminar el activo.
------
#### [ Console ]
Utilice la AWS IoT SiteWise consola para desasociar el flujo de datos de una propiedad de activo.
**Para eliminar un flujo de datos (consola)**
1. Vaya a la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. En el panel de navegación, seleccione **Flujos de datos**.
1. Elija un flujo de datos filtrando el alias del flujo de datos.
1. Seleccione el flujo de datos que desee eliminar. Puede seleccionar varios flujos de datos.
1. Pulse el botón **Eliminar** para eliminar el flujo de datos.
------
#### [ AWS CLI ]
Utilice la [ DeleteTimeSeries](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DeleteTimeSeries.html)API para eliminar un flujo de datos específico por su alias.
```
aws iotsitewise delete-time-series \
--alias
```
------
# Actualice el alias de una propiedad de un activo
Los alias deben ser únicos dentro de una AWS región. Esto incluye los alias de las propiedades de los activos y de los flujos de datos. No asigne un alias a una propiedad de un activo si otra propiedad o flujo de datos utiliza ese alias.
------
#### [ Console ]
Utilice la AWS IoT SiteWise consola para actualizar el alias de una propiedad de un activo.
**Para actualizar el alias de una propiedad de un activo (consola)**
1. Vaya a la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. En el panel de navegación, elija **Activos**.
1. Seleccione el activo de la tabla.
1. Haga clic en el botón **Edit (Editar)**.
1. Seleccione el **tipo de propiedad** en la tabla de **propiedades**.
1. Busque la propiedad y escriba el nuevo alias en el campo de texto del alias de la propiedad.
1. Haga clic en el botón **Guardar** para guardar los cambios.
------
#### [ AWS CLI ]
Para actualizar un alias en una propiedad de un activo, ejecute el siguiente comando:
```
aws iotsitewise update-asset-property \
--asset-id \
--property-id \
--property-alias \
--property-notification-state
```
**nota**
Si las notificaciones de propiedades están habilitadas actualmente, se deben volver a proporcionar para garantizar que sigan activadas.
------
# Escenarios habituales
## Mover un flujo de datos
Para cambiar la asociación de un flujo de datos con otra propiedad del activo, primero desasocie el flujo de datos de la propiedad del activo actual. Al disociar un flujo de datos de una propiedad de activo, debe haber un alias asignado a esa propiedad de activo.
```
aws iotsitewise disassociate-time-series-from-asset-property \
--alias \
--assetId \
--propertyId
```
Ahora reasigne el flujo de datos a la nueva propiedad del activo.
```
aws iotsitewise associate-time-series-from-asset-property \
--alias \
--assetId \
--propertyId
```
## Error al asignar un alias a una propiedad de activo
Al utilizar la `UpdateAssetProperty` API para asignar un alias a una propiedad, es posible que aparezca el siguiente mensaje de error:
```
Given alias for property with ID already in use by another property or data stream
```
Este mensaje de error indica que el alias no está asignado a la propiedad porque lo usa actualmente otra propiedad o un flujo de datos.
Esto ocurre si los datos se ingieren AWS IoT SiteWise con un alias. Cuando los datos se envían con un alias que no está siendo utilizado por otro flujo de datos o propiedad de activo, se crea un nuevo flujo de datos con ese alias. Las dos opciones siguientes resuelven el problema.
+ Utilice la `AssociateTimeSeriesToAssetProperty` API para asociar el flujo de datos con su alias a la propiedad del activo.
+ Detenga temporalmente la ingesta de datos y elimine el flujo de datos. Utilice la `UpdateAssetProperty` API para asignar el alias a la propiedad del activo y, a continuación, vuelva a activar la ingesta de datos.
## Error al asociar un flujo de datos a una propiedad de activo
Al asociar un flujo de datos a una propiedad de un activo, aparece el siguiente mensaje de error.
```
assetProperty with assetId propertyId contains data
```
Este mensaje de error indica que la propiedad del activo ya está asociada a un flujo de datos que contiene datos. Ese flujo de datos debe disociarse o eliminarse antes de asociar otro flujo de datos a esa propiedad del activo.
**nota**
Al disociar un flujo de datos de una propiedad de activo, el alias asignado a la propiedad se asigna al flujo de datos. Para que ese alias permanezca asignado a la propiedad, asigne un nuevo alias a esa propiedad antes de disociar el flujo de datos.
Para conservar los datos almacenados en la propiedad del activo, haga lo siguiente:
+ Asegúrese de que no se ingieran datos en la propiedad del activo para evitar la creación de un nuevo flujo de datos.
+ Utilice la `UpdateAssetProperty` API para establecer un nuevo alias que se asigne al flujo de datos actualmente asignado.
+ Utilice la `DisassociateTimeSeriesFromAssetProperty` API para desasociar el flujo de datos actual de la propiedad del activo.
+ Utilice la `AssociateTimeSeriesToAssetProperty` API para asociar el flujo de datos deseado a la propiedad del activo.
Si se deben eliminar los datos almacenados en la propiedad del activo, haga lo siguiente:
+ Asegúrese de que no se ingiera ningún dato a la propiedad del activo para evitar la creación de un nuevo flujo de datos.
+ Utilice `DeleteTimeSeries` la API para eliminar el flujo de datos actualmente asignado.
+ Utilice la `AssociateTimeSeriesToAssetProperty` API para asociar el flujo de datos deseado a la propiedad del activo.