Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

describe-availability-zones

Описание

Описывает доступные для вас зоны доступности, локальные зоны и зоны Wavelength.

Дополнительную информацию о зонах доступности, локальных зонах и зонах Wavelength см. в разделе «Регионы и зоны» в руководстве пользователя Amazon EC2.

Примечание

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

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

Синтаксис

  describe-availability-zones
[--zone-names <value>]
[--zone-ids <value>]
[--all-availability-zones | --no-all-availability-zones]
[--dry-run | --no-dry-run]
[--filters <value>]
[--cli-input-json | --cli-input-yaml]
[--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]

Параметры

--zone-names (список)

Названия зон доступности, локальных зон и зон Wavelength.

(строка)

Синтаксис:

"string" "string" ...

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

Идентификаторы зон доступности, локальных зон и зон Wavelength.

(строка)

Синтаксис:

"string" "string" ...

--all-availability-zones | --no-all-availability-zones (логическое значение)

Включить все зоны доступности, локальные зоны и зоны Wavelength независимо от состояния подписки.

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

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

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

--filters (список)

Фильтры.

  • group-long-name — Полное имя группы зон для зоны доступности (например, US West (Oregon) 1), локальной зоны (например, для группы зон us-west-2-lax-1, это US West (Los Angeles)) или зоны Wavelength (например, для группы зон us-east-1-wl1, это US East (Verizon)).
  • group-name — Имя группы зон для зоны доступности (например, us-east-1-zg-1), локальной зоны (например, us-west-2-lax-1) или зоны Wavelength (например, us-east-1-wl1).
  • message — Сообщение зоны.
  • opt-in-status — Статус подписки (opted-in | not-opted-in | opt-in-not-required).
  • parent-zone-id — Идентификатор зоны, которая обрабатывает некоторые операции плоскости управления для локальных зон и зон Wavelength, такие как вызовы API.
  • parent-zone-name — Идентификатор зоны, которая обрабатывает некоторые операции плоскости управления для локальных зон и зон Wavelength, такие как вызовы API.
  • region-name — Имя региона для зоны (например, us-east-1).
  • state — Состояние зоны доступности, локальной зоны или зоны Wavelength (available | unavailable | constrained).
  • zone-id — Идентификатор зоны доступности (например, use1-az1), локальной зоны (например, usw2-lax1-az1) или зоны Wavelength (например, us-east-1-wl1-bos-wlz-1).
  • zone-name — Название зоны доступности (например, us-east-1a), локальной зоны (например, us-west-2-lax-1a) или зоны Wavelength (например, us-east-1-wl1-bos-wlz-1).
  • zone-type — Тип зоны (availability-zone | local-zone | wavelength-zone).

(структура)

Пара имя-значение фильтра, используемого для возврата более конкретного списка результатов операции 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.

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

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

--debug (логическое значение)

Включить отладку.

--endpoint-url (строка)

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

--no-verify-ssl (логическое значение)

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

--no-paginate (логическое значение)

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

--output (строка)

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

  • json
  • текст
  • таблица
  • yaml
  • yaml-поток

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

  • вкл
  • выкл
  • авто

--no-sign-request (логическое значение)

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

--ca-bundle (строка)

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

--cli-read-timeout (целое число)

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

--cli-connect-timeout (целое число)

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

--cli-binary-format (строка)

Стиль форматирования для двоичных блоков. Формат по умолчанию — 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 (логическое значение)

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

--cli-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Примечание

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

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

Для описания ваших зон доступности

Следующий пример describe-availability-zones отображает подробности зон доступности, доступных для вас. Ответ включает только зоны доступности для текущего региона. В этом примере используется профильный регион us-west-2 (Орегон) по умолчанию.

aws ec2 describe-availability-zones

Вывод:

{
    "AvailabilityZones": [
        {
            "State": "available",
            "OptInStatus": "opt-in-not-required",
            "Messages": [],
            "RegionName": "us-west-2",
            "ZoneName": "us-west-2a",
            "ZoneId": "usw2-az1",
            "GroupName": "us-west-2",
            "NetworkBorderGroup": "us-west-2"
        },
        {
            "State": "available",
            "OptInStatus": "opt-in-not-required",
            "Messages": [],
            "RegionName": "us-west-2",
            "ZoneName": "us-west-2b",
            "ZoneId": "usw2-az2",
            "GroupName": "us-west-2",
            "NetworkBorderGroup": "us-west-2"
        },
        {
            "State": "available",
            "OptInStatus": "opt-in-not-required",
            "Messages": [],
            "RegionName": "us-west-2",
            "ZoneName": "us-west-2c",
            "ZoneId": "usw2-az3",
            "GroupName": "us-west-2",
            "NetworkBorderGroup": "us-west-2"
        },
        {
            "State": "available",
            "OptInStatus": "opt-in-not-required",
            "Messages": [],
            "RegionName": "us-west-2",
            "ZoneName": "us-west-2d",
            "ZoneId": "usw2-az4",
            "GroupName": "us-west-2",
            "NetworkBorderGroup": "us-west-2"
        },
        {
            "State": "available",
            "OptInStatus": "opted-in",
            "Messages": [],
            "RegionName": "us-west-2",
            "ZoneName": "us-west-2-lax-1a",
            "ZoneId": "usw2-lax1-az1",
            "GroupName": "us-west-2-lax-1",
            "NetworkBorderGroup": "us-west-2-lax-1"
        }
    ]
}

Вывод

AvailabilityZones -> (список)

Информация о зонах доступности, локальных зонах и зонах Wavelength.

(структура)

Описание зон доступности, локальных зон и зон Wavelength.

OptInStatus -> (строка)

Для зон доступности этот параметр всегда имеет значение opt-in-not-required.

Для локальных зон и зон Wavelength этот параметр представляет собой статус участия. Возможные значения — opted-in и not-opted-in.

Messages -> (список)

Любые сообщения об зоне доступности, локальной зоне или зоне Wavelength.

(структура)

Описание сообщения об зоне доступности, локальной зоне или зоне Wavelength.

Message -> (строка)

Сообщение об зоне доступности, локальной зоне или зоне Wavelength.

RegionName -> (строка)

Название региона.

ZoneName -> (строка)

Имя зоны доступности, локальной зоны или зоны Wavelength.

ZoneId -> (строка)

Идентификатор зоны доступности, локальной зоны или зоны Wavelength.

GroupName -> (строка)

Название группы зон. Например:

  • Зоны доступности — us-east-1-zg-1
  • Локальные зоны — us-west-2-lax-1
  • Зоны Wavelength — us-east-1-wl1-bos-wlz-1

NetworkBorderGroup -> (строка)

Название группы сетевых границ.

ZoneType -> (строка)

Тип зоны.

Допустимые значения: availability-zone | local-zone | wavelength-zone

ParentZoneName -> (строка)

Имя зоны, которая обрабатывает некоторые операции плоскости управления локальной зоной или зоной Wavelength, такие как вызовы API.

ParentZoneId -> (строка)

Идентификатор зоны, которая обрабатывает некоторые операции плоскости управления локальной зоной или зоной Wavelength, такие как вызовы API.

GroupLongName -> (строка)

Полное имя группы зон доступности, группы локальных зон или группы зон Wavelength.

State -> (строка)

Состояние зоны доступности, локальной зоны или зоны Wavelength. Возможные значения — available, unavailable и constrained.

© Copyright 2025, Amazon Web Services. Created using Sphinx.

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API