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
<a name="start-job-api"></a>

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](https://earth-info.nga.mil/index.php?dir=wgs84&action=wgs84)). **CountrySpecificAttributes**enthält zusätzliche länderspezifische Daten, wie z. B. Informationen zur Flugroute der Fluggesellschaft, Volkszählungsdaten und postalische Identifikatoren.

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

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

## Anwendungsfälle
<a name="start-job-use-cases"></a>
+ **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
<a name="start-job-request-parameters"></a>

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](https://earth-info.nga.mil/index.php?dir=wgs84&action=wgs84) 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
<a name="start-job-response-details"></a>

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.