describe-addon-versions
Описание
Описывает версии плагина.
Возвращается информация, например, о версиях Kubernetes, с которыми можно использовать плагин, о owner , publisher и type плагина.
См. также: Документация AWS API
describe-addon-versions — это страничная операция. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить страничное отображение, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с страничным отображением, аргумент --query должен извлекать данные из результатов следующих выражений запроса: addons
Синтаксис
describe-addon-versions
[--kubernetes-version <value>]
[--addon-name <value>]
[--types <value>]
[--publishers <value>]
[--owners <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]
Параметры
--kubernetes-version (строка)
--addon-name (строка)
ListAddons https://docs.aws.amazon.com/eks/latest/APIReference/API_ListAddons.html`__.--types (список)
Тип плагина. Для допустимых types не указывайте значение для этого свойства.
(строка)
Синтаксис:
"string" "string" ...
--publishers (список)
Издатель плагина. Для допустимых publishers не указывайте значение для этого свойства.
(строка)
Синтаксис:
"string" "string" ...
--owners (список)
Владелец плагина. Для допустимых owners не указывайте значение для этого свойства.
(строка)
Синтаксис:
"string" "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 (логическое значение)
Включить отладку.
--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 (целое число)
Максимальное время чтения сокета в секундах. Если значение установлено в 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-auto-prompt (логическое значение)
Автоматически запросить параметры ввода CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматический запрос параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. См. руководство по началу работы в Руководстве пользователя AWS CLI для получения дополнительной информации.
Если не указано иное, все примеры используют правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной программы. См. использование кавычек со строками в Руководстве пользователя AWS CLI.
Пример 1: Перечень всех доступных плагинов для кластера EKS
Следующий describe-addon-versions пример перечисляет все доступные плагины AWS.
aws eks describe-addon-versions \
--query 'sort_by(addons &owner)[].{publisher: publisher, owner: owner, addonName: addonName, type: type}' \
--output table
Вывод:
--------------------------------------------------------------------------------------------------------------------
| DescribeAddonVersions |
+---------------------------------------------+------------------+-----------------------+-------------------------+
| addonName | owner | publisher | type |
+---------------------------------------------+------------------+-----------------------+-------------------------+
| vpc-cni | aws | eks | networking |
| snapshot-controller | aws | eks | storage |
| kube-proxy | aws | eks | networking |
| eks-pod-identity-agent | aws | eks | security |
| coredns | aws | eks | networking |
| aws-mountpoint-s3-csi-driver | aws | s3 | storage |
| aws-guardduty-agent | aws | eks | security |
| aws-efs-csi-driver | aws | eks | storage |
| aws-ebs-csi-driver | aws | eks | storage |
| amazon-cloudwatch-observability | aws | eks | observability |
| adot | aws | eks | observability |
| upwind-security_upwind-operator | aws-marketplace | Upwind Security | security |
| upbound_universal-crossplane | aws-marketplace | upbound | infra-management |
| tetrate-io_istio-distro | aws-marketplace | tetrate-io | policy-management |
| teleport_teleport | aws-marketplace | teleport | policy-management |
| stormforge_optimize-live | aws-marketplace | StormForge | cost-management |
| splunk_splunk-otel-collector-chart | aws-marketplace | Splunk | monitoring |
| solo-io_istio-distro | aws-marketplace | Solo.io | service-mesh |
| rafay-systems_rafay-operator | aws-marketplace | rafay-systems | kubernetes-management |
| new-relic_kubernetes-operator | aws-marketplace | New Relic | observability |
| netapp_trident-operator | aws-marketplace | NetApp Inc. | storage |
| leaksignal_leakagent | aws-marketplace | leaksignal | monitoring |
| kubecost_kubecost | aws-marketplace | kubecost | cost-management |
| kong_konnect-ri | aws-marketplace | kong | ingress-service-type |
| kasten_k10 | aws-marketplace | Kasten by Veeam | data-protection |
| haproxy-technologies_kubernetes-ingress-ee | aws-marketplace | HAProxy Technologies | ingress-controller |
| groundcover_agent | aws-marketplace | groundcover | monitoring |
| grafana-labs_kubernetes-monitoring | aws-marketplace | Grafana Labs | monitoring |
| factorhouse_kpow | aws-marketplace | factorhouse | monitoring |
| dynatrace_dynatrace-operator | aws-marketplace | dynatrace | monitoring |
| datree_engine-pro | aws-marketplace | datree | policy-management |
| datadog_operator | aws-marketplace | Datadog | monitoring |
| cribl_cribledge | aws-marketplace | Cribl | observability |
| calyptia_fluent-bit | aws-marketplace | Calyptia Inc | observability |
| accuknox_kubearmor | aws-marketplace | AccuKnox | security |
+---------------------------------------------+------------------+-----------------------+-------------------------+
Для получения дополнительной информации см. Управление плагинами Amazon EKS — Создание плагина в Руководстве пользователя Amazon EKS.
Пример 2: Перечень всех доступных плагинов для указанной версии Kubernetes, поддерживаемой EKS
Следующий describe-addon-versions пример перечисляет все доступные плагины для указанной версии Kubernetes, поддерживаемой EKS.
aws eks describe-addon-versions \
--kubernetes-version=1.26 \
--query 'sort_by(addons &owner)[].{publisher: publisher, owner: owner, addonName: addonName, type: type}' \
--output table
Вывод:
--------------------------------------------------------------------------------------------------------------------
| DescribeAddonVersions |
+---------------------------------------------+------------------+-----------------------+-------------------------+
| addonName | owner | publisher | type |
+---------------------------------------------+------------------+-----------------------+-------------------------+
| vpc-cni | aws | eks | networking |
| snapshot-controller | aws | eks | storage |
| kube-proxy | aws | eks | networking |
| eks-pod-identity-agent | aws | eks | security |
| coredns | aws | eks | networking |
| aws-mountpoint-s3-csi-driver | aws | s3 | storage |
| aws-guardduty-agent | aws | eks | security |
| aws-efs-csi-driver | aws | eks | storage |
| aws-ebs-csi-driver | aws | eks | storage |
| amazon-cloudwatch-observability | aws | eks | observability |
| adot | aws | eks | observability |
| upwind-security_upwind-operator | aws-marketplace | Upwind Security | security |
| tetrate-io_istio-distro | aws-marketplace | tetrate-io | policy-management |
| stormforge_optimize-live | aws-marketplace | StormForge | cost-management |
| splunk_splunk-otel-collector-chart | aws-marketplace | Splunk | monitoring |
| solo-io_istio-distro | aws-marketplace | Solo.io | service-mesh |
| rafay-systems_rafay-operator | aws-marketplace | rafay-systems | kubernetes-management |
| new-relic_kubernetes-operator | aws-marketplace | New Relic | observability |
| netapp_trident-operator | aws-marketplace | NetApp Inc. | storage |
| leaksignal_leakagent | aws-marketplace | leaksignal | monitoring |
| kubecost_kubecost | aws-marketplace | kubecost | cost-management |
| kong_konnect-ri | aws-marketplace | kong | ingress-service-type |
| haproxy-technologies_kubernetes-ingress-ee | aws-marketplace | HAProxy Technologies | ingress-controller |
| groundcover_agent | aws-marketplace | groundcover | monitoring |
| grafana-labs_kubernetes-monitoring | aws-marketplace | Grafana Labs | monitoring |
| dynatrace_dynatrace-operator | aws-marketplace | dynatrace | monitoring |
| datadog_operator | aws-marketplace | Datadog | monitoring |
| cribl_cribledge | aws-marketplace | Cribl | observability |
| calyptia_fluent-bit | aws-marketplace | Calyptia Inc | observability |
| accuknox_kubearmor | aws-marketplace | AccuKnox | security |
+---------------------------------------------+------------------+-----------------------+-------------------------+
Для получения дополнительной информации см. Управление плагинами Amazon EKS — Создание плагина в Руководстве пользователя Amazon EKS.
Пример 3: Перечень всех доступных версий плагина vpc-cni для указанной версии Kubernetes, поддерживаемой EKS
Следующий describe-addon-versions пример перечисляет все доступные версии плагина vpc-cni для указанной версии Kubernetes, поддерживаемой EKS.
aws eks describe-addon-versions \
--kubernetes-version=1.26 \
--addon-name=vpc-cni \
--query='addons[].addonVersions[].addonVersion'
Вывод:
[
"v1.18.0-eksbuild.1",
"v1.17.1-eksbuild.1",
"v1.16.4-eksbuild.2",
"v1.16.3-eksbuild.2",
"v1.16.2-eksbuild.1",
"v1.16.0-eksbuild.1",
"v1.15.5-eksbuild.1",
"v1.15.4-eksbuild.1",
"v1.15.3-eksbuild.1",
"v1.15.1-eksbuild.1",
"v1.15.0-eksbuild.2",
"v1.14.1-eksbuild.1",
"v1.14.0-eksbuild.3",
"v1.13.4-eksbuild.1",
"v1.13.3-eksbuild.1",
"v1.13.2-eksbuild.1",
"v1.13.0-eksbuild.1",
"v1.12.6-eksbuild.2",
"v1.12.6-eksbuild.1",
"v1.12.5-eksbuild.2",
"v1.12.0-eksbuild.2"
]
Для получения дополнительной информации см. Управление плагинами Amazon EKS — Создание плагина в Руководстве пользователя Amazon EKS.
Вывод
addons -> (список)
Список доступных версий с совместимостью с Kubernetes и другими свойствами.
(структура)
Информация об аддоне.
addonName -> (строка)
type -> (строка)
addonVersions -> (список)
Объект, представляющий информацию о доступных версиях аддона и совместимых версиях Kubernetes.
(структура)
Информация о версии аддона.
addonVersion -> (строка)
architecture -> (список)
Архитектуры, поддерживаемые версией.
(строка)
computeTypes -> (список)
Указывает тип вычислений для версии аддона.
(строка)
compatibilities -> (список)
Объект, представляющий совместимость версии.
(структура)
Информация о совместимости.
clusterVersion -> (строка)
platformVersions -> (список)
Поддерживаемые вычислительные платформы.
(строка)
defaultVersion -> (логическое значение)
requiresConfiguration -> (логическое значение)
requiresIamPermissions -> (логическое значение)
publisher -> (строка)
owner -> (строка)
marketplaceInformation -> (структура)
Информация об аддоне из Amazon Web Services Marketplace.
productId -> (строка)
productUrl -> (строка)
nextToken -> (строка)
Значение nextToken для включения в будущий запрос DescribeAddonVersions. Если результаты запроса DescribeAddonVersions превышают maxResults, это значение можно использовать для получения следующей страницы результатов. Это значение равно null, когда больше результатов нет.
Примечание
Это токен следует рассматривать как неявный идентификатор, используемый только для получения следующих элементов в списке, а не для других программных целей.
© Copyright 2025, Amazon Web Services. Created using Sphinx.
