modify-db-cluster-parameter-group
Описание
Изменяет параметры группы параметров кластера баз данных. Для изменения более одного параметра отправьте список следующих: ParameterName , ParameterValue , и ApplyMethod . Максимальное количество параметров, которые можно изменить в одном запросе, равно 20.
Предупреждение
После создания группы параметров кластера баз данных необходимо подождать не менее 5 минут, прежде чем создавать первый кластер баз данных, использующий эту группу параметров кластера баз данных в качестве группы параметров по умолчанию. Это позволяет Amazon RDS полностью завершить операцию создания перед использованием группы параметров по умолчанию для нового кластера баз данных. Это особенно важно для параметров, которые критически важны при создании базы данных по умолчанию для кластера баз данных, таких как кодировка символов для базы данных по умолчанию, определённой параметром character_set_database. Вы можете использовать опцию «Группы параметров» в консоли Amazon RDS или операцию DescribeDBClusterParameters для проверки того, что ваша группа параметров кластера баз данных была создана или изменена.
Если изменённая группа параметров кластера баз данных используется кластером Aurora Serverless v1, Aurora применяет обновление немедленно. Перезагрузка кластера может прервать вашу рабочую нагрузку. В этом случае ваше приложение должно повторно открыть все подключения и повторить любые транзакции, которые были активны, когда вступили в силу изменения параметров.
Дополнительную информацию о кластерах баз данных Amazon Aurora см. в разделе Что такое Amazon Aurora? в руководстве пользователя Amazon Aurora.
Дополнительную информацию о кластерах баз данных Multi-AZ см. в разделе Развёртывания кластеров баз данных Multi-AZ в руководстве пользователя Amazon RDS.
См. также: Документацию API AWS
Синтаксис
modify-db-cluster-parameter-group
--db-cluster-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-cluster-parameter-group-name (строка)
--parameters (список)
Список параметров в группе параметров кластера баз данных, которые нужно изменить.
Допустимые значения (для метода применения): immediate | pending-reboot
Примечание
Вы можете использовать значение immediate только с динамическими параметрами. Вы можете использовать значение pending-reboot для динамических и статических параметров.
Когда метод применения — immediate, изменения динамических параметров применяются немедленно к кластерам баз данных, связанным с группой параметров. Когда метод применения — pending-reboot, изменения динамических и статических параметров применяются после перезагрузки без переключения на резервный кластер к кластерам баз данных, связанным с группой параметров.
(структура)
Этот тип данных используется в качестве параметра запроса в действиях ModifyDBParameterGroup и ResetDBParameterGroup.
Этот тип данных используется в качестве элемента ответа в действиях DescribeEngineDefaultParameters и DescribeDBParameters.
ParameterName -> (строка)
ParameterValue -> (строка)
Description -> (строка)
Source -> (строка)
ApplyType -> (строка)
DataType -> (строка)
AllowedValues -> (строка)
IsModifiable -> (булево)
true ) или нельзя (false ) изменить параметр. Некоторые параметры имеют последствия для безопасности или работы, которые предотвращают их изменение.MinimumEngineVersion -> (строка)
ApplyMethod -> (строка)
SupportedEngineModes -> (список)
Допустимые режимы работы базы данных.
(строка)
Сокращённый синтаксис:
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
- 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 версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку 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.
Изменение параметров в группе параметров кластера баз данных
Следующий modify-db-cluster-parameter-group пример изменяет значения параметров в группе параметров кластера баз данных.
aws rds modify-db-cluster-parameter-group \
--db-cluster-parameter-group-name mydbclusterpg \
--parameters "ParameterName=server_audit_logging,ParameterValue=1,ApplyMethod=immediate" \
"ParameterName=server_audit_logs_upload,ParameterValue=1,ApplyMethod=immediate"
Вывод:
{
"DBClusterParameterGroupName": "mydbclusterpg"
}
Дополнительную информацию см. в разделе Работа с группами параметров баз данных и группами параметров кластеров баз данных в руководстве пользователя Amazon Aurora.
Вывод
DBClusterParameterGroupName -> (строка)
Имя группы параметров кластера баз данных.
Ограничения:
- Длина от 1 до 255 символов букв или цифр.
- Первый символ должен быть буквой.
- Не может заканчиваться дефисом или содержать два дефиса подряд.
Примечание
Это значение хранится как строка в нижнем регистре.
© Copyright 2025, Amazon Web Services. Created using Sphinx.