создать-глобальный-кластер
Описание
Создаёт базу данных Aurora глобального уровня, распределённую по нескольким регионам Amazon Web Services. Глобальная база данных содержит один основной кластер с возможностью чтения/записи и один дополнительный кластер для чтения, который получает данные от основного кластера через высокоскоростную репликацию, выполняемую подсистемой хранения Aurora.
Вы можете создать глобальную базу данных, которая изначально пуста, а затем создать основные и дополнительные кластеры баз данных в глобальной базе данных. Или вы можете указать существующий кластер Aurora во время операции создания, и этот кластер станет основным кластером глобальной базы данных.
Примечание
Данная операция применима только к кластерам баз данных Aurora.См. также: Документация API AWS
Синтаксис
create-global-cluster
[--global-cluster-identifier <value>]
[--source-db-cluster-identifier <value>]
[--engine <value>]
[--engine-version <value>]
[--engine-lifecycle-support <value>]
[--deletion-protection | --no-deletion-protection]
[--database-name <value>]
[--storage-encrypted | --no-storage-encrypted]
[--tags <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 (строка)
--source-db-cluster-identifier (строка)
Amazon Resource Name (ARN) для использования в качестве основного кластера глобальной базы данных.
Если вы предоставляете значение для этого параметра, не указывайте значения для следующих настроек, так как Amazon Aurora использует значения из указанного исходного кластера базы данных:
DatabaseNameEngineEngineVersionStorageEncrypted
--engine (строка)
Двигатель баз данных для использования в этом глобальном кластере.
Допустимые значения: aurora-mysql | aurora-postgresql
Ограничения:
- Не может быть указан, если
SourceDBClusterIdentifierуказан. В этом случае Amazon Aurora использует движок исходного кластера базы данных.
--engine-version (строка)
Версия движка для использования в этом глобальном кластере.
Ограничения:
- Не может быть указан, если
SourceDBClusterIdentifierуказан. В этом случае Amazon Aurora использует версию движка исходного кластера базы данных.
--engine-lifecycle-support (строка)
Тип жизненного цикла для этого глобального кластера.
Примечание
По умолчанию это значение установлено вopen-source-rds-extended-support, что подключает ваш глобальный кластер к расширенной поддержке Amazon RDS. В конце стандартной поддержки вы можете избежать платы за расширенную поддержку, установив значение в open-source-rds-extended-support-disabled. В этом случае создание глобального кластера завершится ошибкой, если основная версия базы данных вышла за пределы даты окончания стандартной поддержки.Это значение применяется только к глобальным базам данных на основе Aurora PostgreSQL.
Вы можете использовать это значение для подключения вашего глобального кластера к расширенной поддержке Amazon RDS. С помощью расширенной поддержки RDS вы можете запускать выбранную основную версию движка в вашем глобальном кластере после окончания стандартной поддержки для этой версии движка. Дополнительная информация см. в разделе Расширенная поддержка Amazon RDS с Amazon Aurora в руководстве пользователя Amazon Aurora.
Допустимые значения: open-source-rds-extended-support | open-source-rds-extended-support-disabled
По умолчанию: open-source-rds-extended-support
--deletion-protection | --no-deletion-protection (логическое)
--database-name (строка)
Имя вашей базы данных, содержащей до 64 буквенно-цифровых символов. Если вы не укажете имя, Amazon Aurora не создаст базу данных в глобальном кластере.
Ограничения:
- Не может быть указан, если
SourceDBClusterIdentifierуказан. В этом случае Amazon Aurora использует имя базы данных из исходного кластера базы данных.
--storage-encrypted | --no-storage-encrypted (логическое)
Указывает, следует ли включить шифрование хранилища для нового глобального кластера базы данных.
Ограничения:
- Не может быть указан, если
SourceDBClusterIdentifierуказан. В этом случае Amazon Aurora использует значение из исходного кластера базы данных.
--tags (список)
Теги для назначения глобальному кластеру.
(структура)
Метаданные, назначенные ресурсу Amazon RDS, состоящие из пары ключ-значение.
Дополнительную информацию см. в разделе Маркировка ресурсов Amazon RDS в руководстве пользователя Amazon RDS или Маркировка ресурсов Amazon Aurora и Amazon RDS в руководстве пользователя Amazon Aurora.
Ключ -> (строка)
aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «:», «/», «=», «+», «-», «@» (регулярное выражение Java: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).Значение -> (строка)
aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «:», «/», «=», «+», «-», «@» (регулярное выражение Java: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).Синтаксис сокращённого ввода:
Key=string,Value=string ...
Синтаксис JSON:
[
{
"Key": "string",
"Value": "string"
}
...
]
--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.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. См. руководство по началу работы в руководстве пользователя AWS CLI для получения дополнительной информации.
Если не указано иное, все примеры используют правила цитирования Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. использование кавычек со строками в руководстве пользователя AWS CLI.
Создание глобального кластера БД
Следующий create-global-cluster пример создаёт новый глобальный кластер БД Aurora, совместимый с MySQL.
aws rds create-global-cluster \
--global-cluster-identifier myglobalcluster \
--engine aurora-mysql
Вывод:
{
"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": false,
"GlobalClusterMembers": []
}
}
Дополнительную информацию см. в разделе Создание глобальной базы данных Aurora в руководстве пользователя Amazon Aurora.
Вывод
GlobalCluster -> (структура)
Тип данных, представляющий глобальную базу данных Aurora.
GlobalClusterIdentifier -> (строка)
GlobalClusterResourceId -> (строка)
GlobalClusterArn -> (строка)
Статус -> (строка)
Двигатель -> (строка)
Версия двигателя -> (строка)
Поддержка жизненного цикла двигателя -> (строка)
Тип жизненного цикла глобального кластера.
Дополнительная информация содержится в разделе CreateGlobalCluster.
Имя базы данных -> (строка)
Шифрование хранилища -> (булево)
Защита от удаления -> (булево)
GlobalClusterMembers -> (список)
Список первичных и вторичных кластеров в глобальном кластере базы данных.
(структура)
Структура данных с информацией о первичных и вторичных кластерах, связанных с глобальным кластером (глобальной базой данных Aurora).
DBClusterArn -> (строка)
Читатели -> (список)
Идентификатор ресурса Amazon (ARN) для каждого вторичного кластера с возможностью чтения, связанного с глобальным кластером.
(строка)
Пишущий -> (булево)
Статус переадресации записи -> (строка)
Статус синхронизации -> (строка)
Конечная точка -> (строка)
Состояние переключения -> (структура)
Объект данных, содержащий все свойства текущего состояния процесса переключения или аварийного переключения для этого глобального кластера (глобальной базы данных Aurora). Этот объект пуст, если для этого глобального кластера не было вызвано действие SwitchoverGlobalCluster или FailoverGlobalCluster.
Статус -> (строка)
Текущий статус глобального кластера. Возможные значения:
- pending – Сервис получил запрос на переключение или аварийное переключение глобального кластера. Первичный кластер БД глобального кластера и указанный вторичный кластер БД проверяются перед началом операции.
- failing-over – Aurora продвигает выбранный вторичный кластер БД Aurora до первичного, чтобы выполнить аварийное переключение глобального кластера.
- cancelling – Запрос на переключение или аварийное переключение глобального кластера был отменен, и первичный кластер БД Aurora и выбранный вторичный кластер БД возвращаются в исходное состояние.
- switching-over – Этот статус охватывает ряд внутренних операций Aurora, происходящих во время процесса переключения, таких как понижение первичного кластера БД Aurora, повышение вторичного кластера БД Aurora и синхронизация реплик.
FromDbClusterArn -> (строка)
ToDbClusterArn -> (строка)
Разрешение потери данных -> (булево)
Список тегов -> (список)
Список тегов.
Дополнительную информацию можно найти в разделе «Размещение тегов ресурсов Amazon RDS» в руководстве пользователя Amazon RDS или «Размещение тегов ресурсов Amazon Aurora и Amazon RDS» в руководстве пользователя Amazon Aurora.
(структура)
Метаданные, назначенные ресурсу Amazon RDS, представляющие собой пару ключ-значение.
Дополнительную информацию можно найти в разделе «Размещение тегов ресурсов Amazon RDS» в руководстве пользователя Amazon RDS или «Размещение тегов ресурсов Amazon Aurora и Amazon RDS» в руководстве пользователя Amazon Aurora.
Ключ -> (строка)
aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «:», «/», «=», «+», «-», «@» (Java regex: «^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$»).Значение -> (строка)
aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «:», «/», «=», «+», «-», «@» (Java regex: «^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$»).
© Copyright 2025, Amazon Web Services. Created using Sphinx.