smartos_image_facts – Get SmartOS image details — Ansible Documentation

- AnsibleFest
- Products
- Community
- Webinars & Training
- Blog

Documentation

# smartos_image_facts – Get SmartOS image details

New in version 2.2.

- Synopsis
- Parameters
- Examples
- Status

## 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 not guaranteed to have a backwards compatible interface. [preview]
- This module is maintained by the Ansible Community. [community]

### Authors

- Adam Števko (@xen0l)

Hint

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