View a markdown version of this page

StartJob - Amazon Location Service
Cas d’utilisationComprendre la demandeComprendre la réponse

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

StartJob

L'StartJobopération lance une nouvelle tâche de traitement des données Amazon Location. Vous spécifiez le type d'action, les emplacements d'entrée et de sortie Amazon S3, ainsi qu'un rôle d'exécution IAM qui accorde au service l'accès à vos buckets. L'opération renvoie un identifiant de tâche, Amazon Resource Name (ARN) et un statut initial que vous pouvez utiliser pour suivre l'avancement de la tâche.

Vous pouvez demander des fonctionnalités supplémentaires à l'aide du ActionOptions paramètre indiqué dans les StartJob demandes. Ces fonctionnalités offrent des options améliorées pour le traitement des données et les résultats.

Pour les ValidateAddress tâches, la fonction Position inclut les coordonnées de latitude et de longitude au format World Geodetic System (WGS 84). CountrySpecificAttributesinclut des données supplémentaires spécifiques à chaque pays, telles que les informations sur les itinéraires des transporteurs, les données du recensement et les identifiants postaux.

Pour plus d'informations, consultez StartJoble manuel Amazon Location Service API Reference.

Pour des exemples de demandes, de réponses et de commandes CLI pour cette API, consultez Comment démarrer une tâche.

Cas d’utilisation

  • Migration des données et consolidation du système : nettoyez et normalisez de gros volumes de données d'adresses lors de la migration entre systèmes ou de la consolidation de plusieurs sources de données dans une base de données unifiée.

  • Préparation des campagnes marketing : validez les bases de données d'adresses des clients avant de lancer des campagnes de publipostage afin de réduire les frais de retour et d'améliorer les taux de réussite des livraisons.

  • Maintenance et conformité des bases de données : validez régulièrement les bases de données d'adresses clients existantes afin de maintenir les normes de qualité des données et de répondre aux exigences de conformité en matière d'expédition et de logistique.

Comprendre la demande

La StartJob demande nécessite des détails de configuration qui spécifient l'action de la tâche, les emplacements des données et les autorisations. Cette configuration détermine la manière dont vos données sont traitées et où les résultats sont stockés.

La demande inclut les paramètres suivants :

Action sur le job et autorisations

Paramètres obligatoires qui définissent le type d'opération et les autorisations d'accès.

  • Action: type d'opération à effectuer. Actuellement, seul ValidateAddress est pris en charge.

  • ExecutionRoleArn: ARN du rôle IAM qu'Amazon Location suppose pour accéder à vos compartiments Amazon S3 lors de l'exécution de la tâche.

Configuration d'entrée

Paramètres obligatoires qui spécifient où lire les données d'entrée et leur format.

  • InputOptions: objet contenant la configuration des données d'entrée.

    • Location: ARN ou URI Amazon S3 où les fichiers d'entrée sont stockés.

    • Format: Format des données d'entrée. Actuellement, seul Parquet est pris en charge.

Configuration de sortie

Paramètres obligatoires qui spécifient où écrire les résultats et leur format.

  • OutputOptions: objet contenant la configuration des données de sortie.

    • Location: ARN ou URI Amazon S3 dans lequel les fichiers de sortie sont écrits.

    • Format: format des données de sortie. Actuellement, seul Parquet est pris en charge.

Paramètres facultatifs

Paramètres fournissant une configuration et des fonctionnalités supplémentaires pour les tâches.

  • Name: nom de poste lisible par l'homme pour une identification plus facile. Le modèle [-._\w]+ doit correspondre à 1 à 100 caractères.

  • ClientToken: jeton d'impuissance permettant de s'assurer que le même travail n'est pas créé plusieurs fois. Le modèle ^[!-~]+$ doit correspondre à 1 à 64 caractères.

  • ActionOptions: objet contenant des fonctionnalités supplémentaires pour l'action spécifiée.

    • ValidateAddress: Objet contenant des options spécifiques à la validation des adresses.

      • AdditionalFeatures: tableau de noms de fonctionnalités à inclure dans les résultats. Valeurs valides :

        • Position: inclut la latitude et la longitude au format WGS 84 pour chaque adresse validée.

        • CountrySpecificAttributes: inclut des données supplémentaires spécifiques à chaque pays, telles que les informations sur les itinéraires des transporteurs, les données du recensement et les identifiants postaux.

Comprendre la réponse

La StartJob réponse fournit des informations essentielles pour le suivi et la gestion de l'emploi nouvellement créé. Utilisez ces valeurs pour suivre l'avancement des tâches et récupérer les résultats une fois le traitement terminé.

La réponse inclut les champs suivants :

Identification du poste

Identifiants uniques pour le travail créé.

  • JobId: identifiant de tâche unique utilisé pour les opérations de surveillance et de gestion.

  • JobArn: ARN qui identifie de manière unique la tâche qu'il contient AWS.

État du poste et calendrier

État initial et horodatage de création.

  • Status: Statut initial du poste. Toujours Pending pour les emplois nouvellement créés.

  • CreatedAt: Horodatage de la création du job au format ISO 8601.