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.

# GetJob
<a name="get-job-api"></a>

L'`GetJob`opération récupère des informations sur une tâche spécifique, notamment son statut actuel, sa configuration, ses horodatages et toute information d'erreur. Utilisez cette opération pour suivre l'avancement des tâches et vérifier les détails de configuration. Pour les tâches terminées, vous pouvez utiliser ces informations pour vérifier la réussite du traitement avant d'accéder aux résultats.

Pour plus d'informations, consultez [GetJob](https://docs.aws.amazon.com/location/latest/APIReference/API_geojobs_GetJob.html)le manuel *Amazon Location Service API Reference*.

Pour des exemples de demandes, de réponses et de commandes CLI pour cette API, consultez [Comment surveiller la progression des tâches](https://docs.aws.amazon.com/location/latest/developerguide/monitoring-job-progress.html).

## Cas d’utilisation
<a name="get-job-use-cases"></a>
+ **Suivi de l'état et de la progression des tâches :** suivez la progression du cycle de vie des tâches en fonction des états en attente, en cours et d'achèvement afin de déterminer quand le traitement est terminé et que les résultats sont disponibles au téléchargement. Surveillez l'état des tâches pour la gestion des flux de travail et les rapports.
+ **Diagnostic des erreurs :** récupérez des informations détaillées sur les erreurs en cas d'échec des tâches, y compris les messages d'erreur spécifiques et les raisons de l'échec pour résoudre les problèmes de traitement.
+ **Vérification de la configuration :** confirmez les détails de configuration des tâches, notamment les input/output emplacements, les rôles d'exécution et les fonctionnalités demandées avant le début du traitement.

## Comprendre la demande
<a name="get-job-request-parameters"></a>

La `GetJob` demande ne nécessite qu'un seul paramètre pour récupérer des informations complètes sur une tâche spécifique. Cette structure de demande simple permet de surveiller facilement l'état des tâches et de récupérer des informations détaillées de configuration et de traitement.

La demande inclut le paramètre suivant :

**Identification du poste**  
Paramètre obligatoire spécifiant la tâche pour laquelle les informations doivent être récupérées.  
+ `JobId`: identifiant unique de la tâche à récupérer. Le modèle `[-._\w]+` doit correspondre à 1 à 100 caractères. Il s'agit du même identifiant renvoyé par l'`StartJob`opération lors de la création de la tâche.

## Comprendre la réponse
<a name="get-job-response-details"></a>

La `GetJob` réponse fournit des informations sur la tâche spécifiée, notamment son statut actuel, sa configuration complète, les horodatages de traitement et toute information d'erreur. Vous pouvez utiliser cette réponse pour surveiller l'état de la tâche et résoudre les erreurs qui pourraient survenir.

La réponse inclut les champs suivants :

**Identification du poste**  
Identifiants uniques et informations de base sur le poste.  
+ `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.
+ `Name`: nom de tâche lisible par l'homme s'il est spécifié lors de la création de la tâche.

**État du poste et cycle de vie**  
Informations sur l'état actuel de la tâche et le calendrier de traitement.  
+ `Status`: État actuel de la tâche indiquant l'état du traitement (en attente, en cours, terminé, échoué, annulé ou annulé).
+ `CreatedAt`: Horodatage de la création du job au format ISO 8601.
+ `UpdatedAt`: horodatage de la dernière mise à jour du statut au format ISO 8601.
+ `EndedAt`: horodatage de fin de la tâche au format ISO 8601. Présent uniquement pour les emplois dans les États terminaux.

**Configuration de la tâche**  
Configuration complète de la tâche telle que spécifiée lors de la création.  
+ `Action`: le type d'opération en cours d'exécution (actuellement, seule `ValidateAddress` est prise en charge).
+ `ExecutionRoleArn`: ARN du rôle IAM utilisé pour accéder aux compartiments Amazon S3 lors de l'exécution des tâches.
+ `InputOptions`: configuration d'entrée, y compris l'emplacement et le format des données d'Amazon S3.
+ `OutputOptions`: Configuration de sortie incluant la destination Amazon S3 et le format de résultat.
+ `ActionOptions`: fonctionnalités supplémentaires facultatives demandées pour le travail, telles que `Position` ou`CountrySpecificAttributes`.

**Informations sur les erreurs**  
Lorsqu'une tâche échoue, la réponse inclut les détails de l'erreur pour vous aider à diagnostiquer et à résoudre le problème.  
+ `Error`: `JobError` objet contenant des informations sur l'échec. Cet objet inclut les champs suivants :
  + `Code`: code d'erreur identifiant le type de panne.
  + `Messages`: liste de messages lisibles par l'homme qui fournissent un contexte supplémentaire pour le dépannage.