

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.

# Seguimiento del progreso de los trabajos
<a name="review-job-progress"></a>

## Revise el progreso y los detalles de los trabajos (consola)
<a name="review-job-progress-console"></a>

Consulte [Importación de metadatos (consola)](running-bulk-operations-import.md#import-metadata-console) o [Exportación de metadatos (consola)](running-bulk-operations-export.md#export-metadata-console) para iniciar un trabajo masivo.

**Descripción general del progreso del trabajo en la AWS IoT SiteWise consola:**

1. Vaya a la [consola de AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. En el panel de navegación, elija **Operaciones masivas Nueva**.

1. La tabla de **progreso de los trabajos** de la AWS IoT SiteWise consola muestra la lista de trabajos de operaciones masivas.

1. La columna **Tipo de trabajo** describe si se trata de un trabajo de exportación o de importación. Las columnas **Fecha de importación** muestran la fecha en que se inició el trabajo.

1. La columna **Estado** muestra el estado del trabajo. Puede seleccionar un trabajo para ver sus detalles.

1. El trabajo seleccionado muestra **Correcto** si se ha realizado correctamente o una lista de errores si ha fallado. También se muestra una descripción del error con cada tipo de recurso.

**Descripción general de los detalles del trabajo en la AWS IoT SiteWise consola:**

La tabla de **progreso de los trabajos** de la AWS IoT SiteWise consola muestra la lista de trabajos de operaciones masivas.

1. Elija un trabajo para ver más detalles.

1. Para un trabajo de **importación**, el `Data source ARN` representa la ubicación en Amazon S3 del archivo de importación.

1. Para un trabajo de **exportación**, el `Data destination ARN` representa la ubicación del archivo en Amazon S3 tras la exportación.

1. `Status` y `Status reason` proporcionan detalles adicionales sobre el trabajo actual. Consulte [Seguimiento del progreso de los trabajos y gestión de errores](jobs-progress-error-handling.md) para obtener más detalles.

1. `Queued position` representa la posición del trabajo en la cola de procesos. Los trabajos se procesan uno a uno. Una posición en cola igual a 1 indica que el trabajo se procesará a continuación.

1.  La página de detalles de los trabajos también muestra los recuentos de progreso de los trabajos.

   1. Los tipos de recuento de progreso de los trabajo son:

     1. `Total resources`: indica el recuento total de activos en el proceso de transferencia.

     1. `Succeeded`: indica el recuento de activos transferidos correctamente durante el proceso.

     1. `Failed`: indica el recuento de activos que han fallado durante el proceso.

     1. `Skipped`: indica el recuento de activos que se han omitido durante el proceso.

1. Un estado de trabajo de `PENDING` o `VALIDATING` muestra todos los recuentos de progreso de los trabajos como `–`. Esto indica que se están evaluando los recuentos de progreso de los trabajos.

1. Un estado de trabajo de `RUNNING` muestra el recuento de `Total resources`, el trabajo enviado para su procesamiento. Los recuentos detallados (`Succeeded`, `Failed` y `Skipped`) se aplican a los recursos procesados. La suma de los recuentos detallados es menor que el recuento de `Total resources` hasta que el estado del trabajo es `COMPLETED` o `ERROR`.

1.  Si el estado de un trabajo es `COMPLETED` o `ERROR`, el recuento de `Total resources` es igual a la suma de los recuentos detallados (`Succeeded`, `Failed` y `Skipped`). 

1.  Si el estado de un trabajo es `ERROR`, consulte la tabla **Errores de trabajo** para obtener detalles sobre errores y fallos específicos. Consulte [Inspección de detalles de errores (consola)](inspect-errors.md#inspect-errors-console) para obtener más detalles. 

## Revise el progreso y los detalles de los trabajos (AWS CLI)
<a name="review-job-progress-cli"></a>

Tras iniciar una operación masiva, puede comprobar o actualizar su estado mediante las siguientes acciones de la API:
+ Para recuperar información sobre un trabajo específico, usa la acción de la [ GetMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetMetadataTransferJob.html)API.

**Recupere información con la API `GetMetadataTransferJob`:**

  1. Cree y ejecute un trabajo de transferencia. Llame a la API `GetMetadataTransferJob`.  
**Example AWS CLI comando:**  

     ```
     aws iottwinmaker get-metadata-transfer-job \ 
             --metadata-transfer-job-id your_metadata_transfer_job_id \
             --region your_region
     ```

  1.  La API `GetMetadataTransferJob` devuelve un objeto `MetadataTransferJobProgress` con los siguientes parámetros: 
     + **succeededCount**: indica el recuento de activos transferidos correctamente durante el proceso.
     + **failedCount**: indica el recuento de activos que han fallado durante el proceso.
     + **skippedCount**: indica el recuento de activos que se han omitido durante el proceso.
     + **totalCount**: indica el recuento total de activos en el proceso de transferencia.

     Estos parámetros indican el estado del progreso del trabajo. Si el estado es `RUNNING`, ayudan a hacer un seguimiento de la cantidad de recursos que aún no se han procesado.

     Si encuentra errores de validación del esquema o si **failedCount** es mayor o igual que 1, el estado de progreso de los trabajos pasa a ser `ERROR`. En el bucket de Amazon S3 se incluye un informe de error completo del trabajo. Consulte [Inspeccione los errores para AWS IoT SiteWise](inspect-errors.md) para obtener más detalles.
+ Para enumerar los trabajos actuales, usa la acción [ListMetadataTransferJobs](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobs.html)de la API.

  Use un archivo JSON para filtrar los trabajos devueltos en función de su estado actual. Consulte el procedimiento siguiente:

  1. Para especificar los filtros que quieres usar, crea un archivo JSON AWS CLI de entrada. Quieres usar:

     ```
     {
         "sourceType": "s3",
         "destinationType": "iottwinmaker",
         "filters": [{
             "state": "COMPLETED"
         }]
     }
     ```

     Para obtener una lista de `state` valores válidos, consulta la *Guía [ListMetadataTransferJobsFilter](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobsFilter.html)de referencia de la AWS IoT TwinMaker API*.

  1.  Usa el archivo JSON como argumento en el siguiente comando de AWS CLI ejemplo:

     ```
     aws iottwinmaker list-metadata-transfer-job --region your_region \
             --cli-input-json file://ListMetadataTransferJobsExample.json
     ```
+ Para cancelar un trabajo, usa la acción de la [CancelMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_CancelMetadataTransferJob.html)API. Esta API cancela el trabajo de transferencia de metadatos específico sin que ello afecte a los recursos ya exportados o importados:

  ```
  aws iottwinmaker cancel-metadata-transfer-job \ 
          --region your_region \ 
          --metadata-transfer-job-id job-to-cancel-id
  ```