Spec-Zone.ru › AWS CLI v2

[ aws . rds ]

describe-option-groups

Описание

Описывает доступные группы параметров.

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

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

Синтаксис

  describe-option-groups
[--option-group-name <value>]
[--filters <value>]
[--engine-name <value>]
[--major-engine-version <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]

Параметры

--option-group-name (строка)

Имя группы параметров для описания. Не может быть использовано вместе с EngineName или MajorEngineVersion.

--filters (список)

Этот параметр в настоящее время не поддерживается.

(структура)

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

Примечание

В настоящее время в фильтрах не поддерживаются подстановочные знаки.

Фильтровать можно следующие действия:

  • DescribeDBClusterBacktracks
  • DescribeDBClusterEndpoints
  • DescribeDBClusters
  • DescribeDBInstances
  • DescribeDBRecommendations
  • DescribeDBShardGroups
  • DescribePendingMaintenanceActions

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

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

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

Одно или несколько значений фильтра. Значения фильтров чувствительны к регистру.

(строка)

Упрощённый синтаксис:

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

Синтаксис JSON:

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

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

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

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

  • db2-ae
  • db2-se
  • mariadb
  • mysql
  • oracle-ee
  • oracle-ee-cdb
  • oracle-se2
  • oracle-se2-cdb
  • postgres
  • sqlserver-ee
  • sqlserver-se
  • sqlserver-ex
  • sqlserver-web

--major-engine-version (строка)

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

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

Примеры

Примечание

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

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

Для описания доступных групп параметров

Следующий пример describe-option-groups отображает группы параметров для экземпляра базы данных Oracle 19c.

aws rds describe-option-groups \
    --engine-name oracle-ee \
    --major-engine-version 19

Вывод:

{
    "OptionGroupsList": [
        {
            "OptionGroupName": "default:oracle-ee-19",
            "OptionGroupDescription": "Default option group for oracle-ee 19",
            "EngineName": "oracle-ee",
            "MajorEngineVersion": "19",
            "Options": [],
            "AllowsVpcAndNonVpcInstanceMemberships": true,
            "OptionGroupArn": "arn:aws:rds:us-west-1:111122223333:og:default:oracle-ee-19"
        }
    ]
}

Дополнительную информацию см. в разделе Перечисление параметров и параметров настроек для группы параметров в Руководстве пользователя Amazon RDS.

Вывод

OptionGroupsList -> (список)

Список групп параметров.

(структура)

OptionGroupName -> (строка)

Указывает имя группы параметров.

OptionGroupDescription -> (строка)

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

EngineName -> (строка)

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

MajorEngineVersion -> (строка)

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

Options -> (список)

Указывает доступные параметры в группе параметров.

(структура)

Подробности параметра.

OptionName -> (строка)

Имя параметра.

OptionDescription -> (строка)

Описание параметра.

Persistent -> (булево)

Указывает, является ли этот параметр постоянным.

Permanent -> (булево)

Указывает, является ли этот параметр постоянным.

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

Если необходимо, порт, настроенный для использования этим параметром.

OptionVersion -> (строка)

Версия параметра.

OptionSettings -> (список)

Настройки параметра.

(структура)

Настройки параметра — это фактические настройки, применяемые или настраиваемые для данного параметра. Используется при модификации или описании групп параметров. Например, параметр NATIVE_NETWORK_ENCRYPTION имеет настройку SQLNET.ENCRYPTION_SERVER, которая может иметь несколько различных значений.

Name -> (строка)

Имя параметра, для которого можно установить настройки.

Value -> (строка)

Текущее значение настройки параметра.

DefaultValue -> (строка)

Значение по умолчанию настройки параметра.

Description -> (строка)

Описание настройки параметра.

ApplyType -> (строка)

Тип параметра, специфичный для движка БД.

DataType -> (строка)

Тип данных настройки параметра.

AllowedValues -> (строка)

Допустимые значения настройки параметра.

IsModifiable -> (булево)

Указывает, можно ли изменить настройку параметра от значения по умолчанию.

IsCollection -> (булево)

Указывает, является ли параметр частью коллекции.

DBSecurityGroupMemberships -> (список)

Если для параметра требуется доступ к порту, то эта группа безопасности БД разрешает доступ к порту.

(структура)

Этот тип данных используется в качестве элемента ответа в следующих действиях:

  • ModifyDBInstance
  • RebootDBInstance
  • RestoreDBInstanceFromDBSnapshot
  • RestoreDBInstanceToPointInTime

DBSecurityGroupName -> (строка)

Имя группы безопасности БД.

Status -> (строка)

Статус группы безопасности БД.

VpcSecurityGroupMemberships -> (список)

Если для параметра требуется доступ к порту, то эта группа безопасности VPC разрешает доступ к порту.

(структура)

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

VpcSecurityGroupId -> (строка)

Имя группы безопасности VPC.

Status -> (строка)

Статус членства в группе безопасности VPC.

В настоящее время единственный допустимый статус — active.

AllowsVpcAndNonVpcInstanceMemberships -> (булево)

Указывает, может ли эта группа параметров применяться как к экземплярам VPC, так и к экземплярам вне VPC. Значение true указывает, что группа параметров может применяться как к экземплярам VPC, так и к экземплярам вне VPC.

VpcId -> (строка)

Если AllowsVpcAndNonVpcInstanceMemberships равно false, это поле пустое. Если AllowsVpcAndNonVpcInstanceMemberships равно true, а это поле пустое, то эта группа параметров может применяться как к экземплярам VPC, так и к экземплярам вне VPC. Если это поле содержит значение, то эта группа параметров может применяться только к экземплярам, которые находятся в VPC, указанном в этом поле.

OptionGroupArn -> (строка)

Указывает Amazon Resource Name (ARN) группы параметров.

SourceOptionGroup -> (строка)

Указывает имя группы параметров, из которой скопирована эта группа параметров.

SourceAccountId -> (строка)

Указывает идентификатор учетной записи Amazon Web Services для группы параметров, из которой скопирована эта группа параметров.

CopyTimestamp -> (метка времени)

Указывает время копирования группы параметров.

Marker -> (строка)

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

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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