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.
CancelJob
L'CancelJobopération arrête une tâche en cours ou en attente. Seules les tâches en attente ou en cours peuvent être annulées. L'annulation étant asynchrone, vous devez surveiller l'état de la tâche pour confirmer qu'elle est terminée. Les tâches annulées peuvent avoir des résultats partiels sur l'emplacement de sortie en fonction du moment où l'annulation intervient pendant le traitement.
Pour plus d'informations, consultez CancelJoble manuel Amazon Location Service API Reference.
Pour des exemples de demandes, de réponses et de commandes CLI pour cette API, consultez Comment annuler une tâche.
Cas d’utilisation
-
Arrêtez les traitements inutiles : annulez les tâches soumises avec une configuration incorrecte, qui ne sont plus nécessaires en raison de modifications des exigences commerciales ou qui ont été lancées par erreur. Cela permet d'éviter le gaspillage de ressources et les frais inutiles.
-
Optimisation des ressources et des coûts : libérez de la capacité de traitement en annulant les tâches moins prioritaires lorsque des tâches plus prioritaires doivent être traitées.
Comprendre la demande
La CancelJob demande ne nécessite qu'un seul paramètre pour identifier le travail à annuler. Cette structure de demande simple permet d'arrêter facilement le traitement des tâches qui ne sont plus nécessaires.
La demande inclut le paramètre suivant :
- Identification du poste
-
Paramètre obligatoire qui indique la tâche à annuler.
-
JobId: identifiant unique de la tâche à annuler. Le modèle[-._\w]+doit correspondre à 1 à 100 caractères. Il s'agit du même identifiant renvoyé par l'StartJobopération lors de la création de la tâche. Seuls les emplois en coursPendingou enRunningstatut peuvent être annulés.
-
Comprendre la réponse
La CancelJob réponse confirme la demande d'annulation et indique le statut actualisé de la tâche. L'annulation étant asynchrone, vous devez utiliser l'GetJobopération pour surveiller le travail jusqu'à ce qu'il atteigne le Cancelled statut.
La réponse inclut les champs suivants :
- Identification du poste
-
Identifiants uniques pour le travail annulé.
-
JobId: l'identifiant unique de la tâche. -
JobArn: Amazon Resource Name (ARN) de la tâche annulée.
-
- État de l'annulation
-
État actuel du poste après la demande d'annulation.
-
Status: statut du poste immédiatement après la demande d'annulation. GénéralementCancellingpour indiquer que l'annulation est en cours. Le statut passe à uneCancelledfois l'annulation terminée.GetJobÀ utiliser pour surveiller cette transition.
-
Note
Les tâches annulées peuvent avoir des résultats partiels sur l'emplacement de sortie en fonction du moment où l'annulation intervient pendant le traitement. Vérifiez l'emplacement de sortie pour déterminer si des données partielles ont été écrites avant la fin de l'annulation. Le nombre d'enregistrements traités et écrits dans votre compartiment de sortie vous est facturé avant l'annulation de la tâche.
