image_info.md

image_info

Get info about a Linode Image.

• Minimum Required Fields
• Examples
• Parameters
• Return Values

Minimum Required Fields

Field	Type	Required	Description
api_token	str	Required	The Linode account personal access token. It is necessary to run the module. It can be exposed by the environment variable LINODE_API_TOKEN instead. See details in Usage.

Examples

- name: Get info about an image by label
  linode.cloud.image_info:
    label: my-image

- name: Get info about an image by ID
  linode.cloud.image_info:
    id: private/12345

Parameters

Field	Type	Required	Description
id	str	Optional	The ID of the Image to resolve. (Conflicts With: label)
label	str	Optional	The label of the Image to resolve. (Conflicts With: id)

Return Values

• image - The returned Image.

  • Sample Response:

    {
      "capabilities": [
        "cloud-init",
        "distributed-sites"
      ],
      "created": "2021-08-14T22:44:02",
      "created_by": "linode",
      "deprecated": false,
      "description": "Example image description.",
      "eol": "2026-07-01T04:00:00",
      "expiry": null,
      "id": "private/15",
      "image_sharing": {
        "shared_by": null,
        "shared_with": {
          "sharegroup_count": 0,
          "sharegroup_list_url": "/images/private/15/sharegroups"
        }
      },
      "is_public": false,
      "is_shared": false,
      "label": "Debian 11",
      "regions": [
        {
          "region": "us-iad",
          "status": "available"
        }
      ],
      "size": 2500,
      "status": "available",
      "tags": [
        "repair-image",
        "fix-1"
      ],
      "total_size": 1234567,
      "type": "manual",
      "updated": "2021-08-14T22:44:02",
      "vendor": "Debian"
    }

  • See the Linode API response documentation for a list of returned fields