modify-global-cluster
Описание
Изменяет настройки кластера глобальной базы данных Amazon Aurora. Вы можете изменить один или несколько параметров конфигурации базы данных, указав эти параметры и новые значения в запросе. Дополнительную информацию об Amazon Aurora см. в разделе «Что такое Amazon Aurora?» в Руководстве пользователя Amazon Aurora.
Примечание
Данная операция применяется только к кластерам глобальных баз данных Aurora.См. также: Документация API AWS
Синтаксис
modify-global-cluster
[--global-cluster-identifier <value>]
[--new-global-cluster-identifier <value>]
[--deletion-protection | --no-deletion-protection]
[--engine-version <value>]
[--allow-major-version-upgrade | --no-allow-major-version-upgrade]
[--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]
Параметры
--global-cluster-identifier (строка)
Идентификатор кластера глобального кластера для изменения. Этот параметр не чувствителен к регистру.
Ограничения:
- Должен совпадать с идентификатором существующего глобального кластера базы данных.
--new-global-cluster-identifier (строка)
Новый идентификатор кластера глобальной базы данных. Это значение хранится как строка в нижнем регистре.
Ограничения:
- Должен содержать от 1 до 63 букв, цифр или дефисов.
- Первый символ должен быть буквой.
- Не может заканчиваться дефисом или содержать два последовательных дефиса.
Пример: my-cluster2
--deletion-protection | --no-deletion-protection (логическое значение)
--engine-version (строка)
Номер версии движка базы данных, до которой вы хотите выполнить обновление.
Чтобы перечислить все доступные версии движка для aurora-mysql (для глобальных баз данных Aurora на базе MySQL), используйте следующую команду:
aws rds describe-db-engine-versions --engine aurora-mysql --query '*[]|[?SupportsGlobalDatabases == `true`].[EngineVersion]'Чтобы перечислить все доступные версии движка для aurora-postgresql (для глобальных баз данных Aurora на базе PostgreSQL), используйте следующую команду:
aws rds describe-db-engine-versions --engine aurora-postgresql --query '*[]|[?SupportsGlobalDatabases == `true`].[EngineVersion]'--allow-major-version-upgrade | --no-allow-major-version-upgrade (логическое значение)
Указывает, разрешены ли обновления основных версий.
Ограничения: Должно быть включено, если вы указали значение для параметра EngineVersion, которое является другой основной версией, чем текущая версия глобального кластера.
Если вы обновите главную версию глобальной базы данных, группы параметров кластера и экземпляра базы данных устанавливаются на группы параметров по умолчанию для новой версии. Примените любые пользовательские группы параметров после завершения обновления.
--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 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.
Изменение глобального кластера БД
Следующий modify-global-cluster пример включает защиту от удаления для глобального кластера БД Aurora, совместимого с MySQL.
aws rds modify-global-cluster \
--global-cluster-identifier myglobalcluster \
--deletion-protection
Вывод:
{
"GlobalCluster": {
"GlobalClusterIdentifier": "myglobalcluster",
"GlobalClusterResourceId": "cluster-f0e523bfe07aabb",
"GlobalClusterArn": "arn:aws:rds::123456789012:global-cluster:myglobalcluster",
"Status": "available",
"Engine": "aurora-mysql",
"EngineVersion": "5.7.mysql_aurora.2.07.2",
"StorageEncrypted": false,
"DeletionProtection": true,
"GlobalClusterMembers": []
}
}
Дополнительную информацию см. в разделе Управление глобальной базой данных Aurora в Руководстве пользователя Amazon Aurora.
Вывод
GlobalCluster -> (структура)
Тип данных, представляющий глобальную базу данных Aurora.
GlobalClusterIdentifier -> (строка)
GlobalClusterResourceId -> (строка)
GlobalClusterArn -> (строка)
Status -> (строка)
Engine -> (строка)
EngineVersion -> (строка)
EngineLifecycleSupport -> (строка)
Тип жизненного цикла для глобального кластера.
Для получения дополнительной информации см. CreateGlobalCluster.
DatabaseName -> (строка)
StorageEncrypted -> (булево)
DeletionProtection -> (булево)
GlobalClusterMembers -> (список)
Список первичных и вторичных кластеров в глобальном кластере базы данных.
(структура)
Структура данных с информацией о любых первичных и вторичных кластерах, связанных с глобальным кластером (глобальная база данных Aurora).
DBClusterArn -> (строка)
Readers -> (список)
Amazon Resource Name (ARN) для каждого вторичного кластера только для чтения, связанного с глобальным кластером.
(строка)
IsWriter -> (булево)
GlobalWriteForwardingStatus -> (строка)
SynchronizationStatus -> (строка)
Endpoint -> (строка)
FailoverState -> (структура)
Объект данных, содержащий все свойства текущего состояния процесса переключения или перехода на резервный вариант для этого глобального кластера (глобальная база данных Aurora). Этот объект пуст, если для этого глобального кластера не вызывался метод SwitchoverGlobalCluster или FailoverGlobalCluster.
Status -> (строка)
Текущее состояние глобального кластера. Возможные значения:
- pending – Услуга получила запрос на переключение или переход на резервный вариант глобального кластера. Первичный кластер базы данных глобального кластера и указанный вторичный кластер базы данных проверяются перед началом операции.
- failing-over – Aurora повышает выбранный вторичный кластер Aurora DB до первичного кластера для перехода на резервный вариант глобального кластера.
- cancelling – Запрос на переключение или переход на резервный вариант глобального кластера был отменен, и первичный кластер Aurora DB и выбранный вторичный кластер Aurora DB возвращаются в предыдущие состояния.
- switching-over – Это состояние охватывает ряд внутренних операций Aurora, которые происходят во время процесса переключения, например, понижение первичного кластера Aurora DB, повышение вторичного кластера Aurora DB и синхронизация реплик.
FromDbClusterArn -> (строка)
ToDbClusterArn -> (строка)
IsDataLossAllowed -> (булево)
TagList -> (список)
Список тегов.
Для получения дополнительной информации см. Разметка ресурсов Amazon RDS в руководстве пользователя Amazon RDS или Разметка ресурсов Amazon Aurora и Amazon RDS в руководстве пользователя Amazon Aurora.
(структура)
Метаданные, назначенные ресурсу Amazon RDS, представляющие собой пару ключ-значение.
Для получения дополнительной информации см. Разметка ресурсов Amazon RDS в руководстве пользователя Amazon RDS или Разметка ресурсов Amazon Aurora и Amazon RDS в руководстве пользователя Amazon Aurora.
Key -> (строка)
aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «:», «/», «=», «+», «-», «@» (Java regex: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).Value -> (строка)
aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «:», «/», «=», «+», «-», «@» (Java regex: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).
© Copyright 2025, Amazon Web Services. Created using Sphinx.