View a markdown version of this page

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

StartJob

Der StartJob Vorgang initiiert einen neuen Datenverarbeitungsauftrag für Amazon Location. Sie geben den Aktionstyp, die Eingabe- und Ausgabeorte von Amazon S3 und eine IAM-Ausführungsrolle an, die dem Service Zugriff auf Ihre Buckets gewährt. Der Vorgang gibt eine Job-ID, den Amazon-Ressourcennamen (ARN) und den Anfangsstatus zurück, anhand derer Sie den Auftragsfortschritt überwachen können.

Mithilfe des ActionOptions Parameters in StartJob Anfragen können Sie zusätzliche Funktionen anfordern. Diese Funktionen bieten erweiterte Optionen für die Datenverarbeitung und Ergebnisse.

Für ValidateAddress Jobs umfasst die Funktion Position Breiten- und Längengradkoordinaten im Format World Geodetic System (WGS 84). CountrySpecificAttributesenthält zusätzliche länderspezifische Daten, wie z. B. Informationen zur Flugroute der Fluggesellschaft, Volkszählungsdaten und postalische Identifikatoren.

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

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

Anwendungsfälle

  • Datenmigration und Systemkonsolidierung: Bereinigen und standardisieren Sie große Adressdatenmengen, wenn Sie zwischen Systemen migrieren oder mehrere Datenquellen in einer einheitlichen Datenbank konsolidieren.

  • Vorbereitung von Marketingkampagnen: Überprüfen Sie Kundenadressdatenbanken, bevor Sie Direktwerbekampagnen starten, um die Kosten für zurückgesendete Post zu senken und die Erfolgsquoten bei der Zustellung zu verbessern.

  • Datenbankpflege und Konformität: Überprüfen Sie regelmäßig bestehende Kundenadressdatenbanken, um die Datenqualitätsstandards aufrechtzuerhalten und die Anforderungen an Versand und Logistik zu erfüllen.

Verstehen Sie die Anfrage

Für die StartJob Anfrage sind Konfigurationsdetails erforderlich, in denen die Auftragsaktion, die Datenspeicherorte und die Berechtigungen angegeben sind. Diese Konfiguration bestimmt, wie Ihre Daten verarbeitet und wo die Ergebnisse gespeichert werden.

Die Anfrage umfasst die folgenden Parameter:

Arbeitsmaßnahmen und Genehmigungen

Erforderliche Parameter, die den Vorgangstyp und die Zugriffsberechtigungen definieren.

  • Action: Die Art des auszuführenden Vorgangs. Derzeit wird nur ValidateAddress unterstützt.

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

Konfiguration eingeben

Erforderliche Parameter, die angeben, wo und in welchem Format die Eingabedaten gelesen werden sollen.

  • InputOptions: Objekt, das die Eingabedatenkonfiguration enthält.

    • Location: Amazon S3 S3-ARN oder URI, in dem Eingabedateien gespeichert werden.

    • Format: Eingabedatenformat. Derzeit wird nur Parquet unterstützt.

Konfiguration der Ausgabe

Erforderliche Parameter, die angeben, wohin die Ergebnisse geschrieben werden sollen und in welchem Format.

  • OutputOptions: Objekt, das die Konfiguration der Ausgabedaten enthält.

    • Location: Amazon S3 S3-ARN oder URI, in den Ausgabedateien geschrieben werden.

    • Format: Ausgabedatenformat. Derzeit wird nur Parquet unterstützt.

Optionale Parameter

Parameter, die zusätzliche Jobkonfigurationen und Funktionen bieten.

  • Name: Für Menschen lesbarer Jobname zur leichteren Identifizierung. Muss aus 1—100 Zeichen bestehen, die dem Muster entsprechen. [-._\w]+

  • ClientToken: Idempotenz-Token, um sicherzustellen, dass derselbe Job nicht mehrfach erstellt wird. Muss aus 1—64 Zeichen bestehen, die dem Muster entsprechen. ^[!-~]+$

  • ActionOptions: Objekt, das zusätzliche Funktionen für die angegebene Aktion enthält.

    • ValidateAddress: Objekt, das spezifische Optionen für die Adressvalidierung enthält.

      • AdditionalFeatures: Array von Feature-Namen, die in die Ergebnisse aufgenommen werden sollen. Zulässige Werte:

        • Position: Schließt Breitengrad und Längengrad im WGS 84-Format für jede validierte Adresse ein.

        • CountrySpecificAttributes: Beinhaltet zusätzliche länderspezifische Daten, z. B. Routeninformationen der Fluggesellschaft, Volkszählungsdaten und postalische Identifikatoren.

Verstehe die Antwort

Die StartJob Antwort enthält wichtige Informationen für die Überwachung und Verwaltung des neu geschaffenen Jobs. Verwenden Sie diese Werte, um den Auftragsfortschritt zu verfolgen und Ergebnisse abzurufen, wenn die Verarbeitung abgeschlossen ist.

Die Antwort umfasst die folgenden Felder:

Identifizierung des Job

Eindeutige Identifikatoren für den erstellten Job.

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

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

Status und Zeitpunkt der Job

Anfangsstatus und Erstellungszeitstempel.

  • Status: Anfänglicher Jobstatus. Immer Pending für neu geschaffene Jobs.

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