list

List Images

Usage

ionosctl image list [flags]

Aliases

For image command:

[img]

For list command:

[l ls]

Description

Use this command to get a full list of available public Images.

You can filter the results using --filters option. Use the following format to set filters: --filters KEY1=VALUE1,KEY2=VALUE2. Available Filters:

• filter by property: [cloudInit cpuHotPlug cpuHotUnplug description discScsiHotPlug discScsiHotUnplug discVirtioHotPlug discVirtioHotUnplug imageAliases imageType licenceType location name nicHotPlug nicHotUnplug public ramHotPlug ramHotUnplug size]

• filter by metadata: [createdBy createdByUserId createdDate etag lastModifiedBy lastModifiedByUserId lastModifiedDate state]

Options

  -u, --api-url string        Override default host url (default "https://api.ionos.com")
      --cols strings          Set of columns to be printed on output 
                              Available columns: [ImageId Name ImageAliases Location Size LicenceType ImageType Description Public CloudInit CreatedDate CreatedBy CreatedByUserId] (default [ImageId,Name,ImageAliases,Location,LicenceType,ImageType,CloudInit,CreatedDate])
  -c, --config string         Configuration file used for authentication (default "$XDG_CONFIG_HOME/ionosctl/config.json")
  -D, --depth int32           Controls the detail depth of the response objects. Max depth is 10. (default 1)
  -F, --filters strings       Limits results to those containing a matching value for a specific property. Use the following format to set filters: --filters KEY1=VALUE1,KEY2=VALUE2
  -f, --force                 Force command to execute without user input
  -h, --help                  Print usage
      --image-alias string    Image Alias or part of Image Alias to sort Images by (DEPRECATED: incompatible with --max-results. Use --filters --order-by --max-results options instead!)
      --latest int            Show the latest N Images, based on creation date, starting from now in descending order. If it is not set, all Images will be printed (DEPRECATED: Use --filters --order-by --max-results options instead!)
      --licence-type string   The licence type of the Image (DEPRECATED: incompatible with --max-results. Use --filters --order-by --max-results options instead!)
  -l, --location string       The location of the Image (DEPRECATED: incompatible with --max-results. Use --filters --order-by --max-results options instead!)
  -M, --max-results int32     The maximum number of elements to return
      --no-headers            Don't print table headers when table output is used
      --order-by string       Limits results to those containing a matching value for a specific property
  -o, --output string         Desired output format [text|json|api-json] (default "text")
  -q, --quiet                 Quiet output
      --type string           The type of the Image (DEPRECATED: incompatible with --max-results. Use --filters --order-by --max-results options instead!)
  -v, --verbose               Print step-by-step process when running command

Examples

ionosctl image list

ionosctl image list --location us/las --type HDD --licence-type LINUX