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 el almacenamiento de datos en AWS IoT SiteWise
Puede configurarlo AWS IoT SiteWise para guardar sus datos en los siguientes niveles de almacenamiento:
**Nivel de acceso frecuente**
El nivel de almacenamiento activo es un almacenamiento de series temporales AWS IoT SiteWise gestionado. El nivel activo es más eficaz para los datos a los que se accede con frecuencia, con baja write-to-read latencia. Los datos almacenados en el nivel de acceso frecuente son utilizados por aplicaciones industriales que necesitan acceso rápido a los valores más recientes de las mediciones de sus equipos. Esto incluye aplicaciones que visualizan métricas en tiempo real con un panel interactivo o aplicaciones que supervisan las operaciones y activan alarmas para identificar problemas de rendimiento.
De forma predeterminada, los datos ingresados AWS IoT SiteWise se almacenan en la capa activa. Puede definir un período de retención para el nivel activo, tras el cual AWS IoT SiteWise se transfieren los datos del nivel activo a un almacenamiento de nivel caliente o frío, según su configuración. Para obtener el mejor rendimiento y rentabilidad, configure el período de retención del nivel de acceso frecuente para que sea más largo que el tiempo que se tarda en recuperar los datos con frecuencia. Esto se usa para métricas, alarmas y escenarios de supervisión en tiempo real. Si no se establece un período de retención, sus datos se almacenarán indefinidamente en el nivel de acceso frecuente.
**Nivel de acceso semiactivo**
El nivel de almacenamiento en caliente es un nivel AWS IoT SiteWise administrado que resulta eficaz para el almacenamiento rentable de datos históricos. Se utiliza mejor para recuperar grandes volúmenes de datos con características de write-to-read latencia media. Utilice el nivel de acceso semiactivo para almacenar datos históricos que se necesitan para grandes cargas de trabajo. Por ejemplo, se utiliza para la recuperación de datos para análisis, aplicaciones de inteligencia empresarial (BI), herramientas de elaboración de informes y entrenamiento de modelos de machine learning (ML). Si habilita el nivel de almacenamiento de acceso inactivo, puede definir un período de retención del nivel de acceso semiactivo. Una vez finalizado el período de retención, AWS IoT SiteWise elimina los datos del nivel cálido.
**Nivel inactivo**
El nivel de almacenamiento de acceso inactivo utiliza un bucket de Amazon S3 para almacenar datos que se utilizan con poca frecuencia. Con el nivel de acceso inactivo, AWS IoT SiteWise replica las series temporales, incluidas mediciones, transformaciones y agregados, así como las definiciones del modelo de activos, cada 6 horas. El nivel de acceso inactivo se utiliza para almacenar datos que toleran una latencia de alta lectura para informes históricos y copias de seguridad.
**Topics**
+ [Configure los ajustes de almacenamiento en AWS IoT SiteWise](configure-storage.md)
+ [Solucionar problemas de configuración de almacenamiento para AWS IoT SiteWise](troubleshoot-storage-configuration.md)
+ [Rutas de archivos y esquemas de datos guardados en el nivel inactivo](file-path-and-schema.md)
# Configure los ajustes de almacenamiento en AWS IoT SiteWise
Puede configurar ajustes de almacenamiento para habilitar el almacenamiento de nivel de acceso semiactivo administrado por el servicio y también para replicar los datos en el nivel de acceso inactivo. Para obtener más información sobre el período de retención de los niveles de acceso semiactivo y frecuente, consulte [Impacto en la retención de datos](#retention-period). Al configurar los ajustes de almacenamiento, haga lo siguiente:
+ **Retención en la capa** activa: establece un período de retención durante el cual tus datos se almacenan en la capa activa antes de que se eliminen y se transfieran al almacenamiento en capa caliente o almacenamiento en capa fría gestionado por el servicio en función de tu configuración de almacenamiento. AWS IoT SiteWise eliminará todos los datos de la capa activa que existieran antes de que finalice el período de retención. Si no establece un período de retención, sus datos se almacenan indefinidamente en el nivel de acceso frecuente.
+ **Retención en la capa cálida**: establece un período de retención para el tiempo que tus datos permanecerán almacenados en la capa cálida antes de que se eliminen del AWS IoT SiteWise almacenamiento y se trasladen al almacenamiento en la capa fría gestionada por el cliente. AWS IoT SiteWise elimina todos los datos de la capa cálida que existían antes de que finalizara el período de retención. Si no se establece un período de retención, sus datos se almacenan indefinidamente en el nivel de acceso semiactivo.
**nota**
Para mejorar el rendimiento de las consultas, establezca un período de retención de nivel de acceso activo con almacenamiento de nivel de acceso semiactivo.
## Impacto de la retención de datos en el almacenamiento de nivel de acceso activo y semiactivo
+ Al reducir el período de retención del almacenamiento de nivel de acceso activo, los datos se transfieren permanentemente del nivel de acceso activo al nivel de acceso semiactivo o inactivo. Al reducir el período de retención del almacenamiento de nivel de acceso semiactivo, los datos se transfieren permanentemente del nivel de acceso inactivo y se eliminan permanentemente del nivel de acceso semiactivo.
+ Al aumentar el período de retención del almacenamiento de nivel caliente o caliente, el cambio afecta a los datos que se envíen a AWS IoT SiteWise partir de ese momento. AWS IoT SiteWise no recupera los datos del almacenamiento caliente o frío para poblarlos en el nivel activo. Por ejemplo, si el período de retención del almacenamiento de nivel de acceso activo se establece inicialmente en 30 días y más tarde se aumenta a 60 días, el almacenamiento de nivel de acceso activo tarda 30 días en contener datos de 60 días.
**Topics**
+ [Impacto de la retención de datos en el almacenamiento de nivel de acceso activo y semiactivo](#retention-period)
+ [Configuración de ajustes de almacenamiento para el nivel de acceso semiactivo (consola)](#configure-storage-console-warm)
+ [Configuración de ajustes de almacenamiento para el nivel de acceso semiactivo (AWS CLI)](#configure-storage-cli-warm)
+ [Configuración de ajustes de almacenamiento para el nivel de acceso inactivo (consola)](#configure-storage-console)
+ [Configuración de ajustes de almacenamiento para el nivel de acceso inactivo (AWS CLI)](#configure-storage-cli)
## Configuración de ajustes de almacenamiento para el nivel de acceso semiactivo (consola)
El siguiente procedimiento muestra cómo configurar los ajustes de almacenamiento para replicar los datos en el nivel caliente de la AWS IoT SiteWise consola.
**Para configurar los parámetros de disponibilidad en la consola**
1. Vaya a la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. En el panel de navegación, en **Configuración**, seleccione **Listas**.
1. En la esquina superior derecha, elija **Edit (Editar)**.
1. En la página **Editar acción**, haga lo siguiente:
1. En **Configuración del nivel caliente**, haga lo siguiente:
+ Si quiere establecer un período de retención durante el cual se almacenen sus datos en el nivel de acceso frecuente antes de que se eliminen y transfieran al almacenamiento de nivel de acceso semiactivo administrado por el servicio, elija **Habilitar período de retención**.
+ Para configurar un período de retención, introduzca un número entero y elija una unidad. El periodo de retención debe ser mayor o igual a 30 días.
AWS IoT SiteWise elimina todos los datos del nivel activo que sean anteriores al período de retención. Si no establece un período de retención, sus datos se almacenarán indefinidamente.
1. (Recomendado) Para **Configuración de nivel cálido**, haga lo siguiente:
+ Para suscribirse al almacenamiento en el nivel de acceso frecuente, seleccione **Confirmo la suscripción al almacenamiento de nivel cálido**.
+ (Opcional) Para configurar un período de retención, introduzca un número entero y elija una unidad. El periodo de retención debe ser mayor o igual a 365 días.
AWS IoT SiteWise elimina los datos del nivel cálido que existían antes del período de retención. Si no establece un período de retención, sus datos se almacenarán indefinidamente.
**nota**
Si se suscribe al nivel de acceso semiactivo, la configuración se muestra solo una vez.
Para configurar la retención de nivel de acceso frecuente debe tener almacenamiento de nivel de acceso semiactivo o inactivo. Para lograr una mayor rentabilidad y recuperar datos históricos, se AWS IoT SiteWise recomienda almacenar los datos a largo plazo en el nivel cálido.
Para configurar la retención de nivel de acceso semiactivo debe tener almacenamiento de nivel de acceso inactivo.
1. Seleccione **Guardar** para guardar la configuración de almacenamiento.
En la sección **Almacenamiento de AWS IoT SiteWise **, el **Almacenamiento en el nivel cálido** se encuentra en uno de los siguientes estados:
+ **Habilitado**: si los datos existían antes del período de retención del nivel de acceso activo, AWS IoT SiteWise los mueve al nivel de acceso semiactivo.
+ **Deshabilitado**: el almacenamiento de nivel semiactivo está deshabilitado.
## Configuración de ajustes de almacenamiento para el nivel de acceso semiactivo (AWS CLI)
Puede configurar los ajustes de almacenamiento para mover los datos al nivel cálido mediante AWS CLI los siguientes comandos.
Para evitar anular la configuración existente, recupere la información de configuración de almacenamiento actual ejecutando el siguiente comando:
```
aws iotsitewise describe-storage-configuration
```
**Example respuesta sin configuración de nivel de acceso inactivo existente**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"disassociatedDataStorage": "ENABLED",
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2021-10-14T15:53:35-07:00",
"warmTier": "DISABLED"
}
```
**Example respuesta con configuración de nivel de acceso inactivo existente**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/",
"roleArn": "arn:aws:iam::aws-account-id:role/role-name"
}
},
"disassociatedDataStorage": "ENABLED",
"retentionPeriod": {
"numberOfDays": retention-in-days
},
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2023-10-25T15:59:46-07:00",
"warmTier": "DISABLED"
}
```
### Configure los ajustes de almacenamiento para el nivel cálido con AWS CLI
Ejecute el comando siguiente para configurar los ajustes de almacenamiento. `file-name`Sustitúyalo por el nombre del archivo que contiene la configuración AWS IoT SiteWise de almacenamiento.
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
**Example AWS IoT SiteWise configuración con niveles caliente y cálido**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"disassociatedDataStorage": "ENABLED",
"warmTier": "ENABLED",
"retentionPeriod": {
"numberOfDays": hot-tier-retention-in-days
}
}
```
`hot-tier-retention-in-days` debe ser un número entero mayor o igual que 30 días.
**Example response**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
Si tiene habilitado el almacenamiento de nivel de acceso inactivo, consulte [Configure los ajustes de almacenamiento con AWS CLI un nivel frío existente](#configure-storage-cli-existing-cold).
### Configure los ajustes de almacenamiento con AWS CLI un nivel frío existente
**Configure los ajustes de almacenamiento utilizando AWS CLI el almacenamiento en capa fría existente**
+ Ejecute el comando siguiente para configurar los ajustes de almacenamiento. Sustituya *file-name* por el nombre del archivo que contiene la configuración de almacenamiento de AWS IoT SiteWise .
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
**Example AWS IoT SiteWise configuración de almacenamiento**
+ Reemplace *amzn-s3-demo-bucket* por el nombre de su bucket de Amazon S3.
+ *prefix*Sustitúyalo por el prefijo de Amazon S3.
+ *aws-account-id*Sustitúyalo por tu ID AWS de cuenta.
+ *role-name*Sustitúyalo por el nombre del rol de acceso de Amazon S3 que permite AWS IoT SiteWise enviar datos a Amazon S3.
+ *hot-tier-retention-in-days*Sustitúyalo por un número entero mayor o igual a 30 días.
+ *warm-tier-retention-in-days*Sustitúyalo por un número entero mayor o igual a 365 días.
**nota**
AWS IoT SiteWise eliminará todos los datos de la capa cálida que sean anteriores al período de retención de la capa fría. Si no establece un período de retención, sus datos se almacenarán indefinidamente.
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/",
"roleArn": "arn:aws:iam::aws-account-id:role/role-name"
}
},
"disassociatedDataStorage": "ENABLED",
"retentionPeriod": {
"numberOfDays": hot-tier-retention-in-days
},
"warmTier": "ENABLED",
"warmTierRetentionPeriod": {
"numberOfDays": warm-tier-retention-in-days
}
}
```
**Example response**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
## Configuración de ajustes de almacenamiento para el nivel de acceso inactivo (consola)
El siguiente procedimiento muestra cómo configurar los ajustes de almacenamiento para replicar los datos en la capa fría de la AWS IoT SiteWise consola.
**Para configurar los parámetros de disponibilidad en la consola**
1. Vaya a la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).
1. En el panel de navegación, en **Configuración**, seleccione **Listas**.
1. En la esquina superior derecha, elija **Edit (Editar)**.
1. En la página **Editar acción**, haga lo siguiente:
1. En la **Configuración de almacenamiento**, seleccione **Habilitar el almacenamiento en el nivel inactivo**. El almacenamiento en el nivel inactivo está desactivado de forma predeterminada.
1. En **Ubicación del bucket de S3**, introduzca el nombre de un bucket de Amazon S3 existente y un prefijo.
**nota**
Amazon S3 utiliza el prefijo como nombre de carpeta en el bucket de Amazon S3. El prefijo debe tener entre 1 y 255 caracteres y terminar con una barra diagonal (/). Sus AWS IoT SiteWise datos se guardan en esta carpeta.
Si no dispone de un bucket de Amazon S3, seleccione **Ver** y, a continuación, cree uno en la consola de Amazon S3. Para obtener más información, consulte [Creación del primer bucket de S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html#creating-bucket) en la *Guía del usuario de Amazon S3*.
1. Para **rol de acceso a S3**, realice una de las operaciones siguientes:
+ Si selecciona **Crear un rol a partir de una plantilla AWS gestionada**, crea AWS automáticamente un rol de IAM que permite AWS IoT SiteWise enviar datos a Amazon S3.
+ Elija **Usar un rol existente** y, a continuación, elija el rol que creó de la lista.
**nota**
Debe usar el mismo nombre de bucket de Amazon S3 para la **Ubicación del bucket de S3** que utilizó en el paso anterior y en su política de IAM.
Asegúrese de que el rol tenga los permisos que se muestran en el siguiente ejemplo.
**Example política de permisos:**
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
Sustituya amzn-s3-demo-bucket por el nombre de su bucket de Amazon S3.
Si el bucket de Amazon S3 se cifra con una clave de KMS gestionada por el cliente, la clave de KMS debe tener una política de acceso con una función de IAM para `kms:Decrypt` las `kms:GenerateDataKey` operaciones.
1. Para configurar el nivel de acceso frecuente, consulte el paso 5 en [Configuración de ajustes de almacenamiento para el nivel de acceso semiactivo (consola)](#configure-storage-console-warm).
1. (Opcional) Para la **integración de AWS IoT Analytics **, haga lo siguiente.
**nota**
Aviso de fin del soporte: el 15 de diciembre de 2025, AWS finalizará el soporte para AWS IoT Analytics. Después del 15 de diciembre de 2025, ya no podrás acceder a la AWS IoT Analytics consola ni a AWS IoT Analytics los recursos. Para obtener más información, consulta [AWS IoT Analytics el fin del soporte](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html).
1. Si desea utilizarlos AWS IoT Analytics para consultar sus datos, elija **Almacén de AWS IoT Analytics datos activado**.
1. AWS IoT SiteWise genera un nombre para el banco de datos o puede introducir un nombre diferente.
AWS IoT SiteWise crea automáticamente un almacén de datos AWS IoT Analytics para guardar sus datos. Para consultar los datos, puede utilizarlos AWS IoT Analytics para crear conjuntos de datos. Para obtener más información, consulte [Trabajar con AWS IoT SiteWise datos](https://docs.aws.amazon.com/iotanalytics/latest/userguide/dataset-itsw.html) en la *Guía del AWS IoT Analytics usuario*.
1. Seleccione **Save**.
En la sección **Almacenamiento de AWS IoT SiteWise **, el **Almacenamiento en el nivel inactivo** puede tener uno de los siguientes valores:
+ **Habilitado**: AWS IoT SiteWise replica los datos en el bucket de Amazon S3 especificado.
+ **Habilitación**: AWS IoT SiteWise está procesando su solicitud para habilitar el almacenamiento en capas frías. Este proceso puede tardar varios minutos en completarse.
+ **Enable\$1Failed: no** se ha AWS IoT SiteWise podido procesar tu solicitud para habilitar el almacenamiento en capa fría. Si has habilitado AWS IoT SiteWise el envío de registros a Amazon CloudWatch Logs, puedes usar estos registros para solucionar problemas. Para obtener más información, consulte [Supervise con Amazon CloudWatch Logs](monitor-cloudwatch-logs.md).
+ **Deshabilitado**: el almacenamiento en el nivel inactivo está desactivado.
## Configuración de ajustes de almacenamiento para el nivel de acceso inactivo (AWS CLI)
El siguiente procedimiento muestra cómo configurar los ajustes de almacenamiento para replicar datos en el nivel inactivo mediante AWS CLI.
**Para configurar los ajustes de almacenamiento mediante AWS CLI**
1. Para exportar datos a un bucket de Amazon S3 en su cuenta, ejecute el siguiente comando para configurar los ajustes de almacenamiento. *file-name*Sustitúyalo por el nombre del archivo que contiene la configuración AWS IoT SiteWise de almacenamiento.
```
aws iotsitewise put-storage-configuration --cli-input-json file://file-name.json
```
**Example AWS IoT SiteWise configuración de almacenamiento**
+ Reemplace *amzn-s3-demo-bucket* por el nombre de su bucket de Amazon S3.
+ *prefix*Sustitúyalo por el prefijo de Amazon S3.
+ *aws-account-id*Sustitúyalo por tu ID AWS de cuenta.
+ *role-name*Sustitúyalo por el nombre del rol de acceso de Amazon S3 que permite AWS IoT SiteWise enviar datos a Amazon S3.
+ *retention-in-days*Sustitúyalo por un número entero que sea mayor o igual a 30 días.
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/prefix/",
"roleArn": "arn:aws:iam::aws-account-id:role/role-name"
}
},
"retentionPeriod": {
"numberOfDays": retention-in-days,
"unlimited": false
}
}
```
**nota**
Debe usar el mismo nombre de bucket de Amazon S3 en la configuración de AWS IoT SiteWise almacenamiento y en la política de IAM.
Asegúrese de que el rol tenga los permisos que se muestran en el siguiente ejemplo.
**Example política de permisos:**
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
Sustituya amzn-s3-demo-bucket por el nombre de su bucket de Amazon S3.
Si el bucket de Amazon S3 se cifra con una clave de KMS gestionada por el cliente, la clave de KMS debe tener una política de acceso con una función de IAM para `kms:Decrypt` las `kms:GenerateDataKey` operaciones.
**Example response**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"retentionPeriod": {
"numberOfDays": 100,
"unlimited": false
},
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
**nota**
La actualización de la configuración de AWS IoT SiteWise almacenamiento puede tardar unos minutos.
1. Para recuperar la información de configuración del almacenamiento, ejecute el siguiente comando.
```
aws iotsitewise describe-storage-configuration
```
**Example response**
```
{
"storageType": "MULTI_LAYER_STORAGE",
"multiLayerStorage": {
"customerManagedS3Storage": {
"s3ResourceArn": "arn:aws:s3:::amzn-s3-demo-bucket/torque/",
"roleArn": "arn:aws:iam::123456789012:role/SWAccessS3Role"
}
},
"retentionPeriod": {
"numberOfDays": 100,
"unlimited": false
},
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2021-03-30T15:54:14-07:00"
}
```
1. Para detener la exportación de datos al bucket de Amazon S3, ejecute el siguiente comando para configurar los ajustes de almacenamiento.
```
aws iotsitewise put-storage-configuration --storage-type SITEWISE_DEFAULT_STORAGE
```
**nota**
De forma predeterminada, los datos solo se almacenan en la capa activa de AWS IoT SiteWise.
**Example response**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"configurationStatus": {
"state": "UPDATE_IN_PROGRESS"
}
}
```
1. Para recuperar la información de configuración del almacenamiento, ejecute el siguiente comando.
```
aws iotsitewise describe-storage-configuration
```
**Example response**
```
{
"storageType": "SITEWISE_DEFAULT_STORAGE",
"configurationStatus": {
"state": "ACTIVE"
},
"lastUpdateDate": "2021-03-30T15:57:14-07:00"
}
```
### (Opcional) Cree un almacén AWS IoT Analytics de datos (AWS CLI)
**nota**
Aviso de fin del soporte: el 15 de diciembre de 2025, AWS finalizará el soporte para AWS IoT Analytics. Después del 15 de diciembre de 2025, ya no podrás acceder a la AWS IoT Analytics consola ni a AWS IoT Analytics los recursos. Para obtener más información, consulta [AWS IoT Analytics el fin del soporte](https://docs.aws.amazon.com/iotanalytics/latest/userguide/iotanalytics-end-of-support.html).
Un almacén de AWS IoT Analytics datos es un repositorio escalable y consultable que recibe y almacena datos. Puede usar la AWS IoT SiteWise consola o AWS IoT Analytics APIs crear un banco de AWS IoT Analytics datos para guardar los datos AWS IoT SiteWise . Para consultar los datos, cree conjuntos de datos mediante AWS IoT Analytics. Para obtener más información, consulte [Trabajo con datos de AWS IoT SiteWise](https://docs.aws.amazon.com/iotanalytics/latest/userguide/dataset-itsw.html) en la *Guía del usuario de AWS IoT Analytics *.
Los siguientes pasos se utilizan AWS CLI para crear un almacén de datos en AWS IoT Analytics.
Ejecute el siguiente comando para crear un almacén de datos. *file-name*Sustitúyalo por el nombre del archivo que contiene la configuración del almacén de datos.
```
aws iotanalytics create-datastore --cli-input-json file://file-name.json
```
**nota**
Debe especificar el nombre de un bucket de Amazon S3 existente. Si no dispone de un bucket de Amazon S3, cree uno primero. Para obtener más información, consulte [Creación del primer bucket de S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/GetStartedWithS3.html#creating-bucket) en la *Guía del usuario de Amazon S3*.
Debe usar el mismo nombre de bucket de Amazon S3 en la configuración de AWS IoT SiteWise almacenamiento, la política de IAM y la configuración del almacén de AWS IoT Analytics datos.
**Example AWS IoT Analytics configuración del almacén de datos**
Sustituya *data-store-name* y *amzn-s3-demo-bucket* por el nombre del almacén de AWS IoT Analytics datos y el nombre del bucket de Amazon S3.
```
{
"datastoreName": "data-store-name",
"datastoreStorage": {
"iotSiteWiseMultiLayerStorage": {
"customerManagedS3Storage": {
"bucket": "amzn-s3-demo-bucket"
}
}
},
"retentionPeriod": {
"numberOfDays": 90
}
}
```
**Example response**
```
{
"datastoreName": "datastore_IoTSiteWise_demo",
"datastoreArn": "arn:aws:iotanalytics:us-west-2:123456789012:datastore/datastore_IoTSiteWise_demo",
"retentionPeriod": {
"numberOfDays": 90,
"unlimited": false
}
}
```
# Solucionar problemas de configuración de almacenamiento para AWS IoT SiteWise
Utilice la siguiente información como ayuda para solucionar problemas con la configuración de almacenamiento.
**Topics**
+ [Error: el bucket no existe](#no-s3-bucket)
+ [Error: acceso denegado a la ruta de Amazon S3](#iam-permissions)
+ [Error: no se puede asumir el ARN del rol](#iam-trust-relationship)
+ [Error: no se ha podido acceder al bucket de Amazon S3 entre regiones](#cross-region-s3-bucket)
## Error: el bucket no existe
**Solución:** no AWS IoT SiteWise ha podido encontrar su bucket de Amazon S3. Asegúrese de introducir el nombre de un bucket de Amazon S3 existente en la región actual.
## Error: acceso denegado a la ruta de Amazon S3
**Solución:** no AWS IoT SiteWise ha podido acceder a su bucket de Amazon S3. Haga lo siguiente:
+ Asegúrese de utilizar el mismo bucket de Amazon S3 que especificó en la política de IAM.
+ Asegúrese de que el rol tenga los permisos que se muestran en el siguiente ejemplo.
**Example política de permisos**
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"s3:PutObject",
"s3:GetObject",
"s3:DeleteObject",
"s3:GetBucketLocation",
"s3:ListBucket"
],
"Resource": [
"arn:aws:s3:::amzn-s3-demo-bucket",
"arn:aws:s3:::amzn-s3-demo-bucket/*"
]
}
]
}
```
------
Sustituya amzn-s3-demo-bucket por el nombre de su bucket de Amazon S3.
## Error: no se puede asumir el ARN del rol
**Solución:** no AWS IoT SiteWise pude asumir la función de IAM en su nombre. Asegúrese de que su rol confíe en el siguiente servicio: `iotsitewise.amazonaws.com`. Para obtener más información, consulte [No puedo asumir un rol](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_roles.html#troubleshoot_roles_cant-assume-role) en la *Guía del usuario de IAM*.
## Error: no se ha podido acceder al bucket de Amazon S3 entre regiones
**Solución:** el bucket de Amazon S3 que especificó se encuentra en una AWS región diferente. Asegúrese de que su depósito de Amazon S3 y AWS IoT SiteWise sus activos estén en la misma región.
# Rutas de archivos y esquemas de datos guardados en el nivel inactivo
AWS IoT SiteWise almacena los datos en la capa fría mediante la replicación de series temporales, incluidas las mediciones, las métricas, las transformaciones y los agregados, así como las definiciones de activos y modelos de activos. A continuación se describen las rutas de los archivos y los esquemas de datos que se envían al nivel inactivo.
**Topics**
+ [Datos del equipo (mediciones)](#measurements-file-path-and-schema)
+ [Métricas, transformaciones y agregados](#metrics-file-path-and-schema)
+ [Metadatos de los activos](#asset-metadata)
+ [Metadatos de jerarquía de los activos](#asset-hierarchy-metadata)
+ [Almacenamiento de archivos índice de datos](#storage-data-index)
## Datos del equipo (mediciones)
AWS IoT SiteWise exporta los datos del equipo (mediciones) a la capa fría una vez cada seis horas. Los datos sin procesar se guardan en el nivel inactivo en formato [Apache AVRO](https://avro.apache.org) (`.avro`).
### Ruta de archivo
AWS IoT SiteWise almacena los datos del equipo (mediciones) en la capa fría mediante la siguiente plantilla.
```
{keyPrefix}/raw/startYear={startYear}/startMonth={startMonth}/startDay={startDay}/seriesBucket={seriesBucket}/raw_{timeseriesId}_{startTimestamp}_{quality}.avro
```
Cada ruta de archivo a datos sin procesar en Amazon S3 contiene los siguientes componentes.
#### Ruta de archivo
| Componente de ruta | Description (Descripción) |
| --- | --- |
| `keyPrefix` | El prefijo de Amazon S3 que especificó en la configuración AWS IoT SiteWise de almacenamiento. Amazon S3 utiliza el prefijo como nombre de carpeta en el bucket. |
| `raw` | La carpeta que almacena los datos de serie temporal del equipo (mediciones). La carpeta `raw` se guarda en la carpeta de prefijos. |
| `seriesBucket` | Un número hexadecimal entre 00 y ff. Este número se deriva de `timeSeriesId`. Esta partición se utiliza para aumentar el rendimiento cuando se AWS IoT SiteWise escribe en la capa fría. Cuando se utiliza Amazon Athena para ejecutar consultas, la partición puede servir para realizar particiones refinadas a fin de mejorar la precisión de las consultas. `seriesBucket` y `timeSeriesBucket` son el mismo número en los metadatos del activo. |
| `startYear` | El año de la hora de inicio exclusiva asociada a los datos de serie temporal. |
| `startMonth` | El mes de la hora de inicio exclusiva asociada a los datos de serie temporal. |
| `startDay` | El día del mes de la hora de inicio exclusiva asociada a los datos de serie temporal. |
| `fileName` | El nombre del archivo utiliza el carácter de subrayado (\$1) como delimitador para separar lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/iot-sitewise/latest/userguide/file-path-and-schema.html) El archivo se guarda en el formato `.avro` mediante la compresión [Snappy](https://github.com/google/snappy). |
**Example ruta del archivo a los datos sin procesar en el nivel inactivo**
`keyPrefix/raw/startYear=2021/startMonth=1/startDay=2/seriesBucket=a2/raw_7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a_1609577700_GOOD.avro`
### Fields
El esquema de datos sin procesar que se exporta al nivel inactivo contiene los siguientes campos.
AWS IoT SiteWise aconseja a los clientes que implementen el soporte para la evolución de esquemas en los sistemas que leen datos sin procesar de la capa fría, ya que es posible que se introduzcan campos adicionales en el futuro.
Los datos nulos se representan cuando todos los campos de valores son nulos. Sin embargo, los clientes seguirán recibiendo el tipo de datos correcto cuando realicen consultas. AWS IoT SiteWise APIs
#### Fields
| Nombre del campo | Tipos admitidos | Tipo predeterminado | Description (Descripción) |
| --- | --- | --- | --- |
| `seriesId` | `string` | N/A | El identificador que identifica los datos de serie temporal del equipo (mediciones). Puede usar este campo para unir datos sin procesar y metadatos de activos en las consultas. |
| `timeInSeconds` | `long` | N/A | La marca temporal, en segundos, en formato de tiempo Unix. Los datos fraccionarios de nanosegundos los proporciona `offsetInNanos`. |
| `offsetInNanos` | `long` | N/A | El desfase de nanosegundos procedente de `timeInSeconds`. |
| `quality` | `string` | N/A | La calidad del valor de la serie temporal. |
| `doubleValue` | `double` o `null` | `null` | Datos de serie temporal de tipo doble (número de punto flotante). |
| `stringValue` | `string` o `null` | `null` | Datos de serie temporal de tipo cadena (secuencia de caracteres). |
| `integerValue` | `int` o `null` | `null` | Datos de serie temporal de tipo entero (número entero). |
| `booleanValue` | `boolean` o `null` | `null` | Datos de serie temporal de tipo booleano (verdadero o falso). |
| `jsonValue` | `string` o `null` | `null` | Datos de serie temporal de tipo JSON (tipos de datos complejos almacenados como una cadena). |
| `recordVersion` | `long` o `null` | `null` | El número de versión para el registro. Puede usar el número de versión para seleccionar el registro más reciente. Los registros más recientes tienen números de versión más grandes. |
**Example datos sin procesar en el nivel inactivo**
```
{"seriesId":"e9687d2a-0dbe-4f65-9ed6-6f443cba41f7_95e63da7-d34e-43e1-bc6f-1b490154b07a","timeInSeconds":1625675887,"offsetInNanos":0,"quality":"GOOD","doubleValue":{"double":0.75},"stringValue":null,"integerValue":null,"booleanValue":null,"jsonValue":null,"recordVersion":null}
{"seriesId":"e9687d2a-0dbe-4f65-9ed6-6f443cba41f7_95e63da7-d34e-43e1-bc6f-1b490154b07a","timeInSeconds":1625675889,"offsetInNanos":0,"quality":"GOOD","doubleValue":{"double":0.69},"stringValue":null,"integerValue":null,"booleanValue":null,"jsonValue":null,"recordVersion":null}
{"seriesId":"e9687d2a-0dbe-4f65-9ed6-6f443cba41f7_95e63da7-d34e-43e1-bc6f-1b490154b07a","timeInSeconds":1625675890,"offsetInNanos":0,"quality":"GOOD","doubleValue":{"double":0.66},"stringValue":null,"integerValue":null,"booleanValue":null,"jsonValue":null,"recordVersion":null}
{"seriesId":"e9687d2a-0dbe-4f65-9ed6-6f443cba41f7_95e63da7-d34e-43e1-bc6f-1b490154b07a","timeInSeconds":1625675891,"offsetInNanos":0,"quality":"GOOD","doubleValue":{"double":0.92},"stringValue":null,"integerValue":null,"booleanValue":null,"jsonValue":null,"recordVersion":null}
{"seriesId":"e9687d2a-0dbe-4f65-9ed6-6f443cba41f7_95e63da7-d34e-43e1-bc6f-1b490154b07a","timeInSeconds":1625675892,"offsetInNanos":0,"quality":"GOOD","doubleValue":{"double":0.73},"stringValue":null,"integerValue":null,"booleanValue":null,"jsonValue":null,"recordVersion":null}
```
## Métricas, transformaciones y agregados
AWS IoT SiteWise exporta métricas, transformaciones y agregados a la capa fría una vez cada seis horas. Las métricas, las transformaciones y los agregados se guardan en el nivel inactivo en el formato [Apache AVRO](https://avro.apache.org) (`.avro`).
### Ruta de archivo
AWS IoT SiteWise almacena las métricas, las transformaciones y los agregados en la capa fría mediante la siguiente plantilla.
```
{keyPrefix}/agg/startYear={startYear}/startMonth={startMonth}/startDay={startDay}/seriesBucket={seriesBucket}/agg_{timeseriesId}_{startTimestamp}_{quality}.avro
```
Cada ruta de archivo a las métricas, las transformaciones y los agregados en Amazon S3 contiene los siguientes componentes.
#### Ruta de archivo
| Componente de ruta | Description (Descripción) |
| --- | --- |
| `keyPrefix` | El prefijo de Amazon S3 que especificó en la configuración AWS IoT SiteWise de almacenamiento. Amazon S3 utiliza el prefijo como nombre de carpeta en el bucket. |
| `agg` | La carpeta que almacena los datos de serie temporal de las métricas. La carpeta `agg` se guarda en la carpeta de prefijos. |
| `seriesBucket` | Un número hexadecimal entre 00 y ff. Este número se deriva de `timeSeriesId`. Esta partición se utiliza para aumentar el rendimiento cuando se AWS IoT SiteWise escribe en la capa fría. Cuando se utiliza Amazon Athena para ejecutar consultas, la partición puede servir para realizar particiones refinadas a fin de mejorar la precisión de las consultas. `seriesBucket` y `timeSeriesBucket` son el mismo número en los metadatos del activo. |
| `startYear` | El año de la hora de inicio exclusiva asociada a los datos de serie temporal. |
| `startMonth` | El mes de la hora de inicio exclusiva asociada a los datos de serie temporal. |
| `startDay` | El día del mes de la hora de inicio exclusiva asociada a los datos de serie temporal. |
| `fileName` | El nombre del archivo utiliza el carácter de subrayado (\$1) como delimitador para separar lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/iot-sitewise/latest/userguide/file-path-and-schema.html) El archivo se guarda en el formato `.avro` mediante la compresión [Snappy](https://github.com/google/snappy). |
**Example ruta del archivo a las métricas en el nivel inactivo**
`keyPrefix/agg/startYear=2021/startMonth=1/startDay=2/seriesBucket=a2/agg_7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a_1609577700_GOOD.avro`
### Fields
El esquema de las métricas, las transformaciones y los agregados que se exportan al nivel inactivo contiene los siguientes campos.
#### Fields
| Nombre del campo | Tipos admitidos | Tipo predeterminado | Description (Descripción) |
| --- | --- | --- | --- |
| `seriesId` | `string` | N/A | El ID que identifica los datos de serie temporal procedentes del equipo, de las métricas o de las transformaciones. Puede usar este campo para unir datos sin procesar y metadatos de activos en las consultas. |
| `timeInSeconds` | `long` | N/A | La marca temporal, en segundos, en formato de tiempo Unix. Los datos fraccionarios de nanosegundos los proporciona `offsetInNanos`. |
| `offsetInNanos` | `long` | N/A | El desfase de nanosegundos procedente de `timeInSeconds`. |
| `quality` | `string` | N/A | La calidad con la que se filtran los datos de los activos. |
| `resolution` | `string` | N/A | El intervalo de tiempo durante el que se van a agregar los datos. |
| `count` | `double` o `null` | `null` | El número total de puntos de datos para las variables dadas durante el intervalo de tiempo actual. |
| `average` | `double` o `null` | `null` | La media de los valores de las variables dadas durante el intervalo de tiempo actual. |
| `min` | `double` o `null` | `null` | El mínimo de los valores de las variables dadas durante el intervalo de tiempo actual. |
| `max` | `boolean` o `null` | `null` | El máximo de los valores de las variables dadas durante el intervalo de tiempo actual. |
| `sum` | `string` o `null` | `null` | La suma de los valores de las variables dadas durante el intervalo de tiempo actual. |
| `recordVersion` | `long` o `null` | `null` | El número de versión para el registro. Puede usar el número de versión para seleccionar el registro más reciente. Los registros más recientes tienen números de versión más grandes. |
**Example Datos métricos en el nivel inactivo**
```
{"seriesId":"f74c2828-5317-4df3-ba16-6d41b5bcb531","timeInSeconds":1637334060,"offsetInNanos":0,"quality":"GOOD","resolution":"PT1M","count":31.0,"average":{"double":16.0},"min":{"double":1.0},"max":{"double":31.0},"sum":{"double":496.0},"recordVersion":null}
{"seriesId":"f74c2828-5317-4df3-ba16-6d41b5bcb531","timeInSeconds":1637334120,"offsetInNanos":0,"quality":"GOOD","resolution":"PT1M","count":29.0,"average":{"double":46.0},"min":{"double":32.0},"max":{"double":60.0},"sum":{"double":1334.0},"recordVersion":null}
{"seriesId":"f74c2828-5317-4df3-ba16-6d41b5bcb531","timeInSeconds":1637334540,"offsetInNanos":0,"quality":"GOOD","resolution":"PT1M","count":31.0,"average":{"double":16.0},"min":{"double":1.0},"max":{"double":31.0},"sum":{"double":496.0},"recordVersion":null}
{"seriesId":"f74c2828-5317-4df3-ba16-6d41b5bcb531","timeInSeconds":1637334600,"offsetInNanos":0,"quality":"GOOD","resolution":"PT1M","count":29.0,"average":{"double":46.0},"min":{"double":32.0},"max":{"double":60.0},"sum":{"double":1334.0},"recordVersion":null}
{"seriesId":"f74c2828-5317-4df3-ba16-6d41b5bcb531","timeInSeconds":1637335020,"offsetInNanos":0,"quality":"GOOD","resolution":"PT1M","count":31.0,"average":{"double":16.0},"min":{"double":1.0},"max":{"double":31.0},"sum":{"double":496.0},"recordVersion":null}
```
## Metadatos de los activos
Al habilitar AWS IoT SiteWise la exportación de datos a la capa fría por primera vez, los metadatos de los activos se exportan a la capa fría. Tras la configuración inicial, AWS IoT SiteWise exporta los metadatos de los activos al nivel solo cuando se cambian las definiciones del modelo de activos o las definiciones de activos. Los metadatos de activos se guardan en el nivel de acceso inactivo en el formato JSON delimitado por nuevas líneas (`.ndjson`).
### Ruta de archivo
AWS IoT SiteWise almacena los metadatos de los activos en la capa fría mediante la siguiente plantilla.
```
{keyPrefix}/asset_metadata/asset_{assetId}.ndjson
```
Cada ruta de archivo a los metadatos de los activos en el nivel inactivo contiene los siguientes componentes.
#### Ruta de archivo
| Componente de ruta | Description (Descripción) |
| --- | --- |
| `keyPrefix` | El prefijo de Amazon S3 que especificó en la configuración de almacenamiento AWS IoT SiteWise s. Amazon S3 utiliza el prefijo como nombre de carpeta en el bucket. |
| `asset_metadata` | La carpeta que almacena los metadatos de los activos. La carpeta `asset_metadata` se guarda en la carpeta de prefijos. |
| `fileName` | El nombre del archivo utiliza el carácter de subrayado (\$1) como delimitador para separar lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/iot-sitewise/latest/userguide/file-path-and-schema.html) El archivo se guarda en el formato `.ndjson`. |
**Example ruta del archivo a los metadatos de los activos en el nivel inferior**
`keyPrefix/asset_metadata/asset_35901915-d476-4dca-8637-d9ed4df939ed.ndjson`
### Fields
El esquema de metadatos de activos que se exporta al nivel inactivo contiene los siguientes campos.
#### Fields
| Nombre del campo | Description (Descripción) |
| --- | --- |
| `assetId` | El ID del activo. |
| `assetName` | Nombre del activo. |
| `assetExternalId` | El ID externo del recurso. |
| `assetModelId` | Id. del modelo de activos usado para crear el activo. |
| `assetModelName` | El nombre del modelo del activo. |
| `assetModelExternalId` | ID externo del modelo de activos. |
| `assetPropertyId` | El ID de la propiedad del activo. |
| `assetPropertyName` | El nombre de la propiedad del activo. |
| `assetPropertyExternalId` | ID externo de la propiedad del activo. |
| `assetPropertyDataType` | El tipo de datos de la propiedad del activo. |
| `assetPropertyUnit` | La unidad que usa la propiedad del activo (por ejemplo, `Newtons` y `RPM`). |
| `assetPropertyAlias` | El alias que identifica la propiedad del activo, como una ruta de flujo de datos del servidor OPC UA (por ejemplo, `/company/windfarm/3/turbine/7/temperature`). |
| `timeSeriesId` | El ID que identifica los datos de serie temporal procedentes del equipo, de las métricas o de las transformaciones. Puede usar este campo para unir datos sin procesar y metadatos de activos en las consultas. |
| `timeSeriesBucket` | Un número hexadecimal entre 00 y ff. Este número se deriva de `timeSeriesId`. Esta partición se utiliza para aumentar el rendimiento cuando se AWS IoT SiteWise escribe en la capa fría. Cuando se utiliza Amazon Athena para ejecutar consultas, la partición puede servir para realizar particiones refinadas a fin de mejorar la precisión de las consultas. `timeSeriesBucket` y `seriesBucket` son el mismo número en la ruta del archivo a los datos sin procesar. |
| `assetCompositeModelId` | ID del modelo compuesto. |
| `assetCompositeModelExternalId` | ID externo del modelo compuesto. |
| `assetCompositeModelDescription` | La descripción del modelo compuesto. |
| `assetCompositeModelName` | El nombre del modelo compuesto. |
| `assetCompositeModelType` | El tipo del modelo compuesto. Para los modelos compuestos de alarma, este tipo es `AWS/ALARM`. |
| `assetCreationDate` | La fecha en que se creó el activo, en formato de tiempo UNIX. |
| `assetLastUpdateDate` | La fecha en que el activo se actualizó por última vez, en fecha de inicio Unix. |
| `assetStatusErrorCode` | Código de error. |
| `assetStatusErrorMessage` | Mensaje de error. |
| `assetStatusState` | El estado actual del activo. |
**Example metadatos de activos en el nivel inactivo**
```
{"assetId":"7020c8e2-e6db-40fa-9845-ed0dddd4c77d","assetExternalId":null,"assetName":"Wind Turbine Asset 2","assetModelId":"ec1d924f-f07d-444f-b072-e2994c165d35","assetModelExternalId":null,"assetModelName":"Wind Turbine Asset Model","assetPropertyId":"95e63da7-d34e-43e1-bc6f-1b490154b07a","assetPropertyExternalId":null,"assetPropertyName":"Temperature","assetPropertyDataType":"DOUBLE","assetPropertyUnit":"Celsius","assetPropertyAlias":"USA/Washington/Seattle/WT2/temp","timeSeriesId":"7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a","timeSeriesBucket":"f6","assetArn":null,"assetCompositeModelDescription":null,"assetCompositeModelName":null,"assetCompositeModelType":null,"assetCompositeModelId":null,"assetCompositeModelExternalId":null,"assetCreationDate":1619466323,"assetLastUpdateDate":1623859856,"assetStatusErrorCode":null,"assetStatusErrorMessage":null,"assetStatusState":"ACTIVE"}
{"assetId":"7020c8e2-e6db-40fa-9845-ed0dddd4c77d","assetExternalId":null,"assetName":"Wind Turbine Asset 2","assetModelId":"ec1d924f-f07d-444f-b072-e2994c165d35","assetModelExternalId":null,"assetModelName":"Wind Turbine Asset Model","assetPropertyId":"c706d54d-4c11-42dc-9a01-63662fc697b4","assetPropertyExternalId":null,"assetPropertyName":"Pressure","assetPropertyDataType":"DOUBLE","assetPropertyUnit":"KiloPascal","assetPropertyAlias":"USA/Washington/Seattle/WT2/pressure","timeSeriesId":"7020c8e2-e6db-40fa-9845-ed0dddd4c77d_c706d54d-4c11-42dc-9a01-63662fc697b4","timeSeriesBucket":"1e","assetArn":null,"assetCompositeModelDescription":null,"assetCompositeModelName":null,"assetCompositeModelType":null,"assetCompositeModelId":null,"assetCompositeModelExternalId":null,"assetCreationDate":1619466323,"assetLastUpdateDate":1623859856,"assetStatusErrorCode":null,"assetStatusErrorMessage":null,"assetStatusState":"ACTIVE"}
{"assetId":"7020c8e2-e6db-40fa-9845-ed0dddd4c77d","assetExternalId":null,"assetName":"Wind Turbine Asset 2","assetModelId":"ec1d924f-f07d-444f-b072-e2994c165d35","assetModelExternalId":null,"assetModelName":"Wind Turbine Asset Model","assetPropertyId":"8cf1162f-dead-4fbe-b468-c8e24cde9f50","assetPropertyExternalId":null,"assetPropertyName":"Max Temperature","assetPropertyDataType":"DOUBLE","assetPropertyUnit":null,"assetPropertyAlias":null,"timeSeriesId":"7020c8e2-e6db-40fa-9845-ed0dddd4c77d_8cf1162f-dead-4fbe-b468-c8e24cde9f50","timeSeriesBucket":"d7","assetArn":null,"assetCompositeModelDescription":null,"assetCompositeModelName":null,"assetCompositeModelType":null,"assetCompositeModelId":null,"assetCompositeModelExternalId":null,"assetCreationDate":1619466323,"assetLastUpdateDate":1623859856,"assetStatusErrorCode":null,"assetStatusErrorMessage":null,"assetStatusState":"ACTIVE"}
{"assetId":"3a5f2a22-3b37-4332-9c1c-404ea1d73fab","assetExternalId":null,"assetName":"BatchAssetDouble1","assetModelId":"814bdfd8-24db-4a33-8d9b-ebc75e75e827","assetModelExternalId":null,"assetModelName":"FlashTestAssetModelDouble","assetPropertyId":"6b7e1532-175b-4c02-b410-ab401a9176ed","assetPropertyExternalId":null,"assetPropertyName":"measurementProperty","assetPropertyDataType":"DOUBLE","assetPropertyUnit":"u","assetPropertyAlias":null,"timeSeriesId":"ab19f4fa-7e7b-4247-ae89-ff316f5ff8aa","timeSeriesBucket":"af","assetArn":null,"assetCompositeModelDescription":null,"assetCompositeModelName":null,"assetCompositeModelType":null,"assetCompositeModelId":null,"assetCompositeModelExternalId":null,"assetCreationDate":1646960106,"assetLastUpdateDate":1646960106,"assetStatusErrorCode":null,"assetStatusErrorMessage":null,"assetStatusState":"ACTIVE"}
```
## Metadatos de jerarquía de los activos
Cuando habilita AWS IoT SiteWise guardar datos en la capa inactiva por primera vez, los metadatos de la jerarquía de activos se exportan a la capa fría. Tras la configuración inicial, AWS IoT SiteWise exporta los metadatos de la jerarquía de activos a la capa fría solo cuando se realizan cambios en el modelo de activos o en las definiciones de activos. Los metadatos de la jerarquía de activos se guardan en el nivel inactivo en el formato JSON delimitado por nuevas líneas (`.ndjson`).
Al llamar a la [DescribeAsset](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/API_DescribeAsset.html)API, se recupera un identificador externo de la jerarquía, el activo de destino o el activo de origen.
### Ruta de archivo
AWS IoT SiteWise almacena los metadatos de la jerarquía de activos en la capa fría mediante la siguiente plantilla.
```
{keyPrefix}/asset_hierarchy_metadata/{parentAssetId}_{hierarchyId}.ndjson
```
Cada ruta de archivo a los metadatos de jerarquía de los activos en el nivel inactivo contiene los siguientes componentes.
#### Ruta de archivo
| Componente de ruta | Description (Descripción) |
| --- | --- |
| `keyPrefix` | El prefijo de Amazon S3 que especificó en la configuración AWS IoT SiteWise de almacenamiento. Amazon S3 utiliza el prefijo como nombre de carpeta en el bucket. |
| `asset_hierarchy_metadata` | La carpeta que almacena los metadatos de jerarquía de los activos. La carpeta `asset_hierarchy_metadata` se guarda en la carpeta de prefijos. |
| `fileName` | El nombre del archivo utiliza el carácter de subrayado (\$1) como delimitador para separar lo siguiente: [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/es_es/iot-sitewise/latest/userguide/file-path-and-schema.html) El archivo se guarda en el formato `.ndjson`. |
**Example ruta del archivo a los metadatos de la jerarquía de activos en el nivel inactivo**
`keyPrefix/asset_hierarchy_metadata/35901915-d476-4dca-8637-d9ed4df939ed_c5b3ced8-589a-48c7-9998-cdccfc9747a0.ndjson`
### Fields
El esquema de los metadatos de la jerarquía de activos que se exporta al nivel inactivo contiene los siguientes campos.
#### Fields
| Nombre del campo | Description (Descripción) |
| --- | --- |
| `sourceAssetId` | El ID del activo de origen en esta relación de activos. |
| `targetAssetId` | El ID del activo de destino en esta relación de activos. |
| `hierarchyId` | El ID de la jerarquía. |
| `associationType` | El tipo de asociación de esta relación de activos. El valor debe ser `CHILD`. El activo de destino es una entidad secundaria del activo de origen. |
**Example los metadatos de jerarquía de los activos en el nivel inactivo**
```
{"sourceAssetId":"80388e72-2284-44fb-9c89-bfbaf0dfedd2","targetAssetId":"2b866c25-0c74-4750-bdf5-b73683c8a2a2","hierarchyId":"bbed9f59-0412-4585-a61d-6044db526aee","associationType":"CHILD"}
{"sourceAssetId":"80388e72-2284-44fb-9c89-bfbaf0dfedd2","targetAssetId":"6b51246e-984d-460d-bc0b-470ea47d1e31","hierarchyId":"bbed9f59-0412-4585-a61d-6044db526aee","associationType":"CHILD"}
```
**Para ver los datos en el nivel inactivo**
1. Vaya a la [consola de Amazon S3](https://console.aws.amazon.com/s3/).
1. En el panel de navegación, elija **Buckets** y, a continuación, elija el bucket de Amazon S3.
1. Navegue hasta la carpeta que contiene los datos sin procesar, los metadatos de los activos o los metadatos de jerarquía de los activos.
1. Seleccione los archivos y, a continuación, en **Acciones**, elija **Descargar**.
## Almacenamiento de archivos índice de datos
AWS IoT SiteWise utiliza estos archivos para optimizar el rendimiento de las consultas de datos. Aparecen en u bucket de Amazon S3, pero no es necesario que los utilice.
### Ruta de archivo
AWS IoT SiteWise almacena los archivos de índice de datos en la capa fría mediante la siguiente plantilla.
```
keyPrefix/index/series=timeseriesId/startYear=startYear/startMonth=startMonth/startDay=startDay/index_timeseriesId_startTimestamp_quality
```
**Example ruta del archivo al archivo índice de almacenamiento de datos**
`keyPrefix/index/series=7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a/startYear=2022/startMonth=02/startDay=03/index_7020c8e2-e6db-40fa-9845-ed0dddd4c77d_95e63da7-d34e-43e1-bc6f-1b490154b07a_1643846400_GOOD`