# containers.podman.podman_image_info module – Gather info about images using podman

Note

This module is part of the containers.podman collection (version 1.16.2).

It is not included in `ansible-core`. To check whether it is installed, run `ansible-galaxy collection list`.

To install it, use: `ansible-galaxy collection install containers.podman`.

To use it in a playbook, specify: `containers.podman.podman_image_info`.

## Synopsis

- Gather info about images using `podman`

## Parameters

Parameter | Comments
--- | ---
executable string | Path to `podman` executable if it is not in the `$PATH` on the machine running `podman` Default: `"podman"`
name list / elements=string | List of tags or UID to gather info about. If no name is given return info about all images.

## Notes

Note

- Podman may required elevated privileges in order to run properly.

## Examples

    - name: Gather info for all images
      containers.podman.podman_image_info:

    - name: Gather info on a specific image
      containers.podman.podman_image_info:
        name: nginx

    - name: Gather info on several images
      containers.podman.podman_image_info:
        name:
          - redis
          - quay.io/bitnami/wildfly

## Return Values

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

Key | Description
--- | ---

images

list / elements=string

info from all or specified images

Returned: always

Sample: `[{"Annotations": {}, "Architecture": "amd64", "Author": "", "Comment": "", "Config": {"Cmd": ["/bin/sh"], "Env": ["PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"]}, "Created": "2023-06-14T20:42:13.993588153Z", "Digest": "sha256:3362f865019db5f14ac5154cb0db2c3741ad1cce0416045be422ad4de441b081", "GraphDriver": {"Data": {"UpperDir": "/home/podman/.local/share/containers/storage/overlay/579b.../diff", "WorkDir": "/home/podman/.local/share/containers/storage/overlay/579b.../work"}, "Name": "overlay"}, "History": [{"created": "2023-06-14T20:42:13.893052319Z", "created_by": "/bin/sh -c #(nop) ADD file:234234234 in / "}, {"created": "2023-06-14T20:42:13.993588153Z", "created_by": "/bin/sh -c #(nop) CMD [\"/bin/sh\"]", "empty_layer": true}], "Id": "029bed813f07be84fae0344cbf8076ced5ea3c929d5f064ba617ac7d8c610a4b", "Labels": null, "ManifestType": "application/vnd.docker.distribution.manifest.v2+json", "NamesHistory": ["quay.io/podman/alpine:3.15", "quay.io/podman/alpine:3.15", "docker.io/library/alpine:3.15"], "Os": "linux", "Parent": "", "RepoDigests": ["docker.io/library/alpine@sha256:3362f865019db5f14ac5154cb0db2c3741ad1cce0416045be422ad4de441b081", "docker.io/library/alpine@sha256:c58a2fce65cb3487f965d2fb08eec4843384dbe29264f427b665421db1aabef2", "quay.io/podman/alpine@sha256:3362f865019db5f14ac5154cb0db2c3741ad1cce0416045be422ad4de441b081", "quay.io/podman/alpine@sha256:c58a2fce65cb3487f965d2fb08eec4843384dbe29264f427b665421db1aabef2", "quay.io/podman/alpine@sha256:3362f865019db5f14ac5154cb0db2c3741ad1cce0416045be422ad4de441b081", "quay.io/podman/alpine@sha256:c58a2fce65cb3487f965d2fb08eec4843384dbe29264f427b665421db1aabef2"], "RepoTags": ["docker.io/library/alpine:3.15", "quay.io/podman/alpine:3.15", "quay.io/podman/alpine:3.15"], "RootFS": {"Layers": ["sha256:579b..."], "Type": "layers"}, "Size": 11745350, "User": "", "Version": "20.10.23", "VirtualSize": 11745350}]`

### Authors

- Sam Doran (@samdoran)

### Collection links

- Issue Tracker
- Repository (Sources)