Documentation

smartos_image_facts - Get SmartOS image details.

New in version 2.2.

Synopsis

  • Retrieve facts about all installed images on SmartOS. Facts will be inserted to the ansible_facts key.

Parameters

Parameter Choices/Defaults Comments
filters
Criteria for selecting image. Can be any value from image manifest and 'published_date', 'published', 'source', 'clones', and 'size'. More informaton can be found at https://smartos.org/man/1m/imgadm under 'imgadm list'.

Examples

# Return facts about all installed images.
- smartos_image_facts:

# Return all private active Linux images.
- smartos_image_facts: filters="os=linux state=active public=false"

# Show, how many clones does every image have.
- smartos_image_facts:

- debug: msg="{{ smartos_images[item]['name'] }}-{{smartos_images[item]['version'] }}
            has {{ smartos_images[item]['clones'] }} VM(s)"
  with_items: "{{ smartos_images.keys() }}"

Status

This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.

Maintenance

This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.

For a list of other modules that are also maintained by the Ansible Community, see here.

Author

  • Adam Števko (@xen0l)

Hint

If you notice any issues in this documentation you can edit this document to improve it.