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 (строка)
--filters (список)
Этот параметр в настоящее время не поддерживается.
(структура)
Пара имя-значение фильтра, используемая для возврата более конкретного списка результатов из операции describe. Фильтры могут быть использованы для сопоставления набора ресурсов по определенным критериям, таким как идентификаторы. Поддерживаемые фильтры операции describe документированы вместе с операцией describe.
Примечание
В настоящее время в фильтрах не поддерживаются подстановочные знаки.Фильтровать можно следующие действия:
DescribeDBClusterBacktracksDescribeDBClusterEndpointsDescribeDBClustersDescribeDBInstancesDescribeDBRecommendationsDescribeDBShardGroupsDescribePendingMaintenanceActions
Имя -> (строка)
Значения -> (список)
Одно или несколько значений фильтра. Значения фильтров чувствительны к регистру.
(строка)
Упрощённый синтаксис:
Name=string,Values=string,string ...
Синтаксис JSON:
[
{
"Name": "string",
"Values": ["string", ...]
}
...
]
--engine-name (строка)
Фильтр для включения только групп параметров, связанных с этим движком базы данных.
Допустимые значения:
db2-aedb2-semariadbmysqloracle-eeoracle-ee-cdboracle-se2oracle-se2-cdbpostgressqlserver-eesqlserver-sesqlserver-exsqlserver-web
--major-engine-version (строка)
--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 -> (список)
Если для параметра требуется доступ к порту, то эта группа безопасности БД разрешает доступ к порту.
(структура)
Этот тип данных используется в качестве элемента ответа в следующих действиях:
ModifyDBInstanceRebootDBInstanceRestoreDBInstanceFromDBSnapshotRestoreDBInstanceToPointInTime
DBSecurityGroupName -> (строка)
Status -> (строка)
VpcSecurityGroupMemberships -> (список)
Если для параметра требуется доступ к порту, то эта группа безопасности VPC разрешает доступ к порту.
(структура)
Этот тип данных используется в качестве элемента ответа для запросов о членстве в группе безопасности VPC.
VpcSecurityGroupId -> (строка)
Status -> (строка)
Статус членства в группе безопасности VPC.
В настоящее время единственный допустимый статус — active.
AllowsVpcAndNonVpcInstanceMemberships -> (булево)
true указывает, что группа параметров может применяться как к экземплярам VPC, так и к экземплярам вне VPC.VpcId -> (строка)
false, это поле пустое. Если AllowsVpcAndNonVpcInstanceMemberships равно true, а это поле пустое, то эта группа параметров может применяться как к экземплярам VPC, так и к экземплярам вне VPC. Если это поле содержит значение, то эта группа параметров может применяться только к экземплярам, которые находятся в VPC, указанном в этом поле.OptionGroupArn -> (строка)
SourceOptionGroup -> (строка)
SourceAccountId -> (строка)
CopyTimestamp -> (метка времени)
Marker -> (строка)
MaxRecords.
© Copyright 2025, Amazon Web Services. Created using Sphinx.