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 recuperar o status e os detalhes de um job da Ansible Automation Platform (Automation Controller). Use esta ação para consultar um job criado por ansible.job.launch . Esta ação se baseia na ação base http.get.
Endpoint: GET https://{host}/api/controller/v2/jobs/{jobId}/
Pré-requisitos Antes de usar esta ação na automação do fluxo de trabalho, é necessário ter:
Uma instância da plataforma Ansible Automation (Automation Controller) acessível por HTTPS. Um token OAuth2 com escopo de gravação (crie um em Automation Controller → Usuários → Tokens ) O ID numérico do job a ser consultado (normalmente o campo id retornado por ansible.job.launch). Obter status do trabalho Obter o status de um trabalho do Ansible Obtém o status e os detalhes de um job do Automation Controller. Construído na ação base http.get.
Os status do trabalho progridem de pending para waiting para running antes de atingir um estado terminal:successful, failed, error ou canceled.
Entradas Saídas Exemplo
Campo de entrada
Opcionalidade
Tipo
Exemplo
hospedar
Obrigatório
Corda
${{ :secrets:host }}
Nome do host (e porta opcional) do Automation Controller, sem esquema, por exemplo, aap.example.com .
authToken
Obrigatório
Corda
${{ :secrets:ansibleControllerToken }}
Token OAuth2, enviado como Authorization: Bearer <token>.
jobId
Obrigatório
Interno
128
ID numérico do job. Normalmente o id retornado por ansible.job.launch.
selectors
Opcional
Lista
[ { "name" : "status" , "expression" : ".status" } , { "name" : "finished" , "expression" : ".finished" } , { "name" : "failed" , "expression" : ".failed" } ]
Campo de saída
Tipo
Exemplo
success
Boleano
success: true | false
response
Objeto
"started" : "2026-07-08T10:00:00Z" ,
"finished" : "2026-07-08T10:02:13Z" ,
errorMessage
Corda
{ "detail": "Not found." }
Exemplo de fluxo de trabalho
description : 'Fetches the status of a previously launched Ansible job.'
action : ansible.job.getStatus
host : $ { { : secrets : host } }
authToken : $ { { : secrets : ansibleControllerToken } }