копирование-снэпшота-кластера-баз-данных
Описание
Копирует снимок кластера баз данных.
Чтобы скопировать снимок кластера баз данных из общего ручного снимка кластера баз данных, SourceDBClusterSnapshotIdentifier должно быть Amazon Resource Name (ARN) общего снимка кластера баз данных.
Вы можете копировать зашифрованный снимок кластера баз данных из другой области Amazon Web Services. В этом случае область Amazon Web Services, в которой вы вызываете операцию CopyDBClusterSnapshot, является целевой областью Amazon Web Services для копирования зашифрованного снимка кластера баз данных. Чтобы скопировать зашифрованный снимок кластера баз данных из другой области Amazon Web Services, вы должны указать следующие значения:
-
KmsKeyId- идентификатор ключа Amazon Web Services Key Management System (Amazon Web Services KMS) для ключа, который будет использоваться для шифрования копии снимка кластера баз данных в целевой области Amazon Web Services. -
TargetDBClusterSnapshotIdentifier- идентификатор новой копии снимка кластера баз данных в целевой области Amazon Web Services. -
SourceDBClusterSnapshotIdentifier- идентификатор снимка кластера баз данных для зашифрованного снимка кластера баз данных, который нужно скопировать. Этот идентификатор должен быть в формате ARN для исходной области Amazon Web Services и совпадает со значениемSourceDBClusterSnapshotIdentifierв предварительно подписанной ссылке.
Чтобы отменить операцию копирования, когда она находится в процессе, удалите целевой снимок кластера баз данных, идентифицированный по TargetDBClusterSnapshotIdentifier, пока этот снимок находится в состоянии «копирования».
Дополнительную информацию о копировании зашифрованных снимков кластеров баз данных Amazon Aurora из одной области Amazon Web Services в другую см. в руководстве пользователя Amazon Aurora, раздел Копирование снимка .
Дополнительную информацию о кластерах баз данных Amazon Aurora см. в руководстве пользователя Amazon Aurora, раздел Что такое Amazon Aurora?
Дополнительную информацию о кластерах баз данных Multi-AZ см. в руководстве пользователя Amazon RDS, раздел Развертывания кластеров баз данных Multi-AZ.
См. также: Документация API AWS
Синтаксис
copy-db-cluster-snapshot
--source-db-cluster-snapshot-identifier <value>
--target-db-cluster-snapshot-identifier <value>
[--kms-key-id <value>]
[--pre-signed-url <value>]
[--copy-tags | --no-copy-tags]
[--tags <value>]
[--source-region <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]
Параметры
--source-db-cluster-snapshot-identifier (строка)
Идентификатор снимка кластера баз данных, который нужно скопировать. Этот параметр не чувствителен к регистру.
Вы не можете скопировать зашифрованный, общий снимок кластера баз данных из одной области Amazon Web Services в другую.
Ограничения:
- Необходимо указать допустимый системный снимок в состоянии «доступен».
- Если исходный снимок находится в той же области Amazon Web Services, что и копия, укажите допустимый идентификатор снимка базы данных.
- Если исходный снимок находится в другой области Amazon Web Services, чем копия, укажите действительный ARN снимка кластера баз данных. Дополнительную информацию см. в руководстве пользователя Amazon Aurora, раздел Копирование снимков между регионами Amazon Web Services.
Пример: my-cluster-snapshot1
--target-db-cluster-snapshot-identifier (строка)
Идентификатор нового снимка кластера баз данных, который нужно создать из исходного снимка кластера баз данных. Этот параметр не чувствителен к регистру.
Ограничения:
- Должен содержать от 1 до 63 букв, цифр или дефисов.
- Первый символ должен быть буквой.
- Не может заканчиваться дефисом или содержать два дефиса подряд.
Пример: my-cluster-snapshot2
--kms-key-id (строка)
Идентификатор ключа Amazon Web Services KMS для зашифрованного снимка кластера баз данных. Идентификатор ключа Amazon Web Services KMS — это ARN ключа, ID ключа, ARN псевдонима или имя псевдонима ключа Amazon Web Services KMS.
Если вы копируете зашифрованный снимок кластера баз данных из своей учетной записи Amazon Web Services, вы можете указать значение для KmsKeyId, чтобы зашифровать копию новым ключом KMS. Если вы не укажете значение для KmsKeyId, то копия снимка кластера баз данных зашифруется тем же ключом KMS, что и исходный снимок кластера баз данных.
Если вы копируете зашифрованный снимок кластера баз данных, общий от другой учетной записи Amazon Web Services, то вы должны указать значение для KmsKeyId.
Чтобы скопировать зашифрованный снимок кластера баз данных в другую область Amazon Web Services, вы должны установить KmsKeyId на идентификатор ключа Amazon Web Services KMS, который вы хотите использовать для шифрования копии снимка кластера баз данных в целевой области Amazon Web Services. Ключи KMS специфичны для области Amazon Web Services, в которой они созданы, и вы не можете использовать ключи KMS из одной области Amazon Web Services в другой.
Если вы копируете незашифрованный снимок кластера баз данных и указываете значение для параметра KmsKeyId, возвращается ошибка.
--pre-signed-url (строка)
Когда вы копируете снимок кластера баз данных из одной области Amazon Web Services GovCloud (US) в другую, URL, содержащий предварительно подписанный запрос Signature Version 4 для операции API CopyDBClusterSnapshot в области Amazon Web Services, содержащей исходный снимок кластера баз данных для копирования. Используйте параметр PreSignedUrl при копировании зашифрованного снимка кластера баз данных из другой области Amazon Web Services. Не указывайте PreSignedUrl при копировании зашифрованного снимка кластера баз данных в той же области Amazon Web Services.
Это значение применяется только к областям Amazon Web Services GovCloud (US). В других областях Amazon Web Services оно игнорируется.
Предварительно подписанная ссылка должна быть допустимым запросом для операции API CopyDBClusterSnapshot, которая может быть выполнена в исходной области Amazon Web Services, содержащей зашифрованный снимок кластера баз данных для копирования. Предварительно подписанный запрос URL должен содержать следующие значения параметров:
-
KmsKeyId- идентификатор ключа KMS для ключа KMS, который будет использоваться для шифрования копии снимка кластера баз данных в целевой области Amazon Web Services. Это тот же идентификатор, что и для операцииCopyDBClusterSnapshot, которая вызывается в целевой области Amazon Web Services, и для операции, содержащейся в предварительно подписанной ссылке. -
DestinationRegion- имя области Amazon Web Services, в которой должен быть создан снимок кластера баз данных. -
SourceDBClusterSnapshotIdentifier- идентификатор снимка кластера баз данных для зашифрованного снимка кластера баз данных, который нужно скопировать. Этот идентификатор должен быть в формате Amazon Resource Name (ARN) для исходной области Amazon Web Services. Например, если вы копируете зашифрованный снимок кластера баз данных из области Amazon Web Services us-west-2, ваш параметрSourceDBClusterSnapshotIdentifierбудет выглядеть следующим образом:arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115.
Чтобы узнать, как сгенерировать предварительно подписанный запрос Signature Version 4, см. Авторизация запросов: использование параметров запроса (Amazon Web Services Signature Version 4) и Процесс подписи Signature Version 4.
Примечание
Если вы используете инструмент Amazon Web Services SDK или командную строку CLI, вы можете указатьSourceRegion (или --source-region для командной строки CLI) вместо ручного указания параметра PreSignedUrl. Указание параметра SourceRegion автоматически генерирует предварительно подписанную ссылку, которая является допустимым запросом для операции, которая может выполняться в исходной области Amazon Web Services.--copy-tags | --no-copy-tags (логическое)
--tags (список)
Список тегов.
Дополнительную информацию см. в руководстве пользователя Amazon RDS, раздел Добавление тегов к ресурсам Amazon RDS, или в руководстве пользователя Amazon Aurora, раздел Добавление тегов к ресурсам Amazon Aurora и Amazon RDS.
(структура)
Метаданные, назначенные ресурсу Amazon RDS, состоящие из пары «ключ-значение».
Дополнительную информацию см. в руководстве пользователя Amazon RDS, раздел Добавление тегов к ресурсам Amazon RDS, или в руководстве пользователя Amazon Aurora, раздел Добавление тегов к ресурсам Amazon Aurora и Amazon RDS.
Ключ -> (строка)
aws: или rds:. Строка может содержать только набор Unicode букв, цифр, пробелов, «_», «.», «:», «/», «=», «+», «-», «@» (Java regex: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).Значение -> (строка)
aws: или rds:. Строка может содержать только набор Unicode букв, цифр, пробелов, «_», «.», «:», «/», «=», «+», «-», «@» (Java regex: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).Сокращенный синтаксис:
Key=string,Value=string ...
JSON синтаксис:
[
{
"Key": "string",
"Value": "string"
}
...
]
--source-region (строка)
--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 (boolean)
Включить отладку регистрации.
--endpoint-url (string)
Переопределить стандартный URL команды заданным URL.
--no-verify-ssl (boolean)
По умолчанию AWS CLI использует SSL при общении с AWS-сервисами. Для каждого SSL-соединения AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки SSL-сертификатов по умолчанию.
--no-paginate (boolean)
Отключить автоматическую постраничную навигацию. Если автоматическая постраничная навигация отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (string)
Стиль форматирования вывода команд.
- json
- text
- table
- yaml
- yaml-stream
--query (string)
Запрос JMESPath для фильтрации данных ответа.
--profile (string)
Использовать определённый профиль из файла с данными учетных данных.
--region (string)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (string)
Отобразить версию этого инструмента.
--color (string)
Включить/выключить вывод цвета.
- on
- off
- auto
--no-sign-request (boolean)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--ca-bundle (string)
Файл сертификатов CA для проверки SSL-сертификатов. Переопределяет настройки конфигурации/среды.
--cli-read-timeout (int)
Максимальное время чтения сокета в секундах. Если значение установлено в 0, чтение сокета будет блокирующим и не будет иметь таймаута. Значение по умолчанию - 60 секунд.
--cli-connect-timeout (int)
Максимальное время подключения к сокету в секундах. Если значение установлено в 0, подключение к сокету будет блокирующим и не будет иметь таймаута. Значение по умолчанию - 60 секунд.
--cli-binary-format (string)
Стиль форматирования для бинарных блоков. Формат по умолчанию - 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 (boolean)
Отключить пейджер CLI для вывода.
--cli-auto-prompt (boolean)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическое запросы параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования, аналогичные правилам Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки терминала. См. Использование кавычек со строками в Руководстве пользователя AWS CLI.
Для копирования моментального снимка кластера баз данных
Следующий пример создаёт копию моментального снимка кластера баз данных, включая его метки.
aws rds copy-db-cluster-snapshot \
--source-db-cluster-snapshot-identifier arn:aws:rds:us-east-1:123456789012:cluster-snapshot:rds:myaurora-2019-06-04-09-16
--target-db-cluster-snapshot-identifier myclustersnapshotcopy \
--copy-tags
Вывод:
{
"DBClusterSnapshot": {
"AvailabilityZones": [
"us-east-1a",
"us-east-1b",
"us-east-1e"
],
"DBClusterSnapshotIdentifier": "myclustersnapshotcopy",
"DBClusterIdentifier": "myaurora",
"SnapshotCreateTime": "2019-06-04T09:16:42.649Z",
"Engine": "aurora-mysql",
"AllocatedStorage": 0,
"Status": "available",
"Port": 0,
"VpcId": "vpc-6594f31c",
"ClusterCreateTime": "2019-04-15T14:18:42.785Z",
"MasterUsername": "myadmin",
"EngineVersion": "5.7.mysql_aurora.2.04.2",
"LicenseModel": "aurora-mysql",
"SnapshotType": "manual",
"PercentProgress": 100,
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE",
"DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:myclustersnapshotcopy",
"IAMDatabaseAuthenticationEnabled": false
}
}
Дополнительную информацию см. в разделе Копирование моментального снимка в Руководстве пользователя Amazon Aurora.
Вывод
DBClusterSnapshot -> (структура)
Содержит данные для моментального снимка кластера баз данных Amazon RDS
Этот тип данных используется в качестве элемента ответа в действии DescribeDBClusterSnapshots.
AvailabilityZones -> (список)
Список доступных зон (AZ), в которых можно восстановить экземпляры в моментальном снимке кластера баз данных.
(строка)
DBClusterSnapshotIdentifier -> (строка)
DBClusterIdentifier -> (строка)
SnapshotCreateTime -> (метка времени)
Engine -> (строка)
EngineMode -> (строка)
AllocatedStorage -> (целое число)
Status -> (строка)
Состояние этого моментального снимка кластера баз данных. Допустимые состояния следующие:
availablecopyingcreating
Port -> (целое число)
VpcId -> (строка)
ClusterCreateTime -> (метка времени)
MasterUsername -> (строка)
EngineVersion -> (строка)
LicenseModel -> (строка)
SnapshotType -> (строка)
PercentProgress -> (целое число)
StorageEncrypted -> (boolean)
KmsKeyId -> (строка)
Если StorageEncrypted равно true, идентификатор ключа Amazon Web Services KMS для зашифрованного моментального снимка кластера баз данных.
Идентификатор ключа Amazon Web Services KMS — это ARN ключа, ID ключа, ARN псевдонима или имя псевдонима для ключа KMS.
DBClusterSnapshotArn -> (строка)
SourceDBClusterSnapshotArn -> (строка)
IAMDatabaseAuthenticationEnabled -> (boolean)
TagList -> (список)
Список меток.
Дополнительную информацию см. в разделе Метки ресурсов Amazon RDS в Руководстве пользователя Amazon RDS или Метки ресурсов Amazon Aurora и Amazon RDS в Руководстве пользователя Amazon Aurora.
(структура)
Метаданные, присвоенные ресурсу Amazon RDS, состоящие из пары ключ-значение.
Дополнительную информацию см. в разделе Метки ресурсов Amazon RDS в Руководстве пользователя Amazon RDS или Метки ресурсов Amazon Aurora и Amazon RDS в Руководстве пользователя Amazon Aurora.
Key -> (строка)
aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «:», «/», «=», «+», «-», «@» (регулярное выражение Java: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).Value -> (строка)
aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, «_», «.», «:», «/», «=», «+», «-», «@» (регулярное выражение Java: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).DBSystemId -> (строка)
StorageType -> (строка)
Тип хранилища, связанный с моментальным снимком кластера баз данных.
Эта настройка используется только для Aurora кластеров баз данных.
DbClusterResourceId -> (строка)
StorageThroughput -> (целое число)
Пропускная способность хранилища для моментального снимка кластера баз данных. Пропускная способность автоматически устанавливается на основе запрошенных операций ввода-вывода, и не настраивается.
Эта настройка применяется только к не-Aurora кластерам баз данных Multi-AZ.
© Copyright 2025, Amazon Web Services. Created using Sphinx.