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>

## Controlla l'avanzamento e i dettagli del lavoro (console)
<a name="review-job-progress-console"></a>

Visualizza [Importazione di metadati (console)](running-bulk-operations-import.md#import-metadata-console) o [Esporta i metadati (console)](running-bulk-operations-export.md#export-metadata-console) per iniziare un lavoro collettivo.

**Panoramica sullo stato di avanzamento del lavoro nel AWS IoT SiteWise console:**

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

1. Scegli Operazioni ** in blocco (Nuovo) ** dal pannello di navigazione.

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

1. La ** colonna Tipo di ** processo descrive se si tratta di un processo di esportazione o importazione. Le ** colonne ** Data importata 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. L'operazione selezionata mostra l'****esito positivo in caso di esito positivo o un elenco di errori in caso di fallimento del lavoro. 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 processi operativi 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. La `Status` e`Status reason`, fornisce 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 del lavoro.

   1. I tipi di conteggio dell'avanzamento dei lavori sono:

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

     1. `Succeeded`— Indica il numero di risorse trasferite con successo durante il processo.

     1. `Failed`— Indica il conteggio delle risorse non riuscite durante il processo.

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

1. Se il livello di avanzamento del lavoro è pari a `PENDING` o`VALIDATING`, viene visualizzato il valore di avanzamento del lavoro. `–` Ciò indica che i conteggi relativi all'avanzamento dei lavori sono in fase di valutazione.

1. Uno stato del lavoro di `RUNNING` visualizza 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 è pari a `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`, controlla la ** tabella Fallimenti del ** lavoro per i dettagli sugli errori e i fallimenti specifici. Per ulteriori dettagli, consulta [Controlla i dettagli dell'errore (console)](inspect-errors.md#inspect-errors-console). 

## Controlla 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 controllarne o aggiornarne lo stato utilizzando le seguenti azioni API:
+ Per recuperare informazioni su un processo 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: 
     + **SucceededCount**: indica il numero di risorse trasferite con successo nel processo.
     + **FailedCount**: indica il numero di risorse non riuscite durante il processo.
     + **SkippedCount**: indica il numero di risorse che sono state ignorate durante il processo.
     + **TotalCount**: indica il numero totale di risorse nel processo di trasferimento.

     Questi parametri indicano lo stato di avanzamento del processo. 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 processo passa a. `ERROR` Una segnalazione completa degli errori per il job viene inserita nel 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. Vedi 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 alle *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, usa 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}}
  ```