View a markdown version of this page

CancelJob - Amazon Location Service
AnwendungsfälleVerstehen Sie die AnfrageVerstehe die Antwort

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

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 CancelJobin der Amazon Location Service API-Referenz.

Anfragen, Antworten und CLI-Befehle für diese API finden Sie beispielsweise unter So stornieren Sie einen Job.

Anwendungsfälle

  • 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

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

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 RegelCancelling, um anzuzeigen, dass die Stornierung im Gange ist. Der Status wechselt zu dem Cancelled Zeitpunkt, an dem die Stornierung abgeschlossen ist. Wird verwendetGetJob, 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.