As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Acompanhamento do progresso dos trabalhos
<a name="review-job-progress"></a>

## Revisar o progresso dos trabalhos e os detalhes (console)
<a name="review-job-progress-console"></a>

Consulte [Importar metadados (console)](running-bulk-operations-import.md#import-metadata-console) ou [Exportar metadados (console)](running-bulk-operations-export.md#export-metadata-console) para iniciar um trabalho em massa.

**Visão geral do progresso do trabalho no AWS IoT SiteWise console:**

1. Navegue até o [console do AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Escolha **Operações em massa > Novo** no painel de navegação.

1. A tabela de **progresso de trabalhos** no AWS IoT SiteWise console exibe a lista de trabalhos de operação em massa.

1. A coluna **Tipo de trabalho** descreve se é um trabalho de exportação ou importação. As colunas **Data de importação** exibem a data de início do trabalho.

1. A coluna **Status** exibe o status do trabalho. É possível selecionar um trabalho para ver detalhes sobre o trabalho.

1. O trabalho selecionado mostra **Êxito** quando bem-sucedido, ou uma lista de falhas caso o trabalho falhe. Uma descrição do erro também é exibida com cada tipo de recurso.

**Visão geral dos detalhes do trabalho no AWS IoT SiteWise console:**

A tabela de **progresso de trabalhos** no AWS IoT SiteWise console exibe a lista de trabalhos de operação em massa.

1. Escolha um trabalho para ver mais detalhes.

1. Para um trabalho de **importação**, o `Data source ARN` representa o local do arquivo de importação no Amazon S3.

1. Para um trabalho de **exportação**, o `Data destination ARN` representa o local do arquivo depois da exportação no Amazon S3.

1. O `Status` e o `Status reason` dão detalhes adicionais sobre o trabalho atual. Consulte [Acompanhamento do progresso dos trabalhos e tratamento de erros](jobs-progress-error-handling.md) para obter mais detalhes.

1. A `Queued position` representa a posição do trabalho na fila do processo. Os trabalhos são processados um de cada vez. Uma posição 1 na fila indica que o trabalho será processado em seguida.

1.  A página de detalhes dos trabalhos também exibe as contagens de progresso dos trabalhos.

   1. Os tipos de contagem de progresso dos trabalhos são:

     1. `Total resources`: indica a contagem total de ativos no processo de transferência.

     1. `Succeeded`: indica a contagem de ativos transferidos com êxito durante o processo.

     1. `Failed`: indica a contagem de ativos que falharam durante o processo.

     1. `Skipped`: indica a contagem de ativos que foram ignorados durante o processo.

1. Um status de trabalho de `PENDING` ou `VALIDATING` exibe todas as contagens de progresso dos trabalhos como `–`. Isso indica que as contagens de progresso dos trabalhos estão sendo avaliadas.

1. Um status de trabalho de `RUNNING` exibe a contagem `Total resources`, o trabalho enviado para processamento. As contagens detalhadas (`Succeeded`, `Failed` e `Skipped`) se aplicam aos recursos processados. A soma das contagens detalhadas é menor do que a contagem `Total resources`, até que o status do trabalho seja `COMPLETED` ou `ERROR`.

1.  Se o status de um trabalho for `COMPLETED` ou `ERROR`, a contagem `Total resources` será igual à soma das contagens detalhadas (`Succeeded`, `Failed` e `Skipped`). 

1.  Se o status de um trabalho for `ERROR`, verifique a tabela **Falhas de trabalhos** para conferir detalhes sobre as falhas e os erros específicos. Consulte [Inspecionar detalhes de erros (console)](inspect-errors.md#inspect-errors-console) para obter mais detalhes. 

## Revisar o progresso dos trabalhos e os detalhes (AWS CLI)
<a name="review-job-progress-cli"></a>

Depois de iniciar uma operação em massa, você poderá verificar ou atualizar o status usando as seguintes ações de API:
+ Para recuperar informações sobre um trabalho específico, use a ação da [ GetMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetMetadataTransferJob.html)API.

**Recupere informações com a API `GetMetadataTransferJob`:**

  1. Crie e execute um trabalho de transferência. Chame a 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.  A API `GetMetadataTransferJob` retorna um objeto `MetadataTransferJobProgress` com os seguintes parâmetros: 
     + **succeededCount**: indica a contagem de ativos transferidos com êxito no processo.
     + **failedCount**: indica a contagem de ativos que falharam durante o processo.
     + **skippedCount**: indica a contagem de ativos que foram ignorados durante o processo.
     + **totalCount**: indica a contagem total de ativos no processo de transferência.

     Esses parâmetros indicam o status de progresso dos trabalhos. Se o status for `RUNNING`, eles ajudarão a acompanhar o número de recursos que ainda precisam ser processados.

     Se você encontrar erros na validação do esquema, ou se **failedCount** for maior ou igual a 1, o estado de progresso do trabalho será alterado para `ERROR`. O relatório de erros completo do trabalho é colocado no bucket do Amazon S3. Consulte [Inspecione erros para AWS IoT SiteWise](inspect-errors.md) para obter mais detalhes.
+ Para listar os trabalhos atuais, use a ação [ListMetadataTransferJobs](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobs.html)da API.

  Use um arquivo JSON para filtrar os trabalhos retornados com base no estado atual. Consulte o seguinte procedimento:

  1. Para especificar os filtros que você deseja usar, crie um arquivo JSON AWS CLI de entrada. quero usar:

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

     Para obter uma lista de `state` valores válidos, consulte [ListMetadataTransferJobsFilter](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobsFilter.html)o *Guia de referência AWS IoT TwinMaker da API*.

  1.  Use o arquivo JSON como argumento no seguinte AWS CLI exemplo de comando:

     ```
     aws iottwinmaker list-metadata-transfer-job --region {{your_region}} \
             --cli-input-json file://ListMetadataTransferJobsExample.json
     ```
+ Para cancelar um trabalho, use a ação [CancelMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_CancelMetadataTransferJob.html)da API. Essa API cancela o trabalho de transferência de metadados específico, sem afetar nenhum recurso já exportado ou importado:

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