Ejecutar un trabajo de exportación masiva

La exportación masiva es la acción de mover los metadatos de un AWS IoT SiteWise espacio de trabajo a un bucket de Amazon S3.

Al realizar una exportación masiva de su AWS IoT SiteWise contenido a Amazon S3, puede especificar filtros para limitar los modelos de activos y activos específicos que desea exportar.

Los filtros deben especificarse en una iotSiteWiseConfiguration sección dentro de la sección de fuentes de su solicitud de JSON.

nota

Puedes incluir varios filtros en tu solicitud. La operación masiva exportará los modelos de activos y los activos que coincidan con cualquiera de los filtros.

Si no proporciona ningún filtro, la operación masiva exporta todos sus modelos y activos de activos.

ejemplo cuerpo de la solicitud con filtros

{
      "metadataTransferJobId": "your-transfer-job-id",
      "sources": [
       {
        "type": "iotsitewise",
        "iotSiteWiseConfiguration": {
          "filters": [
           {
              "filterByAssetModel": {
                  "assetModelId": "asset model ID"
              }
            },
            {
              "filterByAssetModel": {
                  "assetModelId": "asset model ID",
                  "includeAssets": true
              }
            },
            {
              "filterByAssetModel": {
                  "assetModelId": "asset model ID",
                  "includeOffspring": true
               }
             }
           ]
          }
        }
       ],
       "destination": {
          "type": "s3",
          "s3Configuration": {
            "location": "arn:aws:s3:::your-S3-bucket-location"
          }
      }
}

Exportación de metadatos (consola)

El siguiente procedimiento explica la acción de exportación de la consola:

Cree un trabajo de exportación en el Consola de AWS IoT SiteWise

1. Vaya a la consola de AWS IoT SiteWise.

2. Seleccione Operaciones masivas nuevas en el panel de navegación.

3. Seleccione Nueva exportación para iniciar el proceso de exportación.

4. En la página Exportar metadatos:

   • Introduzca un nombre para el trabajo de exportación. Este es el nombre que se utiliza para el archivo exportado en su bucket de Amazon S3.

   • Elija los recursos que desea exportar, lo que establece los filtros para el trabajo:

     • Exporte todos los activos y modelos de activos. Utilice filtros en los activos y los modelos de activos.

     • Exporte activos. Filtra tus activos.

       • Seleccione el activo que desee utilizar para el filtro de exportación.

       • (Opcional) Añada el modelo de activos derivado o asociado.

     • Exporte modelos de activos. Filtre sus modelos de activos.

       • Seleccione el modelo de activos que desee utilizar para el filtro de exportación.

       • (Opcional) Añada la descendencia, el activo asociado o ambos.

     • Elija Siguiente.

   • Navegue hasta el bucket de Amazon S3:

     • Seleccione Browse Amazon S3 para ver el bucket y los archivos de Amazon S3.

     • Navegue hasta el depósito de Amazon S3 donde debe colocarse el archivo.

     • Elija Siguiente.

   • Revise el trabajo de exportación y seleccione Exportar.

5. La página Operaciones masivas en SiteWise metadatos Consola de AWS IoT SiteWise muestra el trabajo de importación recién creado en la tabla de progreso de los trabajos.

Para conocer las diferentes formas de utilizar los filtros al exportar metadatos, consulteEjemplos de metadatos de exportación.

Exportar metadatos (AWS CLI)

El siguiente procedimiento explica la acción AWS CLI de exportación:

Exportación de datos desde AWS IoT SiteWise Amazon S3

1. Cree un archivo JSON con el cuerpo de la solicitud. El cuerpo de la solicitud especifica el origen y el destino del trabajo de transferencia. El siguiente ejemplo muestra un ejemplo del cuerpo de la solicitud:

   
   {
       "metadataTransferJobId": "your-transfer-job-Id",
       "sources": [{
           "type": "iotsitewise"
       }],
       "destination": {
           "type": "s3",
           "s3Configuration": {
               "location": "arn:aws:s3:::your-S3-bucket-location"
           }
       }
   }

   Asegúrese de especificar su bucket de Amazon S3 como destino del trabajo de transferencia de metadatos.

   nota

   En este ejemplo, se exportarán todos sus modelos y activos de activos. Para limitar la exportación a modelos o activos específicos, puede incluir filtros en el cuerpo de la solicitud. Para obtener más información sobre la aplicación de filtros de exportación, consulteEjemplos de metadatos de exportación.

2. Guarde el cuerpo de la solicitud para usarlo en el siguiente paso. En este ejemplo, el archivo se denomina createMetadataTransferJobExport.json.

3. CreateMetadataTransferJobPara invocarlo, ejecute el siguiente AWS CLI comando:

   
   aws iottwinmaker create-metadata-transfer-job --region us-east-1 \ 
            --cli-input-json file://createMetadataTransferJobExport.json
   

   Sustituya el archivo createMetadataTransferJobExport.json JSON de entrada por su propio nombre de archivo de transferencia.