Переключение глобального кластера
Описание
Переключает указанный вторичный базовый кластер БД на новый первичный базовый кластер в глобальном кластере баз данных. Операции переключения ранее назывались «управляемыми запланированными переключениями».
Aurora повышает указанный вторичный кластер, предоставляя ему полные возможности чтения/записи, и понижает текущий первичный кластер до вторичного (только чтение), сохраняя исходную топологию репликации. Все вторичные кластеры синхронизируются с первичным в начале процесса, поэтому новый первичный кластер продолжает работу с глобальной базой данных Aurora без потери данных. Ваша база данных будет недоступна в течение короткого времени, пока первичный и выбранный вторичный кластеры не примут свои новые роли. Более подробную информацию о переключении глобальной базы данных Aurora можно найти в разделе «Выполнение переключений для глобальных баз данных Amazon Aurora» в руководстве пользователя Amazon Aurora.
Примечание
Данная операция предназначена для контролируемых сред, таких как «региональная ротация» или для возврата к исходному первичному кластеру после сбоя глобальной базы данных.См. также: Документацию API AWS
Синтаксис
switchover-global-cluster
--global-cluster-identifier <value>
--target-db-cluster-identifier <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]
Параметры
--global-cluster-identifier (строка)
Идентификатор глобального кластера баз данных, который необходимо переключить. Этот параметр не чувствителен к регистру.
Ограничения:
- Должен соответствовать идентификатору существующего глобального кластера баз данных (глобальной базы данных Aurora).
--target-db-cluster-identifier (строка)
--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 для вывода.
--cli-auto-prompt (логическое значение)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запрошение параметров ввода CLI.
Выходные данные
GlobalCluster -> (структура)
Тип данных, представляющий глобальную базу данных Aurora.
GlobalClusterIdentifier -> (строка)
GlobalClusterResourceId -> (строка)
GlobalClusterArn -> (строка)
Status -> (строка)
Engine -> (строка)
EngineVersion -> (строка)
EngineLifecycleSupport -> (строка)
Тип жизненного цикла для глобального кластера.
Дополнительную информацию см. в CreateGlobalCluster.
DatabaseName -> (строка)
StorageEncrypted -> (булево)
DeletionProtection -> (булево)
GlobalClusterMembers -> (список)
Список первичных и вторичных кластеров в рамках глобального кластера базы данных.
(структура)
Структура данных с информацией о любых первичных и вторичных кластерах, связанных с глобальным кластером (глобальной базой данных Aurora).
DBClusterArn -> (строка)
Readers -> (список)
Идентификатор ресурса Amazon (ARN) для каждого вторичного кластера чтения, связанного с глобальным кластером.
(строка)
IsWriter -> (булево)
GlobalWriteForwardingStatus -> (строка)
SynchronizationStatus -> (строка)
Endpoint -> (строка)
FailoverState -> (структура)
Объект данных, содержащий все свойства текущего состояния процесса переключения или аварийного переключения для этого глобального кластера (глобальной базы данных Aurora). Этот объект пуст, если не был вызван оператор SwitchoverGlobalCluster или FailoverGlobalCluster для этого глобального кластера.
Status -> (строка)
Текущее состояние глобального кластера. Возможные значения:
- pending – Сервис получил запрос на переключение или аварийное переключение глобального кластера. Первичный кластер БД глобального кластера и указанный вторичный кластер БД проверяются перед запуском операции.
- failing-over – Aurora продвигает выбранный вторичный кластер БД Aurora до первичного, чтобы выполнить аварийное переключение глобального кластера.
- cancelling – Запрос на переключение или аварийное переключение глобального кластера был отменен, и первичный кластер БД Aurora и выбранный вторичный кластер БД возвращаются в предыдущие состояния.
- switching-over – Это состояние охватывает ряд внутренних операций Aurora, выполняемых во время процесса переключения, таких как понижение первичного кластера БД Aurora, продвижение вторичного кластера БД Aurora и синхронизация реплик.
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: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).Value -> (строка)
aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «:», «/», «=», «+», «-», «@» (регулярное выражение Java: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).
© Copyright 2025, Amazon Web Services. Created using Sphinx.