Obter o status de um trabalho do Ansible

Esta página fornece uma referência para a ação ansible.job.getStatus disponível no catálogo de ações de automação de fluxo de trabalho. Use esta ação para consultar um job criado por ansible.job.launch até que ele atinja um estado terminal.

Para os pré-requisitos, consulte Ações de job do Ansible.

Obter o status de um trabalho do Ansible

O identificador da ação é ansible.job.getStatus.

Obtém o status e os detalhes de um job do Automation Controller. Os status do job progridem de pending para waiting e para running antes de atingir um estado terminal: successful, failed, error ou canceled. O endpoint é GET https://{host}/api/controller/v2/jobs/{jobId}/.

A tabela a seguir descreve todos os campos de entrada disponíveis para esta ação.

Entrada	Tipo	Descrição	Exemplo
hospedar	Corda	Obrigatório. Nome do host (e porta opcional) do Automation Controller, sem esquema.	`${{ :secrets:host }}`
authToken	Corda	Obrigatório. Token OAuth2 enviado como `Authorization: Bearer <token>` .	`${{ :secrets:ansibleControllerToken }}`
jobId	Interno	Obrigatório. ID numérico do job a ser consultado. Normalmente o `id` retornado por `ansible.job.launch` .	`128`
selectors	Lista	Opcional. Seletores JQ para extrair campos específicos da saída da ação.	`[{"name": "status", "expression": ".status"}, {"name": "failed", "expression": ".failed"}]`

A tabela a seguir descreve todos os campos de saída retornados por esta ação.

Saída	Tipo	Descrição
success	Boleano	`true` em caso de sucesso, `false` em caso de falha.
response	Objeto	Detalhes do job da API do Automation Controller. `{ "id": 128, "status": "successful", "failed": false, "started": "2026-07-08T10:00:00Z", "finished": "2026-07-08T10:02:13Z", "elapsed": 133.0 }`
errorMessage	Corda	Mensagem de erro em caso de falha. `null` em caso de sucesso.

Saída

Tipo

Descrição

success

Boleano

true

em caso de sucesso,

false

em caso de falha.

response

Objeto

Detalhes do job da API do Automation Controller.

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

errorMessage

Corda

Mensagem de erro em caso de falha.

null

em caso de sucesso.

O exemplo a seguir consulta um job do Ansible e ramifica com base no resultado.

Exemplo de fluxo de trabalho
`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`

Exemplo de fluxo de trabalho

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

Esta tradução de máquina é fornecida para sua comodidade.

Obter o status de um trabalho do Ansible

Obter o status de um trabalho do Ansible.css-21sua1{background:none;border:none;width:0;padding:0;}

Obter o status de um trabalho do Ansible