ansible.builtin.async_status – Obtain status of asynchronous task

Note

This module is part of ansible-base and included in all Ansible installations. In most cases, you can use the short module name async_status even without specifying the collections: keyword. Despite that, we recommend you use the FQCN for easy linking to the module documentation and to avoid conflicting with other collections that may have the same module name.

New in version 0.5: of ansible.builtin

Synopsis

• This module gets the status of an asynchronous task.

• This module is also supported for Windows targets.

Note

This module has a corresponding action plugin.

Parameters

Parameter	Choices/Defaults	Comments
jid string / required		Job or task identifier
mode string	Choices: cleanup status ←	If status, obtain the status. If cleanup, clean up the async job cache (by default in ~/.ansible_async/) for the specified job jid.

Notes

Note

• This module is also supported for Windows targets.

See Also

See also

Asynchronous actions and polling

Detailed information on how to use asynchronous actions and polling.

Examples

---
- name: Asynchronous yum task
  yum:
    name: docker-io
    state: present
  async: 1000
  poll: 0
  register: yum_sleeper

- name: Wait for asynchronous job to end
  async_status:
    jid: '{{ yum_sleeper.ansible_job_id }}'
  register: job_result
  until: job_result.finished
  retries: 100
  delay: 10

Return Values

Common return values are documented here, the following are the fields unique to this module:

Key	Returned	Description
ansible_job_id string	success	The asynchronous job id Sample: 360874038559.4169
finished integer	success	Whether the asynchronous job has finished (1) or not (0) Sample: 1
started integer	success	Whether the asynchronous job has started (1) or not (0) Sample: 1

Authors

• Ansible Core Team

• Michael DeHaan