DescribeImages#

Description#

Запрос на получение списка доступных образов.

Request Parameters#

  • ExecutableBy.N — Проекты, в которых можно запускать экземпляры из образа.

    • Тип: Array of strings

    • Возможные значения: self | all | <project_name>

    • Необходимо: Нет

  • Filter.N — Параметры фильтрации.

    • Тип: Список объектов Filter

    • Необходимо: Нет

  • ImageId.N — Идентификаторы образов.

    • Тип: Array of strings

    • Необходимо: Нет

  • Owner.N — Владельцы образов.

    • Тип: Array of strings

    • Возможные значения: self | k2 | <project_name>

    • Необходимо: Нет

Supported Filters#

  • description — Описание образа.

  • image-id — Идентификатор образа.

  • name — Имя образа.

  • is-public — Boolean, определяющий, открыт ли к образу общий доступ.

  • owner-alias — Алиас владельца образа (возможные значения — self, shared, k2).

  • owner-id — Идентификатор владельца образа.

  • platform — Платформа (например, generic, redhat).

  • state — Состояние образа (возможные значения — available, failed, pending).

  • tag:<tag-key> — Пара ключ/значение тега. Ключ тега передаётся в названии фильтра, значение тега — в значении фильтра.

  • tag-key — Ключ тега. Такой фильтр позволяет получить образы с тегом с указанным ключом и любым значением.

  • type — Тип образа (возможные значения — backup, regular).

  • virtualization-type — Тип виртуализации (возможные значения — hvm, hvm-legacy).

Response Elements#

  • imageSet — Информация об образах.

    • Тип: Список объектов Image

  • requestId — Идентификатор запроса.

    • Тип: String

Examples#

c2-ec2 DescribeImages Owner.1 self ImageId.1 cmi-3CE869E3

c2-ec2 DescribeImages ExecutableBy.1 default@company Filter.1.Name state Filter.1.Value.1 available

c2-ec2 DescribeImages Filter.1.Name tag-key Filter.1.Value.1 "some-key"