Obtener el estado de un trabajo de Ansible

Esta página proporciona una referencia de la acción ansible.job.getStatus disponible en el catálogo de acciones de automatización de flujos de trabajo. Utilice esta acción para sondear un trabajo creado por ansible.job.launch hasta que alcance un estado terminal.

Para conocer los requisitos previos, consulte las acciones de trabajo de Ansible.

Obtener el estado de un trabajo de Ansible

El identificador de la acción es ansible.job.getStatus.

Obtiene el estado y los detalles de un trabajo de Automation Controller. Los estados del trabajo progresan de pending a waiting a running antes de alcanzar un estado terminal: successful, failed, error o canceled. El extremo es GET https://{host}/api/controller/v2/jobs/{jobId}/.

La siguiente tabla describe todos los campos de entrada disponibles para esta acción.

Aporte	Tipo	Descripción	Ejemplo
anfitrión	Cadena	Requerido. Nombre de host (y puerto opcional) de Automation Controller, sin esquema.	`${{ :secrets:host }}`
authToken	Cadena	Requerido. Token de OAuth2 enviado como `Authorization: Bearer <token>` .	`${{ :secrets:ansibleControllerToken }}`
jobId	En t	Requerido. ID numérico del trabajo para sondear. Normalmente, el `id` devuelto por `ansible.job.launch` .	`128`
selectors	Lista	Opcional. Selectores JQ para extraer campos específicos de la salida de la acción.	`[{"name": "status", "expression": ".status"}, {"name": "failed", "expression": ".failed"}]`

La siguiente tabla describe todos los campos de salida devueltos por esta acción.

Producción	Tipo	Descripción
success	Booleano	`true` en caso de éxito, `false` en caso de falla.
response	Objeto	Detalles del trabajo de la API de Automation Controller. `{ "id": 128, "status": "successful", "failed": false, "started": "2026-07-08T10:00:00Z", "finished": "2026-07-08T10:02:13Z", "elapsed": 133.0 }`
errorMessage	Cadena	Mensaje de error en caso de falla. `null` en caso de éxito.

Producción

Tipo

Descripción

success

Booleano

true

en caso de éxito,

false

en caso de falla.

response

Objeto

Detalles del trabajo de la API de Automation Controller.

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

errorMessage

Cadena

Mensaje de error en caso de falla.

null

en caso de éxito.

El siguiente ejemplo sondea un trabajo de Ansible y se bifurca según el resultado.

Ejemplo de flujo de trabajo
`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`

Ejemplo de flujo de trabajo

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

Te ofrecemos esta traducción automática para facilitar la lectura.

Obtener el estado de un trabajo de Ansible

Obtener el estado de un trabajo de Ansible.css-21sua1{background:none;border:none;width:0;padding:0;}

Obtener el estado de un trabajo de Ansible