переключение-глобального-кластера
Описание
Инициирует процесс переключения для базы данных Neptune глобального уровня.
Переключение для базы данных Neptune глобального уровня повышает один из вторичных чтений-только кластеров баз данных до основного кластера базы данных и понижает основной кластер базы данных до вторичного (только для чтения) кластера базы данных. Другими словами, роли текущего основного кластера базы данных и выбранного целевого вторичного кластера базы данных меняются. Выбранный вторичный кластер базы данных получает полный доступ для чтения/записи для базы данных Neptune глобального уровня.
Примечание
Данное действие применяется только к базам данных Neptune глобального уровня. Данное действие предназначено только для использования на здоровых базах данных Neptune глобального уровня со здоровыми кластерами баз данных Neptune и без региональных сбоев, для тестирования сценариев аварийного восстановления или для переконфигурации топологии глобальной базы данных.См. также: Документацию API AWS
Синтаксис
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 (строка)
Идентификатор базы данных Neptune глобального уровня, который должен быть переключен. Идентификатор — это уникальный ключ, присвоенный пользователем при создании базы данных Neptune глобального уровня. Другими словами, это имя глобальной базы данных, которую вы хотите переключить.
Ограничения: Должен совпадать с идентификатором существующей базы данных Neptune глобального уровня.
--target-db-cluster-identifier (строка)
--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 Neptune базе данных глобального уровня.
Этот тип данных используется в качестве элемента ответа для действий CreateGlobalCluster , DescribeGlobalClusters , ModifyGlobalCluster , DeleteGlobalCluster , FailoverGlobalCluster и RemoveFromGlobalCluster.
GlobalClusterIdentifier -> (строка)
GlobalClusterResourceId -> (строка)
GlobalClusterArn -> (строка)
Status -> (строка)
Engine -> (строка)
"neptune").EngineVersion -> (строка)
StorageEncrypted -> (логическое значение)
DeletionProtection -> (логическое значение)
GlobalClusterMembers -> (список)
Список ARN кластеров и ARN экземпляров для всех кластеров баз данных, которые являются частью глобальной базы данных.
(структура)
Структура данных со сведениями о всех основных и вторичных кластерах, связанных с базой данных Neptune глобального уровня.
DBClusterArn -> (строка)
Readers -> (список)
Amazon Resource Name (ARN) для каждого вторичного кластера только для чтения, связанного с базой данных Neptune глобального уровня.
(строка)
IsWriter -> (логическое значение)
FailoverState -> (структура)
Объект данных, содержащий все свойства текущего состояния процесса переключения или переключения в процессе для этого глобального кластера (базы данных Neptune глобального уровня). Этот объект пуст, если не было вызвано действие SwitchoverGlobalCluster или FailoverGlobalCluster для этого глобального кластера.
Status -> (строка)
Текущее состояние глобального кластера. Возможные значения следующие:
- pending – Сервис получил запрос на переключение или переключение глобального кластера. Основной кластер базы данных глобального кластера и указанный вторичный кластер базы данных проверяются перед началом операции.
- failing-over – Neptune повышает выбранный вторичный кластер базы данных Neptune до нового основного кластера базы данных для переключения глобального кластера.
- cancelling – Запрос на переключение или переключение глобального кластера был отменен, и основной кластер базы данных Neptune и выбранный вторичный кластер базы данных Neptune возвращаются к своему предыдущему состоянию.
- switching-over – Это состояние охватывает ряд внутренних операций Neptune, которые происходят во время процесса переключения, например, понижение основного кластера базы данных Neptune, повышение вторичного кластера базы данных Neptune и синхронизация реплик.
FromDbClusterArn -> (строка)
ToDbClusterArn -> (строка)
IsDataLossAllowed -> (логическое значение)
© Copyright 2025, Amazon Web Services. Created using Sphinx.