DescribeInstances#

Description#

Запрос на получение списка всех существующих экземпляров и их описаний. Возможно применение одного или нескольких фильтров по параметрам экземпляров.

Request Parameters#

  • Filter.N — Фильтр по параметрам экземпляров.

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

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

  • InstanceId.N — Идентификаторы экземпляра.

    • Тип: Array of strings

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

Supported Filters#

  • affinity — Правило перезапуска экземпляра (default | host). При перезапуске экземпляра с правилом default его можно запустить на любом сервере. При перезапуске экземпляра с правилом host его можно запустить только на том сервере, на котором он был запущен ранее.

  • availability-zone — Имя зоны доступности.

  • host-id — Идентификатор выделенного сервера.

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

  • instance-id — Идентификатор экземпляра.

  • instance-state-code — Состояние экземпляра, представленное 16-разрядным числом (0 — pending | 16 — running | 32 — shutting-down | 48 — terminated | 64 — stopping | 80 — stopped).

  • instance-state-name — Состояние экземпляра.

  • instance-type — Тип экземпляра (возможные значения определены в тарифе).

  • instance.group-id — Идентификатор группы безопасности.

  • instance.group-name — Имя группы безопасности.

  • ip-address — Публичный Elastic IP-адрес.

  • monitoring-state — Состояние мониторинга (disabled | enabled).

  • network-interface.association.public-ip — Публичный Elastic IP-адрес.

  • network-interface.group-id — Идентификатор группы безопасности.

  • network-interface.group-name — Имя группы безопасности.

  • network-interface.network-interface-id — Идентификатор сетевого интерфейса.

  • owner-id — Идентификатор проекта.

  • placement-group-name — Имя группы размещения.

  • platform — Платформа (generic | redhat).

  • reservation-id — Идентификатор резервации экземпляра, который создаётся при каждом запуске экземпляра. Идентификатор резервации соответствует запросу на создание экземпляра, но может быть связан более чем с одним экземпляром, если несколько экземпляров создаются одним запросом. Например, если создать один экземпляр, будет один идентификатор резервации. Если создать десять экземпляров одним запросом, у них будет один и тот же идентификатор резервации.

  • subnet-id — Идентификатор подсети.

  • switch-id — Идентификатор виртуального коммутатора.

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

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

  • tenancy — Тип размещения (default | host).

  • virtualization-type — Тип виртуализации (hvm | hvm-legacy).

  • vpc-id — Идентификатор VPC.

Response Elements#

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

    • Тип: String

  • reservationSet — Информация о резервации.

Examples#

c2-ec2 DescribeInstances

c2-ec2 DescribeInstances InstanceId.1 i-01234567

c2-ec2 DescribeInstances Filter.1.Name <filter-name> Filter.1.Value.1 <filter-value>

c2-ec2 DescribeInstances Filter.1.Name tag:<tag-key> Filter.1.Value.1 <tag-value>

c2-ec2 DescribeInstances Filter.1.Name tag-key Filter.1.Value.1 <tag-key>