[ aws . emr-containers ]
list-virtual-clusters
Описание
Отображает информацию о заданном виртуальном кластере. Виртуальный кластер — это управляемый объект в Amazon EMR на EKS. Вы можете создавать, описывать, перечислять и удалять виртуальные кластеры. Они не потребляют дополнительных ресурсов в вашей системе. Один виртуальный кластер соответствует одному пространству имен Kubernetes. Учитывая эту взаимосвязь, вы можете моделировать виртуальные кластеры таким же образом, как вы моделируете пространства имен Kubernetes, чтобы удовлетворить свои потребности.
См. также: Документацию API AWS
list-virtual-clusters является постраничной операцией. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничную загрузку, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничной загрузкой, аргумент --query должен извлекать данные из результатов следующих выражений запроса: virtualClusters
Синтаксис
list-virtual-clusters
[--container-provider-id <value>]
[--container-provider-type <value>]
[--created-after <value>]
[--created-before <value>]
[--states <value>]
[--eks-access-entry-integrated | --no-eks-access-entry-integrated]
[--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]
Параметры
--container-provider-id (строка)
--container-provider-type (строка)
Тип поставщика контейнеров виртуального кластера. Amazon EKS — единственный поддерживаемый тип на данный момент.
Возможные значения:
EKS
--created-after (метка времени)
--created-before (метка времени)
--states (список)
Состояния запрашиваемых виртуальных кластеров.
(строка)
Синтаксис:
"string" "string" ...
Where valid values are:
RUNNING
TERMINATING
TERMINATED
ARRESTED
--eks-access-entry-integrated | --no-eks-access-entry-integrated (логическое значение)
--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 (логическое значение)
Включить отладку логов.
--endpoint-url (строка)
Переопределить URL по умолчанию команды на указанный URL.
--no-verify-ssl (логическое значение)
По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого соединения SSL AWS CLI проверяет сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.
--no-paginate (логическое значение)
Отключить автоматическую постраничную загрузку. Если автоматическая постраничная загрузка отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования для вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использование определенного профиля из файла учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Отображение версии этого инструмента.
--color (строка)
Включение/выключение цветного вывода.
- on
- off
- auto
--no-sign-request (логическое значение)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (строка)
Файл с набором сертификатов CA для проверки сертификатов SSL. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет выполняться без блокировки и без таймаута. Значение по умолчанию составляет 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения сокета в секундах. Если значение установлено в 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-auto-prompt (логическое значение)
Автоматически запрашивать параметры входных данных CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запроса параметров входных данных CLI.
Вывод
virtualClusters -> (список)
Этот вывод отображает указанные виртуальные кластеры.
(структура)
Этот объект описывает виртуальный кластер. Виртуальный кластер — это пространство имен Kubernetes, с которым зарегистрирован Amazon EMR. Amazon EMR использует виртуальные кластеры для запуска задач и размещения конечных точек. Несколько виртуальных кластеров могут быть основаны на одном физическом кластере. Однако каждый виртуальный кластер соответствует одному пространству имен в кластере Amazon EKS. Виртуальные кластеры не создают никаких активных ресурсов, которые вносят вклад в ваш счет или требуют управления жизненным циклом вне службы.
id -> (строка)
name -> (строка)
arn -> (строка)
state -> (строка)
containerProvider -> (структура)
Поставщик контейнеров виртуального кластера.
type -> (строка)
id -> (строка)
info -> (структура помеченных объединений)
Информация о контейнерном кластере.
Примечание
Это структура помеченных объединений. Может быть установлен только один из следующих ключевых слов верхнего уровня:eksInfo.eksInfo -> (структура)
Информация о кластере Amazon EKS.
namespace -> (строка)
createdAt -> (метка времени)
tags -> (карта)
Назначенные теги виртуального кластера.
key -> (строка)
value -> (строка)
securityConfigurationId -> (строка)
nextToken -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.