

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Monitoraggio dei progressi dei lavori
<a name="review-job-progress"></a>

## Rivedi lo stato di avanzamento e i dettagli del lavoro (console)
<a name="review-job-progress-console"></a>

Visualizza [Importa metadati (console)](running-bulk-operations-import.md#import-metadata-console) o [Esporta metadati (console)](running-bulk-operations-export.md#export-metadata-console) avvia un lavoro collettivo.

**Panoramica dello stato di avanzamento del lavoro nella AWS IoT SiteWise console:**

1. Passare alla [console AWS IoT SiteWise](https://console.aws.amazon.com/iotsitewise/).

1. Scegli **Operazioni in blocco Nuove** dal pannello di navigazione.

1. La tabella **di avanzamento dei lavori** nella AWS IoT SiteWise console mostra l'elenco dei lavori relativi alle operazioni in blocco.

1. La colonna **Job type** descrive se si tratta di un processo di esportazione o importazione. Le colonne **Data di importazione** mostrano la data di inizio del processo.

1. La colonna **Stato** mostra lo stato del lavoro. È possibile selezionare un lavoro per visualizzarne i dettagli.

1. Il lavoro selezionato mostra **Successo** in caso di esito positivo o un elenco di errori se il lavoro non è riuscito. Per ogni tipo di risorsa viene inoltre visualizzata una descrizione dell'errore.

**Panoramica dei dettagli del lavoro nella AWS IoT SiteWise console:**

La tabella **di avanzamento dei lavori** nella AWS IoT SiteWise console mostra l'elenco dei lavori eseguiti in blocco.

1. Scegli un lavoro per visualizzare maggiori dettagli.

1. Per un processo di **importazione**, `Data source ARN` rappresenta la posizione Amazon S3 del file di importazione.

1. Per un processo di **esportazione**, `Data destination ARN` rappresenta la posizione Amazon S3 del file dopo l'esportazione.

1. Inoltre `Status``Status reason`, fornisci ulteriori dettagli sul lavoro corrente. Per ulteriori dettagli, consulta [Monitoraggio dell'avanzamento dei lavori e gestione degli errori](jobs-progress-error-handling.md).

1. `Queued position`Rappresenta la posizione del lavoro nella coda del processo. I lavori vengono elaborati uno alla volta. Una posizione in coda pari a 1 indica che il lavoro verrà elaborato successivamente.

1.  La pagina dei dettagli dei lavori mostra anche i conteggi relativi all'avanzamento dei lavori.

   1. I tipi di conteggio dello stato di avanzamento dei lavori sono:

     1. `Total resources`— Indica il numero totale di asset nel processo di trasferimento.

     1. `Succeeded`— Indica il numero di asset trasferiti con successo durante il processo.

     1. `Failed`— Indica il numero di asset che hanno avuto esito negativo durante il processo.

     1. `Skipped`— Indica il numero di risorse che sono state ignorate durante il processo.

1. Uno stato del lavoro pari a `PENDING` o`VALIDATING`, visualizza tutti i conteggi relativi all'avanzamento dei lavori. `–` Ciò indica che i conteggi relativi all'avanzamento dei lavori sono in fase di valutazione.

1. Uno stato del lavoro pari a `RUNNING` mostra il `Total resources` conteggio, il lavoro inviato per l'elaborazione. I conteggi dettagliati (`Succeeded``Failed`, e`Skipped`) si applicano alle risorse elaborate. La somma dei conteggi dettagliati è inferiore al `Total resources` conteggio, finché lo stato del lavoro non è `COMPLETED` o`ERROR`.

1.  Se lo stato di un lavoro è `COMPLETED` o`ERROR`, il `Total resources` conteggio è uguale alla somma dei conteggi dettagliati (`Succeeded``Failed`, e). `Skipped` 

1.  Se lo stato di un lavoro è`ERROR`, consulta la tabella **Job failures** per i dettagli sugli errori e gli errori specifici. Per ulteriori dettagli, consulta [Controlla i dettagli dell'errore (console)](inspect-errors.md#inspect-errors-console). 

## Rivedi lo stato di avanzamento e i dettagli del lavoro ()AWS CLI
<a name="review-job-progress-cli"></a>

Dopo aver avviato un'operazione in blocco, puoi verificarne o aggiornarne lo stato utilizzando le seguenti azioni API:
+ Per recuperare informazioni su un lavoro specifico, utilizza l'azione [ GetMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_GetMetadataTransferJob.html)API.

**Recupera informazioni con l'`GetMetadataTransferJob`API:**

  1. Crea ed esegui un processo di trasferimento. Chiamata dell'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.  L'`GetMetadataTransferJob`API restituisce un `MetadataTransferJobProgress` oggetto con i seguenti parametri: 
     + **successeededCount**: indica il numero di risorse trasferite correttamente durante il processo.
     + **FailedCount**: indica il numero di asset che hanno avuto esito negativo durante il processo.
     + **SkippedCount**: indica il conteggio degli asset che sono stati ignorati durante il processo.
     + **totalCount**: indica il conteggio totale degli asset nel processo di trasferimento.

     Questi parametri indicano lo stato di avanzamento del lavoro. Se lo stato è`RUNNING`, aiutano a tenere traccia del numero di risorse ancora da elaborare.

     Se si verificano errori di convalida dello schema o se **failedCount** è maggiore o uguale a 1, lo stato di avanzamento del lavoro diventa. `ERROR` Un report di errore completo per il processo viene inserito nel tuo bucket Amazon S3. Per ulteriori dettagli, consulta [Ispeziona gli errori per AWS IoT SiteWise](inspect-errors.md).
+ Per elencare i lavori correnti, utilizza l'azione [ListMetadataTransferJobs](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobs.html)API.

  Utilizza un file JSON per filtrare i lavori restituiti in base al loro stato corrente. Consultate la procedura seguente:

  1. Per specificare i filtri che desideri utilizzare, crea un file JSON AWS CLI di input. Vuoi usare:

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

     Per un elenco di `state` valori validi, consulta la Guida [ListMetadataTransferJobsFilter](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_ListMetadataTransferJobsFilter.html)di *riferimento dell'AWS IoT TwinMaker API.*

  1.  Utilizzate il file JSON come argomento nel seguente comando di AWS CLI esempio:

     ```
     aws iottwinmaker list-metadata-transfer-job --region {{your_region}} \
             --cli-input-json file://ListMetadataTransferJobsExample.json
     ```
+ Per annullare un lavoro, utilizza l'azione [CancelMetadataTransferJob](https://docs.aws.amazon.com//iot-twinmaker/latest/apireference/API_CancelMetadataTransferJob.html)API. Questa API annulla lo specifico processo di trasferimento dei metadati, senza influire sulle risorse già esportate o importate:

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