Obtenir le statut d'un job Ansible

Cette page fournit une référence pour l’action ansible.job.getStatus disponible dans le catalogue d’actions d’automatisation de workflow. Utilisez cette action pour interroger un job créé par ansible.job.launch jusqu’à ce qu’il atteigne un état terminal.

Pour les prérequis, voir Actions de tâche Ansible.

L’identifiant de l’action est ansible.job.getStatus.

Obtient le statut et les détails d'un job Automation Controller. Les statuts des jobs passent de pending à waiting puis à running avant d'atteindre un état terminal : successful, failed, error, ou canceled. Le point de terminaison est GET https://{host}/api/controller/v2/jobs/{jobId}/.

Le tableau suivant décrit tous les champs de saisie disponibles pour cette action.

Saisir	Type	Description	Exemple
host	Chaîne	Obligatoire. Nom d’hôte (et port facultatif) de l'Automation Controller, sans schéma.	`${{ :secrets:host }}`
authToken	Chaîne	Obligatoire. Jeton OAuth2 envoyé en tant que `Authorization: Bearer <token>` .	`${{ :secrets:ansibleControllerToken }}`
jobId	Int	Obligatoire. ID de tâche numérique à interroger. Généralement le `id` renvoyé par `ansible.job.launch` .	`128`
selectors	List	Facultatif. Sélecteurs JQ pour extraire des champs spécifiques de la sortie de l'action.	`[{"name": "status", "expression": ".status"}, {"name": "failed", "expression": ".failed"}]`

Le tableau suivant décrit tous les champs de sortie renvoyés par cette action.

Sortir	Type	Description
success	Booléen	`true` en cas de succès, `false` en cas d’échec.
response	Objet	Détails du job de l'API Automation Controller. `{ "id": 128, "status": "successful", "failed": false, "started": "2026-07-08T10:00:00Z", "finished": "2026-07-08T10:02:13Z", "elapsed": 133.0 }`
errorMessage	Chaîne	Message d’erreur en cas d'échec. `null` en cas de succès.

Sortir

Type

Description

success

Booléen

true

en cas de succès,

false

en cas d’échec.

response

Objet

Détails du job de l'API Automation Controller.

{
  "id": 128,
  "status": "successful",
  "failed": false,
  "started": "2026-07-08T10:00:00Z",
  "finished": "2026-07-08T10:02:13Z",
  "elapsed": 133.0
}

errorMessage

Chaîne

Message d’erreur en cas d'échec.

null

en cas de succès.

L'exemple suivant interroge un job Ansible et effectue un branchement en fonction du résultat.

Exemple de workflow
`name: check-ansible-job description: Fetch the status of a previously launched Ansible job steps: - name: get_status type: action action: ansible.job.getStatus version: 1 inputs: host: ${{ :secrets:host }} authToken: ${{ :secrets:ansibleControllerToken }} jobId: "128" selectors: - name: status expression: ".status" - name: failed expression: ".failed" next: end`

Exemple de workflow

name: check-ansible-job
description: Fetch the status of a previously launched Ansible job
steps:
  - name: get_status
    type: action
    action: ansible.job.getStatus
    version: 1
    inputs:
      host: ${{ :secrets:host }}
      authToken: ${{ :secrets:ansibleControllerToken }}
      jobId: "128"
      selectors:
        - name: status
          expression: ".status"
        - name: failed
          expression: ".failed"
    next: end

Cette traduction automatique est fournie pour votre commodité.

Obtenir le statut d'un job Ansible

Obtenir le statut d'un job Ansible.css-21sua1{background:none;border:none;width:0;padding:0;}

Obtenir le statut d'un job Ansible