переключение-глобального-кластера
Описание
Переключает указанный вторичный кластер баз данных на роль первичного кластера в глобальном кластере при выполнении переключения глобального кластера.
Используйте эту операцию для реагирования на непредвиденное событие, например, региональную катастрофу в первичном регионе. Переключение может привести к потере данных транзакций записи, которые не были реплицированы во вторичном кластере до момента переключения. Однако процесс восстановления, который переводит экземпляр базы данных во вторичном кластере на роль первичного экземпляра записи, гарантирует, что данные находятся в транзакционно согласованном состоянии.
См. также: Документация AWS API
Синтаксис
failover-global-cluster
--global-cluster-identifier <value>
--target-db-cluster-identifier <value>
[--allow-data-loss | --no-allow-data-loss]
[--switchover | --no-switchover]
[--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 (строка)
Идентификатор глобального кластера Amazon DocumentDB, к которому будет применена данная операция. Идентификатор — это уникальный ключ, назначенный пользователем при создании кластера. Другими словами, это имя глобального кластера.
Ограничения:
- Должен совпадать с идентификатором существующего глобального кластера.
- Минимальная длина — 1. Максимальная длина — 255.
Шаблон: [A-Za-z][0-9A-Za-z-:._]*
--target-db-cluster-identifier (строка)
Идентификатор вторичного кластера Amazon DocumentDB, который вы хотите переключить на первичный для глобального кластера. Используйте Amazon Resource Name (ARN) в качестве идентификатора, чтобы Amazon DocumentDB мог найти кластер в своём регионе Amazon Web Services.
Ограничения:
- Должен совпадать с идентификатором существующего вторичного кластера.
- Минимальная длина — 1. Максимальная длина — 255.
Шаблон: [A-Za-z][0-9A-Za-z-:._]*
--allow-data-loss | --no-allow-data-loss (логическое значение)
Указывает, разрешено ли потеря данных для данной операции с глобальным кластером. Разрешение потери данных запускает операцию глобального переключения.
Если вы не укажете AllowDataLoss, операция с глобальным кластером по умолчанию будет переключением.
Ограничения:
- Не может быть указано вместе с параметром
Switchover.
--switchover | --no-switchover (логическое значение)
Указывает, необходимо ли выполнить переключение этого глобального кластера баз данных.
Ограничения:
- Не может быть указано вместе с параметром
AllowDataLoss.
--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.
Вывод
GlobalCluster -> (структура)
Тип данных, представляющий глобальный кластер Amazon DocumentDB.
GlobalClusterIdentifier -> (строка)
GlobalClusterResourceId -> (строка)
GlobalClusterArn -> (строка)
Статус -> (строка)
Двигатель -> (строка)
Версия двигателя -> (строка)
Имя базы данных -> (строка)
Зашифрованное хранилище -> (логическое значение)
Защита от удаления -> (логическое значение)
GlobalClusterMembers -> (список)
Список идентификаторов кластеров для вторичных кластеров в глобальном кластере. В настоящее время ограничено одним элементом.
(структура)
Структура данных с информацией о любом первичном и вторичном кластерах, связанных с глобальными кластерами Amazon DocumentDB.
DBClusterArn -> (строка)
Readers -> (список)
Amazon Resource Name (ARN) для каждого вторичного кластера только для чтения, связанного с глобальным кластером Aurora.
(строка)
IsWriter -> (логическое значение)
© Copyright 2025, Amazon Web Services. Created using Sphinx.