describe-instances

Описание

Описывает указанные экземпляры или все экземпляры.

Если вы указываете идентификаторы экземпляров, в выходные данные включается информация только для указанных экземпляров. Если вы указываете фильтры, в выходные данные включается информация только для тех экземпляров, которые соответствуют критериям фильтра. Если вы не указываете идентификаторы экземпляров или фильтры, в выходные данные включается информация для всех экземпляров, что может повлиять на производительность. Мы рекомендуем использовать постраничный вывод, чтобы операция возвращалась быстро и успешно.

Если вы укажете недействительный идентификатор экземпляра, будет возвращена ошибка. Если вы указываете экземпляр, который вам не принадлежит, он не будет включен в выходные данные.

Недавно завершенные экземпляры могут появляться в возвращаемых результатах. Этот интервал обычно меньше одного часа.

Если вы описываете экземпляры в редком случае, когда в зоне доступности происходит сбой службы, и вы указываете идентификаторы экземпляров, которые находятся в затронутой зоне, или вообще не указываете никаких идентификаторов экземпляров, вызов завершается ошибкой. Если вы описываете экземпляры и указываете только идентификаторы экземпляров, которые находятся в незатронутой зоне, вызов работает нормально.

API Amazon EC2 использует модель конечной согласованности. Это означает, что результат API-команды, которую вы выполняете для создания или изменения ресурсов, может не быть сразу доступен для всех последующих команд, которые вы выполняете. Инструкции по управлению конечной согласованностью см. в разделе «Конечная согласованность в API Amazon EC2» в руководстве разработчика Amazon EC2.

Предупреждение

Сильно рекомендуем использовать только постраничные запросы. Непостраничные запросы уязвимы к ограничению скорости и временным ограничениям.

Примечание

Порядок элементов в ответе, включая те, которые находятся во вложенных структурах, может отличаться. Приложения не должны предполагать, что элементы появляются в определённом порядке.

См. также: Документация API AWS

describe-instances — это постраничная операция. Для получения всего набора результатов могут быть выполнены несколько API-вызовов. Вы можете отключить постраничный вывод, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе на запрос, аргумент --query должен извлекать данные из результатов следующих выражений запроса: Reservations

Синтаксис

  describe-instances
[--instance-ids <value>]
[--dry-run | --no-dry-run]
[--filters <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--generate-cli-skeleton <value>]
[--debug]
[--endpoint-url <value>]
[--no-verify-ssl]
[--no-paginate]
[--output <value>]
[--query <value>]
[--profile <value>]
[--region <value>]
[--version <value>]
[--color <value>]
[--no-sign-request]
[--ca-bundle <value>]
[--cli-read-timeout <value>]
[--cli-connect-timeout <value>]
[--cli-binary-format <value>]
[--no-cli-pager]
[--cli-auto-prompt]
[--no-cli-auto-prompt]

Параметры

--instance-ids (список)

Идентификаторы экземпляров.

По умолчанию: Описывает все ваши экземпляры.

(строка)

Синтаксис:

"string" "string" ...

--dry-run | --no-dry-run (логическое значение)

Проверяет, имеете ли вы необходимые разрешения для операции, не выполняя фактического запроса, и предоставляет ответ об ошибке. Если у вас есть необходимые разрешения, ответ об ошибке — DryRunOperation. В противном случае — UnauthorizedOperation.

--filters (список)

Фильтры.

affinity - Параметр сродства для экземпляра, работающего на выделенном хосте (default | host ).
architecture - Архитектура экземпляра (i386 | x86_64 | arm64 ).
availability-zone - Зона доступности экземпляра.
block-device-mapping.attach-time - Время подключения для тома EBS, сопоставленного с экземпляром, например, 2022-09-15T17:15:20.000Z .
block-device-mapping.delete-on-termination - Булево значение, указывающее, будет ли том EBS удален при завершении работы экземпляра.
block-device-mapping.device-name - Имя устройства, указанное в сопоставлении блочных устройств (например, /dev/sdh или xvdh ).
block-device-mapping.status - Статус тома EBS (attaching | attached | detaching | detached ).
block-device-mapping.volume-id - Идентификатор тома EBS.
boot-mode - Режим загрузки, указанный в AMI (legacy-bios | uefi | uefi-preferred ).
capacity-reservation-id - Идентификатор резервирования емкости, в котором был запущен экземпляр.
capacity-reservation-specification.capacity-reservation-preference - Предпочтение экземпляра по резервированию емкости (open | none ).
capacity-reservation-specification.capacity-reservation-target.capacity-reservation-id - Идентификатор целевого резервирования емкости.
capacity-reservation-specification.capacity-reservation-target.capacity-reservation-resource-group-arn - ARN целевой группы резервирования емкости.
client-token - Маркер идемпотентности, предоставленный при запуске экземпляра.
current-instance-boot-mode - Режим загрузки, используемый для запуска или запуска экземпляра (legacy-bios | uefi ).
dns-name - Публичное DNS-имя экземпляра.
ebs-optimized - Булево значение, указывающее, оптимизирован ли экземпляр для ввода/вывода Amazon EBS.
ena-support - Булево значение, указывающее, включена ли усовершенствованная сеть с ENA для экземпляра.
enclave-options.enabled - Булево значение, указывающее, включены ли для экземпляра Nitro Enclaves Amazon Web Services.
hibernation-options.configured - Булево значение, указывающее, включена ли функция приостановки для экземпляра. Значение true означает, что функция приостановки включена.
host-id - Идентификатор выделенного хоста, на котором работает экземпляр, если применимо.
hypervisor - Тип гипервизора экземпляра (ovm | xen ). Значение xen используется для гипервизоров Xen и Nitro.
iam-instance-profile.arn - Профиль экземпляра, связанный с экземпляром. Указан в формате ARN.
iam-instance-profile.id - Профиль экземпляра, связанный с экземпляром. Указан в формате ID.
image-id - Идентификатор образа, используемого для запуска экземпляра.
instance-id - Идентификатор экземпляра.
instance-lifecycle - Указывает, является ли это экземпляром Spot, запланированным экземпляром или блоком емкости (spot | scheduled | capacity-block ).
instance-state-code - Состояние экземпляра в виде 16-битного беззнакового целого числа. Старший байт используется для внутренних целей и должен быть проигнорирован. Младший байт устанавливается на основе представленного состояния. Допустимые значения: 0 (ожидание), 16 (запущен), 32 (завершение), 48 (завершён), 64 (остановка), и 80 (остановлен).
instance-state-name - Состояние экземпляра (pending | running | shutting-down | terminated | stopping | stopped ).
instance-type - Тип экземпляра (например, t2.micro ).
instance.group-id - Идентификатор группы безопасности для экземпляра.
instance.group-name - Название группы безопасности для экземпляра.
ip-address - Публичный IPv4-адрес экземпляра.
ipv6-address - IPv6-адрес экземпляра.
kernel-id - Идентификатор ядра.
key-name - Название пары ключей, используемой при запуске экземпляра.
launch-index - При запуске нескольких экземпляров это индекс экземпляра в группе запуска (например, 0, 1, 2 и т. д.).
launch-time - Время запуска экземпляра в формате ISO 8601 в часовом поясе UTC (ГГГГ-ММ-ДДThч:мм:сс.мсZ), например, 2021-09-29T11:04:43.305Z . Вы можете использовать подстановочный знак (* ), например, 2021-09-29T* , который соответствует всему дню.
maintenance-options.auto-recovery - Текущее поведение автоматического восстановления экземпляра (disabled | default ).
metadata-options.http-endpoint - Статус доступа к конечной точке HTTP-метаданных на вашем экземпляре (enabled | disabled )
metadata-options.http-protocol-ipv4 - Указывает, включена ли конечная точка IPv4 (disabled | enabled ).
metadata-options.http-protocol-ipv6 - Указывает, включена ли конечная точка IPv6 (disabled | enabled ).
metadata-options.http-put-response-hop-limit - Предел прыжков ответа на запрос HTTP-метаданных (целое число, возможные значения от 1 до 64 )
metadata-options.http-tokens - Состояние авторизации запроса метаданных (optional | required )
metadata-options.instance-metadata-tags - Статус доступа к меткам экземпляра из метаданных экземпляра (enabled | disabled )
metadata-options.state - Состояние изменений параметров метаданных (pending | applied ).
monitoring-state - Указывает, включен ли подробный мониторинг (disabled | enabled ).
network-interface.addresses.association.allocation-id - Идентификатор выделения.
network-interface.addresses.association.association-id - Идентификатор ассоциации.
network-interface.addresses.association.carrier-ip - Адрес транспортной сети.
network-interface.addresses.association.customer-owned-ip - Адрес IP, принадлежащий клиенту.
network-interface.addresses.association.ip-owner-id - Идентификатор владельца частного IPv4-адреса, связанного с сетевым интерфейсом.
network-interface.addresses.association.public-dns-name - Публичное DNS-имя.
network-interface.addresses.association.public-ip - Идентификатор ассоциации Elastic IP-адреса (IPv4) с сетевым интерфейсом.
network-interface.addresses.primary - Указывает, является ли IPv4-адрес сетевого интерфейса основным частным IPv4-адресом.
network-interface.addresses.private-dns-name - Частное DNS-имя.
network-interface.addresses.private-ip-address - Частный IPv4-адрес, связанный с сетевым интерфейсом.
network-interface.association.allocation-id - Идентификатор выделения, возвращённый при выделении Elastic IP-адреса (IPv4) для вашего сетевого интерфейса.
network-interface.association.association-id - Идентификатор ассоциации, возвращённый при ассоциации сетевого интерфейса с IPv4-адресом.
network-interface.association.carrier-ip - Адрес IP, принадлежащий клиенту.
network-interface.association.customer-owned-ip - Адрес IP, принадлежащий клиенту.
network-interface.association.ip-owner-id - Владелец Elastic IP-адреса (IPv4), связанного с сетевым интерфейсом.
network-interface.association.public-dns-name - Публичное DNS-имя.
network-interface.association.public-ip - Адрес Elastic IP-адреса (IPv4), привязанного к сетевому интерфейсу.
network-interface.attachment.attach-time - Время подключения сетевого интерфейса к экземпляру.
network-interface.attachment.attachment-id - Идентификатор подключения интерфейса.
network-interface.attachment.delete-on-termination - Указывает, будет ли подключение удалено при завершении работы экземпляра.
network-interface.attachment.device-index - Индекс устройства, к которому подключен сетевой интерфейс.
network-interface.attachment.instance-id - Идентификатор экземпляра, к которому подключен сетевой интерфейс.
network-interface.attachment.instance-owner-id - Идентификатор владельца экземпляра, к которому подключен сетевой интерфейс.
network-interface.attachment.network-card-index - Индекс сетевой карты.
network-interface.attachment.status - Статус подключения (attaching | attached | detaching | detached ).
network-interface.availability-zone - Зона доступности для сетевого интерфейса.
network-interface.deny-all-igw-traffic - Булево значение, указывающее, недоступен ли сетевой интерфейс с IPv6-адресом из общедоступного интернета.
network-interface.description - Описание сетевого интерфейса.
network-interface.group-id - Идентификатор группы безопасности, связанной с сетевым интерфейсом.
network-interface.group-name - Название группы безопасности, связанной с сетевым интерфейсом.
network-interface.ipv4-prefixes.ipv4-prefix - IPv4-префиксы, назначенные сетевому интерфейсу.
network-interface.ipv6-address - IPv6-адрес, связанный с сетевым интерфейсом.
network-interface.ipv6-addresses.ipv6-address - IPv6-адрес, связанный с сетевым интерфейсом.
network-interface.ipv6-addresses.is-primary-ipv6 - Булево значение, указывающее, является ли это основным IPv6-адресом.
network-interface.ipv6-native - Булево значение, указывающее, является ли это сетевым интерфейсом только с IPv6.
network-interface.ipv6-prefixes.ipv6-prefix - IPv6-префикс, назначенный сетевому интерфейсу.
network-interface.mac-address - MAC-адрес сетевого интерфейса.
network-interface.network-interface-id - Идентификатор сетевого интерфейса.
network-interface.operator.managed - Булево значение, указывающее, имеет ли экземпляр управляемый сетевой интерфейс.
network-interface.operator.principal - Сущность, управляющая сетевым интерфейсом. Действительно только для экземпляров с управляемыми сетевыми интерфейсами, где managed равно true .
network-interface.outpost-arn - ARN объекта Outpost.
network-interface.owner-id - Идентификатор владельца сетевого интерфейса.
network-interface.private-dns-name - Частное DNS-имя сетевого интерфейса.
network-interface.private-ip-address - Частный IPv4-адрес.
network-interface.public-dns-name - Публичное DNS-имя.
network-interface.requester-id - Идентификатор запрашивающего для сетевого интерфейса.
network-interface.requester-managed - Указывает, управляется ли сетевой интерфейс Amazon Web Services.
network-interface.status - Статус сетевого интерфейса (available ) | in-use ).
network-interface.source-dest-check - Выполняет ли сетевой интерфейс проверку источника/назначения. Значение true означает, что проверка включена, а false означает, что проверка отключена. Значение должно быть false для того, чтобы сетевой интерфейс выполнял трансляцию сетевых адресов (NAT) в вашей VPC.
network-interface.subnet-id - Идентификатор подсети для сетевого интерфейса.
network-interface.tag-key - Ключ метки, назначенной сетевому интерфейсу.
network-interface.tag-value - Значение метки, назначенной сетевому интерфейсу.

network-interface.vpc-id — Идентификатор VPC для сетевого интерфейса.
network-performance-options.bandwidth-weighting — Место применения повышения производительности, если применимо. Допустимые значения: default, vpc-1, ebs-1.
operator.managed — Логическое значение, указывающее, является ли это управляемым экземпляром.
operator.principal — Сущность, управляющая экземпляром. Действительно только для управляемых экземпляров, где managed является true.
outpost-arn — Amazon Resource Name (ARN) ретранслятора.
owner-id — Идентификатор учетной записи Amazon Web Services владельца экземпляра.
placement-group-name — Название группы размещения для экземпляра.
placement-partition-number — Раздел, в котором расположен экземпляр.
platform — Платформа. Чтобы отобразить только экземпляры Windows, используйте windows.
platform-details — Платформа (Linux/UNIX | Red Hat BYOL Linux | Red Hat Enterprise Linux | Red Hat Enterprise Linux with HA | Red Hat Enterprise Linux with SQL Server Standard and HA | Red Hat Enterprise Linux with SQL Server Enterprise and HA | Red Hat Enterprise Linux with SQL Server Standard | Red Hat Enterprise Linux with SQL Server Web | Red Hat Enterprise Linux with SQL Server Enterprise | SQL Server Enterprise | SQL Server Standard | SQL Server Web | SUSE Linux | Ubuntu Pro | Windows | Windows BYOL | Windows with SQL Server Enterprise | Windows with SQL Server Standard | Windows with SQL Server Web).
private-dns-name — Частное имя DNS IPv4 экземпляра.
private-dns-name-options.enable-resource-name-dns-a-record — Логическое значение, указывающее, нужно ли отвечать на запросы DNS для имен хостов экземпляров с помощью записей DNS A.
private-dns-name-options.enable-resource-name-dns-aaaa-record — Логическое значение, указывающее, нужно ли отвечать на запросы DNS для имен хостов экземпляров с помощью записей DNS AAAA.
private-dns-name-options.hostname-type — Тип имени хоста (ip-name | resource-name).
private-ip-address — Частный IPv4-адрес экземпляра. Это можно использовать только для фильтрации по основному IP-адресу сетевого интерфейса, подключенного к экземпляру. Для фильтрации по дополнительным IP-адресам, назначенным сетевому интерфейсу, используйте фильтр network-interface.addresses.private-ip-address.
product-code — Код продукта, связанный с AMI, используемой для запуска экземпляра.
product-code.type — Тип кода продукта (devpay | marketplace).
ramdisk-id — Идентификатор RAM-диска.
reason — Причина текущего состояния экземпляра (например, показывает «Инициализирован пользователем [дата]», когда вы останавливаете или завершаете экземпляр). Аналогично фильтру state-reason-code.
requester-id — Идентификатор сущности, которая запустила экземпляр от вашего имени (например, Amazon Web Services Management Console, Auto Scaling и т. д.).
reservation-id — Идентификатор резервации экземпляра. Идентификатор резервации создается всякий раз, когда вы запускаете экземпляр. Идентификатор резервации имеет однозначное соответствие с запросом на запуск экземпляра, но может быть связан с более чем одним экземпляром, если вы запускаете несколько экземпляров с помощью одного запроса на запуск. Например, если вы запускаете один экземпляр, вы получаете один идентификатор резервации. Если вы запускаете десять экземпляров с помощью одного запроса на запуск, вы также получаете один идентификатор резервации.
root-device-name — Имя устройства тома основного устройства (например, /dev/sda1).
root-device-type — Тип тома основного устройства (ebs | instance-store).
source-dest-check — Указывает, выполняет ли экземпляр проверку источника/назначения. Значение true означает, что проверка включена, а false означает, что проверка отключена. Значение должно быть false, чтобы экземпляр выполнял трансляцию сетевых адресов (NAT) в вашей VPC.
spot-instance-request-id — Идентификатор запроса Spot Instance.
state-reason-code — Код причины изменения состояния.
state-reason-message — Сообщение, описывающее изменение состояния.
subnet-id — Идентификатор подсети для экземпляра.
tag:<key> — Сочетание «ключ/значение» тега, назначенного ресурсу. Используйте ключ тега в имени фильтра и значение тега в качестве значения фильтра. Например, чтобы найти все ресурсы, имеющие тег с ключом Owner и значением TeamA, укажите tag:Owner для имени фильтра и TeamA для значения фильтра.
tag-key — Ключ тега, назначенного ресурсу. Используйте этот фильтр, чтобы найти все ресурсы, имеющие тег с определенным ключом, независимо от значения тега.
tenancy — Аренда экземпляра (dedicated | default | host).
tpm-support — Указывает, настроен ли экземпляр для поддержки NitroTPM (v2.0).
usage-operation — Значение операции использования для экземпляра (RunInstances | RunInstances:00g0 | RunInstances:0010 | RunInstances:1010 | RunInstances:1014 | RunInstances:1110 | RunInstances:0014 | RunInstances:0210 | RunInstances:0110 | RunInstances:0100 | RunInstances:0004 | RunInstances:0200 | RunInstances:000g | RunInstances:0g00 | RunInstances:0002 | RunInstances:0800 | RunInstances:0102 | RunInstances:0006 | RunInstances:0202).
usage-operation-update-time — Время последнего обновления операции использования, например, 2022-09-15T17:15:20.000Z.
virtualization-type — Тип виртуализации экземпляра (paravirtual | hvm).
vpc-id — Идентификатор VPC, в котором запущен экземпляр.

(структура)

Пара «имя фильтра — значение» для возврата более конкретного списка результатов из операции describe. Фильтры могут использоваться для сопоставления набора ресурсов по определенным критериям, таким как теги, атрибуты или идентификаторы.

Если вы указываете несколько фильтров, они объединяются с помощью AND, и запрос возвращает только результаты, соответствующие всем указанным фильтрам.

Дополнительную информацию см. в разделе Список и фильтрация с помощью командной строки и API в Руководстве пользователя Amazon EC2.

Имя -> (строка)

Имя фильтра. Имена фильтров чувствительны к регистру.

Значения -> (список)

Значения фильтра. Значения фильтров чувствительны к регистру. Если вы указываете несколько значений для фильтра, они объединяются с помощью OR, и запрос возвращает все результаты, соответствующие любому из указанных значений.

(строка)

Упрощенная синтаксическая конструкция:

Name=string,Values=string,string ...

Синтаксис JSON:

[
  {
    "Name": "string",
    "Values": ["string", ...]
  }
  ...
]

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставленному --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет взята буквально. Это может не быть указано вместе с --cli-input-yaml.

--starting-token (строка)

Маркер для указания точки начала постраничной обработки. Это NextToken из ранее усеченного ответа.

Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

Размер каждой страницы для получения в вызове AWS-службы. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-службы, получая меньше элементов в каждом вызове. Это может помочь предотвратить истечение времени ожидания вызовов AWS-службы.

Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов больше указанного значения, в выводе команды предоставляется NextToken. Для возобновления постраничной обработки укажите значение NextToken в аргументе starting-token последующей команды. **Не** используйте элемент ответа NextToken напрямую вне AWS CLI.

Примеры использования см. в разделе Постраничная обработка в Руководстве пользователя AWS Command Line Interface.

--generate-cli-skeleton (строка) Выводит JSON-скелет в стандартный вывод без отправки запроса API. Если предоставлено без значения или со значением input, выводит пример входного JSON, который можно использовать в качестве аргумента для --cli-input-json. Аналогично, если предоставлено yaml-input, он выведет пример входного YAML, который можно использовать с --cli-input-yaml. Если предоставлено значение output, оно проверяет входные данные команды и возвращает пример выходного JSON для этой команды. Сгенерированный JSON-скелет не является стабильным между версиями AWS CLI, и нет гарантий обратной совместимости в сгенерированном JSON-скелете.

Глобальные параметры

--debug (boolean)

Включить отладочную запись в журнал.

--endpoint-url (string)

Переопределить URL по умолчанию команды заданным URL.

--no-verify-ssl (boolean)

По умолчанию AWS CLI использует SSL при общении с сервисами AWS. Для каждого SSL-соединения AWS CLI будет проверять SSL-сертификаты. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.

--no-paginate (boolean)

Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI сделает только один вызов для первой страницы результатов.

--output (string)

Стиль форматирования вывода команды.

json
text
table
yaml
yaml-stream

--query (string)

Запрос JMESPath для фильтрации данных ответа.

--profile (string)

Использовать определенный профиль из файла учетных данных.

--region (string)

Регион для использования. Переопределяет настройки из конфигурации/среды.

--version (string)

Отобразить версию этого инструмента.

--color (string)

Включить/выключить цветной вывод.

on
off
auto

--no-sign-request (boolean)

Не подписывать запросы. Учетные данные не будут загружены, если этот параметр указан.

--ca-bundle (string)

Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки из конфигурации/среды.

--cli-read-timeout (int)

Максимальное время чтения сокета в секундах. Если значение равно 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-connect-timeout (int)

Максимальное время подключения сокета в секундах. Если значение равно 0, подключение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию составляет 60 секунд.

--cli-binary-format (string)

Стиль форматирования для бинарных блоков. Формат по умолчанию — base64. Формат base64 ожидает, что бинарные блоки будут предоставлены как строка, закодированная в base64. Формат raw-in-base64-out сохраняет совместимость с поведением AWS CLI V1, и бинарные значения должны быть переданы буквально. При предоставлении содержимого из файла, соответствующего бинарному блоку fileb:// всегда будет обрабатываться как бинарный и будет использовать содержимое файла непосредственно, независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть должным образом отформатировано для настроенного cli-binary-format.

base64
raw-in-base64-out

--no-cli-pager (boolean)

Отключить вывод страницы cli.

--cli-auto-prompt (boolean)

Автоматически запрашивать параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматическое запросы параметров ввода CLI.

Примеры

Примечание

Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.

Если не указано иное, все примеры используют правила цитирования, аналогичные Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.

Пример 1: Описание экземпляра

Следующий describe-instances пример описывает указанный экземпляр.

aws ec2 describe-instances \
    --instance-ids i-1234567890abcdef0

Вывод:

{
    "Reservations": [
        {
            "Groups": [],
            "Instances": [
                {
                    "AmiLaunchIndex": 0,
                    "ImageId": "ami-0abcdef1234567890",
                    "InstanceId": "i-1234567890abcdef0",
                    "InstanceType": "t3.nano",
                    "KeyName": "my-key-pair",
                    "LaunchTime": "2022-11-15T10:48:59+00:00",
                    "Monitoring": {
                        "State": "disabled"
                    },
                    "Placement": {
                        "AvailabilityZone": "us-east-2a",
                        "GroupName": "",
                        "Tenancy": "default"
                    },
                    "PrivateDnsName": "ip-10-0-0-157.us-east-2.compute.internal",
                    "PrivateIpAddress": "10-0-0-157",
                    "ProductCodes": [],
                    "PublicDnsName": "ec2-34-253-223-13.us-east-2.compute.amazonaws.com",
                    "PublicIpAddress": "34.253.223.13",
                    "State": {
                        "Code": 16,
                        "Name": "running"
                    },
                    "StateTransitionReason": "",
                    "SubnetId": "subnet-04a636d18e83cfacb",
                    "VpcId": "vpc-1234567890abcdef0",
                    "Architecture": "x86_64",
                    "BlockDeviceMappings": [
                        {
                            "DeviceName": "/dev/xvda",
                            "Ebs": {
                                "AttachTime": "2022-11-15T10:49:00+00:00",
                                "DeleteOnTermination": true,
                                "Status": "attached",
                                "VolumeId": "vol-02e6ccdca7de29cf2"
                            }
                        }
                    ],
                    "ClientToken": "1234abcd-1234-abcd-1234-d46a8903e9bc",
                    "EbsOptimized": true,
                    "EnaSupport": true,
                    "Hypervisor": "xen",
                    "IamInstanceProfile": {
                        "Arn": "arn:aws:iam::111111111111:instance-profile/AmazonSSMRoleForInstancesQuickSetup",
                        "Id": "111111111111111111111"
                    },
                    "NetworkInterfaces": [
                        {
                            "Association": {
                                "IpOwnerId": "amazon",
                                "PublicDnsName": "ec2-34-253-223-13.us-east-2.compute.amazonaws.com",
                                "PublicIp": "34.253.223.13"
                            },
                            "Attachment": {
                                "AttachTime": "2022-11-15T10:48:59+00:00",
                                "AttachmentId": "eni-attach-1234567890abcdefg",
                                "DeleteOnTermination": true,
                                "DeviceIndex": 0,
                                "Status": "attached",
                                "NetworkCardIndex": 0
                            },
                            "Description": "",
                            "Groups": [
                                {
                                    "GroupName": "launch-wizard-146",
                                    "GroupId": "sg-1234567890abcdefg"
                                }
                            ],
                            "Ipv6Addresses": [],
                            "MacAddress": "00:11:22:33:44:55",
                            "NetworkInterfaceId": "eni-1234567890abcdefg",
                            "OwnerId": "104024344472",
                            "PrivateDnsName": "ip-10-0-0-157.us-east-2.compute.internal",
                            "PrivateIpAddress": "10-0-0-157",
                            "PrivateIpAddresses": [
                                {
                                    "Association": {
                                        "IpOwnerId": "amazon",
                                        "PublicDnsName": "ec2-34-253-223-13.us-east-2.compute.amazonaws.com",
                                        "PublicIp": "34.253.223.13"
                                    },
                                    "Primary": true,
                                    "PrivateDnsName": "ip-10-0-0-157.us-east-2.compute.internal",
                                    "PrivateIpAddress": "10-0-0-157"
                                }
                            ],
                            "SourceDestCheck": true,
                            "Status": "in-use",
                            "SubnetId": "subnet-1234567890abcdefg",
                            "VpcId": "vpc-1234567890abcdefg",
                            "InterfaceType": "interface"
                        }
                    ],
                    "RootDeviceName": "/dev/xvda",
                    "RootDeviceType": "ebs",
                    "SecurityGroups": [
                        {
                            "GroupName": "launch-wizard-146",
                            "GroupId": "sg-1234567890abcdefg"
                        }
                    ],
                    "SourceDestCheck": true,
                    "Tags": [
                        {
                            "Key": "Name",
                            "Value": "my-instance"
                        }
                    ],
                    "VirtualizationType": "hvm",
                    "CpuOptions": {
                        "CoreCount": 1,
                        "ThreadsPerCore": 2
                    },
                    "CapacityReservationSpecification": {
                        "CapacityReservationPreference": "open"
                    },
                    "HibernationOptions": {
                        "Configured": false
                    },
                    "MetadataOptions": {
                        "State": "applied",
                        "HttpTokens": "optional",
                        "HttpPutResponseHopLimit": 1,
                        "HttpEndpoint": "enabled",
                        "HttpProtocolIpv6": "disabled",
                        "InstanceMetadataTags": "enabled"
                    },
                    "EnclaveOptions": {
                        "Enabled": false
                    },
                    "PlatformDetails": "Linux/UNIX",
                    "UsageOperation": "RunInstances",
                    "UsageOperationUpdateTime": "2022-11-15T10:48:59+00:00",
                    "PrivateDnsNameOptions": {
                        "HostnameType": "ip-name",
                        "EnableResourceNameDnsARecord": true,
                        "EnableResourceNameDnsAAAARecord": false
                    },
                    "MaintenanceOptions": {
                        "AutoRecovery": "default"
                    }
                }
            ],
            "OwnerId": "111111111111",
            "ReservationId": "r-1234567890abcdefg"
        }
    ]
}

Пример 2: Фильтрация по типу экземпляра

Следующий describe-instances пример использует фильтры для ограничения результатов до экземпляров указанного типа.

aws ec2 describe-instances \
    --filters Name=instance-type,Values=m5.large