View a markdown version of this page

GetJob - Amazon Location Service
AnwendungsfälleVerstehen Sie die AnfrageVerstehen Sie 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.

GetJob

Der GetJob Vorgang ruft Informationen über einen bestimmten Job ab, einschließlich seines aktuellen Status, seiner Konfiguration, seiner Zeitstempel und aller Fehlerinformationen. Verwenden Sie diesen Vorgang, um den Auftragsfortschritt zu überwachen und die Konfigurationsdetails zu überprüfen. Bei abgeschlossenen Aufträgen können Sie anhand dieser Informationen überprüfen, ob die Verarbeitung erfolgreich war, bevor Sie auf die Ergebnisse zugreifen.

Weitere Informationen finden Sie GetJobin der Amazon Location Service API-Referenz.

Anfragen, Antworten und CLI-Befehle für diese API finden Sie beispielsweise unter So überwachen Sie den Auftragsfortschritt.

Anwendungsfälle

  • Überwachung des Auftragsstatus und des Auftragsfortschritts: Verfolgen Sie den Verlauf des Auftragslebenszyklus anhand der Status „Ausstehend“, „Aktuell“ und „Abschluss“, um festzustellen, wann die Verarbeitung abgeschlossen ist und die Ergebnisse zum Herunterladen verfügbar sind. Überwachen Sie den Auftragsstatus für das Workflow-Management und die Berichterstattung.

  • Fehlerdiagnose: Rufen Sie detaillierte Fehlerinformationen ab, wenn Jobs fehlschlagen, einschließlich spezifischer Fehlermeldungen und Fehlergründe, um Verarbeitungsprobleme zu beheben.

  • Überprüfung der Konfiguration: Bestätigen Sie die Details zur Auftragskonfiguration, einschließlich input/output Standorte, Ausführungsrollen und angeforderter Funktionen, bevor die Verarbeitung beginnt.

Verstehen Sie die Anfrage

Die GetJob Anfrage benötigt nur einen einzigen Parameter, um umfassende Informationen zu einem bestimmten Job abzurufen. Diese einfache Anforderungsstruktur macht es einfach, den Jobstatus zu überwachen und detaillierte Konfigurations- und Verarbeitungsinformationen abzurufen.

Die Anfrage umfasst den folgenden Parameter:

Identifizierung des Job

Erforderlicher Parameter, der angibt, über welchen Job Informationen abgerufen werden sollen.

  • JobId: Die eindeutige Kennung des abzurufenden 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.

Verstehen Sie die Antwort

Die GetJob Antwort enthält Informationen über den angegebenen Job, einschließlich seines aktuellen Status, der vollständigen Konfiguration, der Verarbeitungszeitstempel und aller Fehlerinformationen. Sie können diese Antwort verwenden, um den Jobstatus zu überwachen und eventuell auftretende Fehler zu beheben.

Die Antwort umfasst die folgenden Felder:

Identifizierung des Job

Eindeutige Identifikatoren und grundlegende Jobinformationen.

  • JobId: Die eindeutige Job-ID, die für Überwachungs- und Verwaltungsvorgänge verwendet wird.

  • JobArn: ARN, der den darin enthaltenen Job eindeutig identifiziert AWS.

  • Name: Für Menschen lesbarer Jobname, sofern er bei der Auftragserstellung angegeben wurde.

Jobstatus und Lebenszyklus

Informationen zum aktuellen Auftragsstatus und zum Bearbeitungszeitplan.

  • Status: Aktueller Auftragsstatus, der den Verarbeitungsstatus angibt (Ausstehend, Wird ausgeführt, Abgeschlossen, Fehlgeschlagen, Storniert oder Storniert).

  • CreatedAt: Zeitstempel für die Joberstellung im ISO 8601-Format.

  • UpdatedAt: Zeitstempel der letzten Statusaktualisierung im ISO 8601-Format.

  • EndedAt: Zeitstempel für den Abschluss des Job im ISO 8601-Format. Nur für Jobs in Endstaaten vorhanden.

Job-Konfiguration

Schließt die Auftragskonfiguration ab, wie sie bei der Erstellung angegeben wurde.

  • Action: Die Art des ausgeführten Vorgangs (ValidateAddresswird derzeit nur unterstützt).

  • ExecutionRoleArn: ARN der IAM-Rolle, der für den Zugriff auf Amazon S3 S3-Buckets während der Auftragsausführung verwendet wird.

  • InputOptions: Eingabekonfiguration einschließlich Amazon S3 S3-Standort und Datenformat.

  • OutputOptions: Ausgabekonfiguration einschließlich Amazon S3 S3-Ziel und Ergebnisformat.

  • ActionOptions: Optionale zusätzliche Funktionen, die für den Job angefordert wurden, z. B. Position oderCountrySpecificAttributes.

Informationen zum Fehler

Wenn ein Job fehlschlägt, enthält die Antwort Fehlerdetails, die Ihnen helfen, das Problem zu diagnostizieren und zu lösen.

  • Error: Ein JobError Objekt, das Details zum Fehler enthält. Dieses Objekt umfasst die folgenden Felder:

    • Code: Ein Fehlercode, der die Art des Fehlers identifiziert.

    • Messages: Eine Liste von menschenlesbaren Meldungen, die zusätzlichen Kontext für die Problembehandlung bieten.