

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á.

# Inspecione erros para AWS IoT SiteWise
<a name="inspect-errors"></a>

## Inspecionar detalhes de erros (console)
<a name="inspect-errors-console"></a>

**Detalhes do erro no AWS IoT SiteWise console:**

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

1. Consulte a tabela de **progresso de trabalhos** em Console do AWS IoT SiteWise para obter uma lista de trabalhos de operação em massa.

1. Selecione um trabalho para exibir os detalhes do trabalho.

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.

1. A tabela **Falhas de trabalhos** exibe o conteúdo do relatório do trabalho. O campo `Resource type` indica o local do erro ou das falhas, como o seguinte:
   + Por exemplo, um erro de validação em `Bulk operations template`, no campo `Resource type`, indica que o modelo de importação e o formato do arquivo do esquema de metadados não coincidem. Consulte [AWS IoT SiteWise esquema de trabalho de transferência de metadados](bulk-operations-schema.md) para obter mais informações. 
   + Uma falha em `Asset`, no campo `Resource type`, indica que o ativo não foi criado devido a um conflito com outro ativo. Consulte [Erros comuns](https://docs.aws.amazon.com/iot-sitewise/latest/APIReference/CommonErrors.html) para obter informações sobre erros e conflitos de AWS IoT SiteWise recursos. 

## Inspecionar detalhes de erros (AWS CLI)
<a name="inspect-errors-cli"></a>

Para tratar e diagnosticar erros produzidos durante um trabalho de transferência, consulte o seguinte procedimento sobre como usar a ação de API `GetMetadataTransferJob`:

1. Depois de criar e executar um trabalho de transferência, ligue para [GetMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetMetadataTransferJob.html):

   ```
   aws iottwinmaker get-metadata-transfer-job \
           --metadata-transfer-job-id your_metadata_transfer_job_id \
           --region us-east-1
   ```

1. Depois de ver o estado do trabalho mudar para `COMPLETED`, você poderá começar a verificar os resultados do trabalho.

1. Quando você chama `GetMetadataTransferJob`, é retornado um objeto chamado [https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_MetadataTransferJobProgress.html](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_MetadataTransferJobProgress.html).

   O MetadataTransferJobProgress objeto contém os seguintes parâmetros:
   + **failedCount**: indica a contagem de ativos que falharam durante o processo de transferência.
   + **skippedCount**: indica a contagem de ativos que foram ignorados durante o processo de transferência.
   + **succeededCount**: indica a contagem de ativos transferidos com êxito no processo de transferência.
   + **totalCount**: indica a contagem total de ativos envolvidos no processo de transferência.

1. Além disso, a chamada de API retorna um elemento `reportUrl`, que contém um URL pré-assinado. Se o trabalho de transferência tiver algum problema que você precise investigar mais detalhadamente, visite esse URL. 