

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

# CancelJob
<a name="cancel-job-api"></a>

L'`CancelJob`operazione interrompe un processo in esecuzione o in sospeso. È possibile annullare solo i lavori negli stati In **sospeso** o In **esecuzione**. L'annullamento è asincrono, quindi è necessario monitorare lo stato del lavoro per confermare il completamento. I lavori annullati possono avere risultati parziali nella posizione di output a seconda del momento in cui si verifica l'annullamento durante l'elaborazione.

Per ulteriori informazioni, consulta il *riferimento [CancelJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_CancelJob.html)all'API di Amazon Location Service*.

Ad esempio richieste, risposte e comandi CLI per questa API, vedi [Come annullare un lavoro](https://docs.aws.amazon.com/location/latest/developerguide/canceling-job.html).

## Casi d’uso
<a name="cancel-job-use-cases"></a>
+ **Interrompi le elaborazioni non necessarie:** annulla i lavori inviati con una configurazione errata, che non sono più necessari a causa dei cambiamenti dei requisiti aziendali o che sono stati avviati per errore. In questo modo si possono evitare sprechi di risorse e addebiti inutili.
+ **Ottimizzazione delle risorse e dei costi:** liberate la capacità di elaborazione annullando i lavori con priorità più bassa quando è necessario elaborare attività con priorità più alta.

## Comprendi la richiesta
<a name="cancel-job-request-parameters"></a>

La `CancelJob` richiesta richiede un solo parametro per identificare il lavoro da annullare. Questa semplice struttura di richiesta semplifica l'interruzione dell'elaborazione per i lavori che non sono più necessari.

La richiesta include il seguente parametro:

**Identificazione del lavoro**  
Parametro obbligatorio che specifica il processo da annullare.  
+ `JobId`: l'identificatore univoco del lavoro da annullare. Deve contenere da 1 a 100 caratteri corrispondenti allo schema. `[-._\w]+` Si tratta dello stesso identificatore restituito dall'`StartJob`operazione al momento della creazione del lavoro. È possibile annullare solo i lavori in `Running` corso `Pending` o in corso.

## Comprendi la risposta
<a name="cancel-job-response-details"></a>

La `CancelJob` risposta conferma la richiesta di annullamento e fornisce lo stato aggiornato del lavoro. Poiché l'annullamento è asincrono, è necessario utilizzare l'`GetJob`operazione per monitorare il lavoro fino al raggiungimento dello stato. `Cancelled`

La risposta include i seguenti campi:

**Identificazione del lavoro**  
Identificatori univoci per il lavoro annullato.  
+ `JobId`: L'identificatore univoco del lavoro.
+ `JobArn`: Amazon Resource Name (ARN) del lavoro annullato.

**Stato di annullamento**  
Stato attuale del lavoro dopo la richiesta di cancellazione.  
+ `Status`: Stato del lavoro subito dopo la richiesta di annullamento. In genere `Cancelling` indica che l'annullamento è in corso. Lo stato passa al `Cancelled` termine dell'annullamento. `GetJob`Da utilizzare per monitorare questa transizione.

**Nota**  
I lavori annullati possono avere risultati parziali nella posizione di output a seconda del momento in cui si verifica l'annullamento durante l'elaborazione. Controllate la posizione di output per determinare se sono stati scritti dati parziali prima del completamento dell'annullamento. Ti viene addebitato il numero di record che sono stati elaborati e scritti nel tuo bucket di output prima dell'annullamento del lavoro.