DescribeImages

Description

Describes one or more of the images available to you.

Request Parameters

  • ImageId.N - One or more image IDs

    • Type: String

    • Required: No

  • Owner.N - Filters the images by the owner

    • Type: String

    • Valid values: self | templates@cloud.croc.ru | <project_name>

    • Required: No

  • ExecutableBy.N - Scopes the images by users with explicit launch permissions

    • Type: String

    • Valid values: self | all | <project_name>

    • Required: No

  • Filter.N - Filters used in search

    • Type: List of Filter objects

    • Required: No

Supported filters

  • description - The description of the snapshot

    • Type: String

    • Required: No

  • image-id - The ID of the image

    • Type: String

    • Required: No

  • image-name - The name of the image

    • Type: String

    • Required: No

  • is-public - A Boolean that indicates whether the image is public

    • Type: String

    • Required: No

  • owner-alias - The alias of the image owner (for example, croc)

    • Type: String

    • Required: No

  • owner-id - The ID of the image owner

    • Type: String

    • Required: No

  • platform - The platform (for example, generic, redhat)

    • Type: String

    • Required: No

  • state - The state of the image

    • Type: String

    • Required: No

  • tag:<tag-key> - Key/value pair of the Tag. Tag key is set in the name of a filter, Tag value – in the value of the filter.

    • Type: String

    • Required: No

  • tag-key - Tag key. This filter is used to get images with Tag with the specified key and any value.

    • Type: String

    • Required: No

  • virtualization-type – Virtualization type (hvm | hvm-legacy)

    • Type: String

    • Required: No

Response Elements

  • imageSet - Information about one or more images

    • Type: List of Image objects

  • requestId - The ID of the request

    • Type: String

Examples

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

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

c2-ec2 DescribeImages Filter.1.Key tag:<tag-key> Filter.1.Value "tag-value"