Spec-Zone.ru › AWS CLI v2

[ aws . rds ]

modify-db-parameter-group

Описание

Изменяет параметры группы параметров DB. Для изменения более одного параметра отправьте список следующего: ParameterName , ParameterValue , и ApplyMethod . В одном запросе можно изменить не более 20 параметров.

Предупреждение

После изменения группы параметров DB следует подождать не менее 5 минут перед созданием первого экземпляра DB, использующего эту группу параметров DB в качестве параметра по умолчанию. Это позволяет Amazon RDS полностью завершить операцию изменения перед использованием группы параметров в качестве параметра по умолчанию для нового экземпляра DB. Это особенно важно для параметров, которые имеют критическое значение при создании базы данных по умолчанию для экземпляра DB, например, кодировки символов для базы данных по умолчанию, определенной параметром character_set_database. Вы можете использовать опцию «Группы параметров» в консоли Amazon RDS или команду «DescribeDBParameters», чтобы проверить, была ли создана или изменена ваша группа параметров DB.

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

Синтаксис

  modify-db-parameter-group
--db-parameter-group-name <value>
--parameters <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]

Параметры

--db-parameter-group-name (строка)

Имя группы параметров DB.

Ограничения:

  • При указании должно соответствовать имени существующей DBParameterGroup .

--parameters (список)

Массив имён параметров, значений и методов применения для обновления параметра. Должно быть указано как минимум одно имя параметра, значение и метод применения; последующие аргументы необязательны. В одном запросе можно изменить не более 20 параметров.

Допустимые значения (для метода применения): immediate | pending-reboot

Вы можете использовать значение immediate только с динамическими параметрами. Вы можете использовать значение pending-reboot для динамических и статических параметров.

Когда метод применения — immediate, изменения динамических параметров применяются немедленно к экземплярам DB, связанным с группой параметров.

Когда метод применения — pending-reboot, изменения динамических и статических параметров применяются после перезагрузки экземпляров DB, связанных с группой параметров, без переключения на резервный экземпляр.

Примечание

Вы не можете использовать pending-reboot с динамическими параметрами в RDS для экземпляров DB SQL Server. Используйте immediate.

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

(структура)

Этот тип данных используется в качестве параметра запроса в действиях ModifyDBParameterGroup и ResetDBParameterGroup.

Этот тип данных используется в качестве элемента ответа в действиях DescribeEngineDefaultParameters и DescribeDBParameters.

ParameterName -> (строка)

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

ParameterValue -> (строка)

Значение параметра.

Description -> (строка)

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

Source -> (строка)

Источник значения параметра.

ApplyType -> (строка)

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

DataType -> (строка)

Указывает допустимый тип данных для параметра.

AllowedValues -> (строка)

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

IsModifiable -> (булево)

Указывает, можно (true) или нельзя (false) изменить параметр. Некоторые параметры имеют последствия для безопасности или работы, которые препятствуют их изменению.

MinimumEngineVersion -> (строка)

Самая ранняя версия движка, к которой может применяться параметр.

ApplyMethod -> (строка)

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

SupportedEngineModes -> (список)

Допустимые режимы работы DB-движка.

(строка)

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

ParameterName=string,ParameterValue=string,Description=string,Source=string,ApplyType=string,DataType=string,AllowedValues=string,IsModifiable=boolean,MinimumEngineVersion=string,ApplyMethod=string,SupportedEngineModes=string,string ...

Синтаксис JSON:

[
  {
    "ParameterName": "string",
    "ParameterValue": "string",
    "Description": "string",
    "Source": "string",
    "ApplyType": "string",
    "DataType": "string",
    "AllowedValues": "string",
    "IsModifiable": true|false,
    "MinimumEngineVersion": "string",
    "ApplyMethod": "immediate"|"pending-reboot",
    "SupportedEngineModes": ["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 (строка)

Переопределить URL по умолчанию команды заданным 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 в руководстве пользователя AWS CLI.

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

Изменение группы параметров DB

Следующий modify-db-parameter-group пример изменяет значение параметра clr enabled в группе параметров DB. Параметр --apply-immediately заставляет группу параметров DB быть измененной немедленно, а не ждать следующего окна обслуживания.

aws rds modify-db-parameter-group \
    --db-parameter-group-name test-sqlserver-se-2017 \
    --parameters "ParameterName='clr enabled',ParameterValue=1,ApplyMethod=immediate"

Вывод:

{
    "DBParameterGroupName": "test-sqlserver-se-2017"
}

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

Вывод

DBParameterGroupName -> (строка)

Имя группы параметров DB.

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

Spec-Zone.ru

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