DescribeImages

Description

Describes one or more of the images available to you.

Request Parameters

  • ImageId.N - One or more image IDs
    • Required: no
    • Type: String list
  • Owner.N - Filters the images by the owner
  • ExecutableBy.N - Scopes the images by users with explicit launch permissions
    • Required: no
    • Type: String list
    • Valid values: self | all | <project_name>

Supported filters

  • description - The description for the snapshot
  • image-id - The ID of the image
  • image-name - The name of the image
  • is-public - A Boolean that indicates whether the image is public
  • owner-alias - The alias of the snapshot owner (for example, croc)
  • owner-id - The ID of the image owner
  • platform - The platform (for example, generic, redhat)
  • state - The state of the image
  • virtualization-type - The virtualization type (kvm-virtio | legacy)

Response Elements

  • imageSet - Information about one or more images
  • requestId - The ID of the request

Examples

c2-ec2 DescribeImages Owner.1 self ImageId.1 <image_id>

c2-ec2 DescribeImages ExecutableBy.1 <project_name1> ExecutableBy.2 <project_name2>