Spec-Zone.ru › AWS CLI v2

[ aws . elasticbeanstalk ]

describe-configuration-options

Описание

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

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

Синтаксис

  describe-configuration-options
[--application-name <value>]
[--template-name <value>]
[--environment-name <value>]
[--solution-stack-name <value>]
[--platform-arn <value>]
[--options <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]

Параметры

--application-name (строка)

Имя приложения, связанного со шаблоном конфигурации или окружением. Требуется только если вы хотите описать параметры конфигурации, связанные с шаблоном конфигурации или окружением.

--template-name (строка)

Имя шаблона конфигурации, параметры конфигурации которого требуется описать.

--environment-name (строка)

Имя окружения, параметры конфигурации которого требуется описать.

--solution-stack-name (строка)

Имя стека решений, параметры конфигурации которого требуется описать.

--platform-arn (строка)

ARN пользовательской платформы.

--options (список)

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

(структура)

Указание, идентифицирующее отдельный параметр конфигурации.

ResourceName -> (строка)

Уникальное имя ресурса для параметра конфигурации масштабирования по времени.

Namespace -> (строка)

Уникальное имя пространства имён, идентифицирующее связанный с параметром AWS-ресурс.

OptionName -> (строка)

Имя параметра конфигурации.

Сокращенный синтаксис:

ResourceName=string,Namespace=string,OptionName=string ...

Синтаксис JSON:

[
  {
    "ResourceName": "string",
    "Namespace": "string",
    "OptionName": "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 (строка)

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

--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.

Просмотр параметров конфигурации для среды

Следующая команда извлекает описания всех доступных параметров конфигурации для среды с именем my-env:

aws elasticbeanstalk describe-configuration-options --environment-name my-env --application-name my-app

Вывод (сокращенный):

{
    "Options": [
        {
            "Name": "JVMOptions",
            "UserDefined": false,
            "DefaultValue": "Xms=256m,Xmx=256m,XX:MaxPermSize=64m,JVM Options=",
            "ChangeSeverity": "RestartApplicationServer",
            "Namespace": "aws:cloudformation:template:parameter",
            "ValueType": "KeyValueList"
        },
        {
            "Name": "Interval",
            "UserDefined": false,
            "DefaultValue": "30",
            "ChangeSeverity": "NoInterruption",
            "Namespace": "aws:elb:healthcheck",
            "MaxValue": 300,
            "MinValue": 5,
            "ValueType": "Scalar"
        },
        ...
        {
            "Name": "LowerThreshold",
            "UserDefined": false,
            "DefaultValue": "2000000",
            "ChangeSeverity": "NoInterruption",
            "Namespace": "aws:autoscaling:trigger",
            "MinValue": 0,
            "ValueType": "Scalar"
        },
        {
            "Name": "ListenerEnabled",
            "UserDefined": false,
            "DefaultValue": "true",
            "ChangeSeverity": "Unknown",
            "Namespace": "aws:elb:listener",
            "ValueType": "Boolean"
        }
    ]
}

Доступные параметры конфигурации различаются в зависимости от платформы и версии конфигурации. Подробнее о пространствах имен и поддерживаемых параметрах см. Значения параметров в Руководстве разработчика AWS Elastic Beanstalk.

Вывод

SolutionStackName -> (строка)

Имя стека решений, к которому относятся эти параметры конфигурации.

PlatformArn -> (строка)

ARN версии платформы.

Options -> (список)

Список ConfigurationOptionDescription.

(структура)

Описание возможных значений для параметра конфигурации.

Namespace -> (строка)

Уникальное имя пространства имён, идентифицирующее связанный с параметром AWS-ресурс.

Name -> (строка)

Имя параметра конфигурации.

DefaultValue -> (строка)

Значение по умолчанию для этого параметра конфигурации.

ChangeSeverity -> (строка)

Указание действия, необходимого, если значение этого параметра конфигурации изменяется:

  • NoInterruption : Нет прерывания доступности среды или приложения.
  • RestartEnvironment : Среда полностью перезапускается, все AWS-ресурсы удаляются и создаются заново, и среда недоступна во время процесса.
  • RestartApplicationServer : Среда доступна всё время. Однако происходит кратковременный сбой приложения, когда серверы приложения на запущенных экземплярах Amazon EC2 перезапускаются.

UserDefined -> (булево)

Указание, определил ли пользователь этот параметр конфигурации:

  • true : Этот параметр конфигурации был определен пользователем. Это допустимый выбор для указания, если это Option to Remove при обновлении настроек конфигурации.
  • false : Эта конфигурация не была определена пользователем.

Ограничение: Вы можете удалить только параметры UserDefined из конфигурации.

Допустимые значения: true | false

ValueType -> (строка)

Указание типа значений, которыми обладает этот параметр, и разрешено ли выбирать одно или несколько значений из возможных:

  • Scalar : Значения для этого параметра — это один выбор из возможных значений, или неформатированная строка, или числовое значение, регулируемое ограничениями MIN/MAX/Regex.
  • List : Значения для этого параметра — это несколько выборов из возможных значений.
  • Boolean : Значения для этого параметра — это либо true, либо false.
  • Json : Значения для этого параметра — это JSON-представление ConfigDocument.

ValueOptions -> (список)

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

(строка)

MinValue -> (целое число)

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

MaxValue -> (целое число)

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

MaxLength -> (целое число)

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

Regex -> (структура)

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

Pattern -> (строка)

Шаблон регулярного выражения, которому должна соответствовать строка-значение параметра конфигурации с этим ограничением.

Label -> (строка)

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

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

Spec-Zone.ru

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