

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

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

Der `CancelJob` Vorgang beendet einen laufenden oder ausstehenden Job. Nur Jobs mit dem **Status Ausstehend** oder Wird **ausgeführt** können storniert werden. Die Stornierung erfolgt asynchron, daher sollten Sie den Auftragsstatus überwachen, um den Abschluss zu bestätigen. Je nachdem, wann während der Verarbeitung storniert wird, kann es bei abgebrochenen Aufträgen zu Teilergebnissen im Ausgabespeicherort kommen.

Weitere Informationen finden Sie [CancelJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_CancelJob.html)in der *Amazon Location Service API-Referenz*.

Anfragen, Antworten und CLI-Befehle für diese API finden Sie beispielsweise unter [So stornieren Sie einen Job](https://docs.aws.amazon.com/location/latest/developerguide/canceling-job.html).

## Anwendungsfälle
<a name="cancel-job-use-cases"></a>
+ **Stoppen Sie unnötige Verarbeitung:** Stornieren Sie Jobs, die mit falscher Konfiguration eingereicht wurden, aufgrund geänderter Geschäftsanforderungen nicht mehr benötigt werden oder versehentlich gestartet wurden. Dadurch können verschwendete Ressourcen und unnötige Kosten vermieden werden.
+ **Ressourcen- und Kostenoptimierung: Geben** Sie Verarbeitungskapazität frei, indem Sie Aufträge mit niedrigerer Priorität stornieren, wenn Aufgaben mit höherer Priorität bearbeitet werden müssen.

## Verstehen Sie die Anfrage
<a name="cancel-job-request-parameters"></a>

Die `CancelJob` Anfrage benötigt nur einen einzigen Parameter, um zu identifizieren, welcher Job storniert werden soll. Diese einfache Anforderungsstruktur macht es einfach, die Verarbeitung von Jobs zu beenden, die nicht mehr benötigt werden.

Die Anfrage enthält den folgenden Parameter:

**Identifizierung des Job**  
Erforderlicher Parameter, der angibt, welcher Job abgebrochen werden soll.  
+ `JobId`: Die eindeutige Kennung des abzubrechenden Jobs. Muss aus 1—100 Zeichen bestehen, die dem Muster `[-._\w]+` entsprechen. Dies ist derselbe Bezeichner, der von der `StartJob` Operation zurückgegeben wurde, als der Job erstellt wurde. Nur Jobs mit dem `Running` Status `Pending` oder können storniert werden.

## Verstehe die Antwort
<a name="cancel-job-response-details"></a>

Die `CancelJob` Antwort bestätigt die Stornierungsanfrage und gibt den aktuellen Status des Jobs an. Da die Stornierung asynchron erfolgt, sollten Sie den `GetJob` Vorgang verwenden, um den Auftrag zu überwachen, bis er den `Cancelled` Status erreicht hat.

Die Antwort umfasst die folgenden Felder:

**Identifizierung des Job**  
Eindeutige Identifikatoren für den Job, der storniert wird.  
+ `JobId`: Die eindeutige Job-ID.
+ `JobArn`: Amazon-Ressourcenname (ARN) des Auftrags, der storniert wird.

**Status der Stornierung**  
Aktueller Jobstatus nach der Stornierungsanfrage.  
+ `Status`: Jobstatus unmittelbar nach der Stornierungsanfrage. In der Regel`Cancelling`, um anzuzeigen, dass die Stornierung im Gange ist. Der Status wechselt zu dem `Cancelled` Zeitpunkt, an dem die Stornierung abgeschlossen ist. Wird verwendet`GetJob`, um diesen Übergang zu überwachen.

**Anmerkung**  
Je nachdem, wann während der Verarbeitung abgebrochen wird, kann es bei abgebrochenen Aufträgen zu Teilergebnissen im Ausgabespeicherort kommen. Überprüfen Sie den Ausgabespeicherort, um festzustellen, ob Teildaten geschrieben wurden, bevor der Vorgang abgeschlossen wurde. Ihnen wird die Anzahl der Datensätze in Rechnung gestellt, die verarbeitet und in Ihren Ausgabe-Bucket geschrieben wurden, bevor der Job storniert wurde.