Spec-Zone.ru › AWS CLI v2

[ aws . rds ]

создать-глобальный-кластер

Описание

Создаёт базу данных 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 использует значения из указанного исходного кластера базы данных:

  • DatabaseName
  • Engine
  • EngineVersion
  • StorageEncrypted

--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.

Ключ -> (строка)

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

Значение -> (строка)

Значение — это необязательное значение тега. Строковое значение может содержать от 1 до 256 символов Юникода и не может начинаться с 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 -> (строка)

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

GlobalClusterArn -> (строка)

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

Статус -> (строка)

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

Двигатель -> (строка)

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

Версия двигателя -> (строка)

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

Поддержка жизненного цикла двигателя -> (строка)

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

Дополнительная информация содержится в разделе CreateGlobalCluster.

Имя базы данных -> (строка)

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

Шифрование хранилища -> (булево)

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

Защита от удаления -> (булево)

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

GlobalClusterMembers -> (список)

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

(структура)

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

DBClusterArn -> (строка)

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

Читатели -> (список)

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

(строка)

Пишущий -> (булево)

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

Статус переадресации записи -> (строка)

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

Статус синхронизации -> (строка)

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

Конечная точка -> (строка)

Конечная точка для записи нового глобального кластера базы данных. Эта конечная точка всегда указывает на экземпляр БД записи в текущем первичном кластере.

Состояние переключения -> (структура)

Объект данных, содержащий все свойства текущего состояния процесса переключения или аварийного переключения для этого глобального кластера (глобальной базы данных Aurora). Этот объект пуст, если для этого глобального кластера не было вызвано действие SwitchoverGlobalCluster или FailoverGlobalCluster.

Статус -> (строка)

Текущий статус глобального кластера. Возможные значения:

  • pending – Сервис получил запрос на переключение или аварийное переключение глобального кластера. Первичный кластер БД глобального кластера и указанный вторичный кластер БД проверяются перед началом операции.
  • failing-over – Aurora продвигает выбранный вторичный кластер БД Aurora до первичного, чтобы выполнить аварийное переключение глобального кластера.
  • cancelling – Запрос на переключение или аварийное переключение глобального кластера был отменен, и первичный кластер БД Aurora и выбранный вторичный кластер БД возвращаются в исходное состояние.
  • switching-over – Этот статус охватывает ряд внутренних операций Aurora, происходящих во время процесса переключения, таких как понижение первичного кластера БД Aurora, повышение вторичного кластера БД Aurora и синхронизация реплик.

FromDbClusterArn -> (строка)

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

ToDbClusterArn -> (строка)

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

Разрешение потери данных -> (булево)

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

Список тегов -> (список)

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

Дополнительную информацию можно найти в разделе «Размещение тегов ресурсов Amazon RDS» в руководстве пользователя Amazon RDS или «Размещение тегов ресурсов Amazon Aurora и Amazon RDS» в руководстве пользователя Amazon Aurora.

(структура)

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

Дополнительную информацию можно найти в разделе «Размещение тегов ресурсов Amazon RDS» в руководстве пользователя Amazon RDS или «Размещение тегов ресурсов Amazon Aurora и Amazon RDS» в руководстве пользователя Amazon Aurora.

Ключ -> (строка)

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

Значение -> (строка)

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

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

Spec-Zone.ru

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