Spec-Zone.ru › AWS CLI v2

[ aws . rds ]

переключение-глобального-кластера

Описание

Возвышает указанный вторичный кластер баз данных до роли первичного кластера баз данных в глобальном кластере баз данных для переключения или аварийного переключения глобальной базы данных. Операции переключения ранее назывались «управляемыми запланированными аварийными переключениями».

Примечание

Хотя данная операция может быть использована как для аварийного переключения, так и для переключения глобального кластера баз данных, ее предполагаемое применение — для аварийного переключения глобальной базы данных. Для переключения глобального кластера баз данных рекомендуется использовать операцию SwitchoverGlobalCluster.

Способ использования этой операции зависит от того, производите ли вы аварийное переключение или переключение вашего глобального кластера баз данных:

  • Аварийное переключение — Укажите параметр AllowDataLoss и не указывайте параметр Switchover.
  • Переключение — Укажите параметр Switchover или опустите его, но не указывайте параметр AllowDataLoss.
Об аварийном переключении и переключении

Хотя аварийное переключение и переключение глобального кластера баз данных оба изменяют первичный кластер баз данных, вы используете эти операции по разным причинам:

  • Аварийное переключение — Используйте эту операцию для реагирования на непредвиденное событие, например, региональную катастрофу в первичном регионе. Аварийное переключение может привести к потере данных транзакций записи, которые не были реплицированы во вторичном выборе до события аварийного переключения. Однако процесс восстановления, который повышает базу данных экземпляра в выбранном вторичном кластере баз данных до первичного экземпляра базы данных-записи, гарантирует, что данные находятся в транзакционно согласованном состоянии. Дополнительную информацию об аварийном переключении глобальной базы данных Amazon Aurora см. в руководстве пользователя Amazon Aurora.
  • Переключение — Используйте эту операцию для здорового глобального кластера баз данных для запланированных событий, таких как региональная ротация или возвращение к исходному первичному кластеру баз данных после операции аварийного переключения. При этой операции данные не теряются. Дополнительную информацию о переключении глобальной базы данных Amazon Aurora см. в руководстве пользователя Amazon Aurora.

См. также: Документация 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 (строка)

Идентификатор глобального кластера баз данных (глобальной базы данных Aurora), к которому должна быть применена эта операция. Идентификатор — это уникальный ключ, назначенный пользователем при создании глобальной базы данных Aurora. Другими словами, это имя глобальной базы данных Aurora.

Ограничения:

  • Должен совпадать с идентификатором существующего глобального кластера баз данных.

--target-db-cluster-identifier (строка)

Идентификатор вторичного кластера баз данных Aurora, который вы хотите повысить до первичного для глобального кластера баз данных. Используйте Amazon Resource Name (ARN) в качестве идентификатора, чтобы Aurora могла найти кластер в своем регионе Amazon Web Services.

--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
  • 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 -> (строка)

Уникальный, неизменяемый идентификатор глобального кластера базы данных, специфичный для региона Amazon Web Services. Этот идентификатор можно найти в записях журналов Amazon Web Services CloudTrail всякий раз, когда к ключу Amazon Web Services KMS для кластера БД осуществляется доступ.

GlobalClusterArn -> (строка)

Идентификатор ресурса Amazon (ARN) глобального кластера базы данных.

Status -> (строка)

Определяет текущее состояние глобального кластера базы данных.

Engine -> (строка)

Двигатель базы данных Aurora, используемый глобальным кластером базы данных.

EngineVersion -> (строка)

Указывает версию движка базы данных.

EngineLifecycleSupport -> (строка)

Тип жизненного цикла для глобального кластера.

Для получения дополнительной информации см. CreateGlobalCluster.

DatabaseName -> (строка)

Имя по умолчанию для базы данных в новом глобальном кластере базы данных.

StorageEncrypted -> (булево)

Настройка шифрования хранилища для глобального кластера базы данных.

DeletionProtection -> (булево)

Настройка защиты от удаления для нового глобального кластера базы данных.

GlobalClusterMembers -> (список)

Список первичных и вторичных кластеров в глобальном кластере базы данных.

(структура)

Структура данных с информацией о любых первичных и вторичных кластерах, связанных с глобальным кластером (глобальной базой данных Aurora).

DBClusterArn -> (строка)

Идентификатор ресурса Amazon (ARN) каждого кластера Aurora DB в глобальном кластере.

Readers -> (список)

Идентификатор ресурса Amazon (ARN) каждого вторичного кластера чтения, связанного с глобальным кластером.

(строка)

IsWriter -> (булево)

Указывает, является ли кластер Aurora DB первичным кластером (то есть имеет возможность чтения и записи) для глобального кластера, с которым он связан.

GlobalWriteForwardingStatus -> (строка)

Состояние перенаправления записи для вторичного кластера в глобальном кластере.

SynchronizationStatus -> (строка)

Состояние синхронизации каждого кластера Aurora DB в глобальном кластере.

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 -> (строка)

Идентификатор ресурса Amazon (ARN) кластера Aurora DB, который в данный момент понижается и связан с этим состоянием.

ToDbClusterArn -> (строка)

Идентификатор ресурса Amazon (ARN) кластера Aurora DB, который в данный момент повышается и связан с этим состоянием.

IsDataLossAllowed -> (булево)

Указывает, является ли операция глобальным переключением или глобальным аварийным восстановлением. Если потеря данных разрешена, то операция является глобальным аварийным восстановлением. В противном случае — переключением.

TagList -> (список)

Список тегов.

Для получения дополнительной информации см. Размещение тегов на ресурсах Amazon RDS в руководстве Amazon RDS User Guide или Размещение тегов на ресурсах Amazon Aurora и Amazon RDS в руководстве Amazon Aurora User Guide.

(структура)

Метаданные, назначенные ресурсу Amazon RDS, состоящие из пары ключ-значение.

Для получения дополнительной информации см. Размещение тегов на ресурсах Amazon RDS в руководстве Amazon RDS User Guide или Размещение тегов на ресурсах Amazon Aurora и Amazon RDS в руководстве Amazon Aurora User Guide.

Key -> (строка)

Ключ — это требуемое имя тега. Строковое значение может иметь длину от 1 до 128 Unicode-символов и не может начинаться с aws: или rds:. Строка может содержать только набор Unicode-букв, цифр, пробелов, '_', '.', ':', '/', '=', '+', '-', '@' (регулярное выражение Java: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).

Value -> (строка)

Значение — это необязательное значение тега. Строковое значение может иметь длину от 1 до 256 Unicode-символов и не может начинаться с aws: или rds:. Строка может содержать только набор Unicode-букв, цифр, пробелов, '_', '.', ':', '/', '=', '+', '-', '@' (регулярное выражение Java: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).

© Copyright 2025, Amazon Web Services. Created using Sphinx.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API