Skip to content

Latest commit

 

History

History
76 lines (60 loc) · 2.71 KB

image_list.md

File metadata and controls

76 lines (60 loc) · 2.71 KB
Raw

image_list

List and filter on Images.

Examples

- name: List all of the images for the current Linode Account
  linode.cloud.image_list: {}
- name: List the latest 5 images for the current Linode Account
  linode.cloud.image_list:
    count: 5
    order_by: created
    order: desc
- name: Resolve all Alpine Linux images
  linode.cloud.image_list:
    filters:
      - name: vendor
        values: Alpine

Parameters

Field Type Required Description
order str Optional The order to list Images in. (Choices: desc, asc; Default: asc)
order_by str Optional The attribute to order Images by.
filters (sub-options) list Optional A list of filters to apply to the resulting Images.
count int Optional The number of Images to return. If undefined, all results will be returned.

filters

Field Type Required Description
name str Required The name of the field to filter on. Valid filterable fields can be found here.
values list Required A list of values to allow for this field. Fields will pass this filter if at least one of these values matches.

Return Values

  • images - The returned Images.

    • Sample Response: 
      [
   {
      "created":"2021-08-14T22:44:02",
      "created_by":"linode",
      "deprecated":false,
      "description":"Example Image description.",
      "eol":"2026-07-01T04:00:00",
      "expiry":null,
      "id":"linode/debian11",
      "is_public":true,
      "label":"Debian 11",
      "size":2500,
      "status":null,
      "type":"manual",
      "updated":"2021-08-14T22:44:02",
      "vendor":"Debian"
   }
]
    • See the Linode API response documentation for a list of returned fields