start-db-instance-automated-backups-replication
Описание
Включает репликацию автоматических резервных копий в другой регион Amazon Web Services.
Данная команда не применяется к RDS Custom.
Для получения дополнительной информации см. раздел Репликация автоматических резервных копий в другой регион Amazon Web Services в Руководстве пользователя Amazon RDS.
См. также: Документация API AWS
Синтаксис
start-db-instance-automated-backups-replication
--source-db-instance-arn <value>
[--backup-retention-period <value>]
[--kms-key-id <value>]
[--pre-signed-url <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-instance-arn (строка)
arn:aws:rds:us-west-2:123456789012:db:mydatabase .--backup-retention-period (целое число)
--kms-key-id (строка)
arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE .--pre-signed-url (строка)
В регионе Amazon Web Services GovCloud (US) URL, содержащий подписанный запрос Signature Version 4 для операции StartDBInstanceAutomatedBackupsReplication для вызова в регионе Amazon Web Services исходной базы данных. Предварительно подписанный URL должен быть корректным запросом для API-операции StartDBInstanceAutomatedBackupsReplication, которая может выполняться в регионе Amazon Web Services, содержащем исходную базу данных.
Это значение применяется только к регионам Amazon Web Services GovCloud (US). Оно игнорируется в других регионах Amazon Web Services.
Дополнительные сведения о создании подписанного запроса Signature Version 4 см. в разделах Авторизация запросов: Использование параметров запроса (Amazon Web Services Signature Version 4) и Процесс подписи Signature Version 4.
Примечание
Если вы используете инструмент Amazon Web Services SDK или консоль команд, вы можете указатьSourceRegion (или --source-region для консоли команд) вместо ручного указания PreSignedUrl. Указание SourceRegion автоматически генерирует предварительно подписанный URL, являющийся корректным запросом для операции, которую можно выполнить в исходном регионе Amazon Web Services.--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 (булево)
Включить отладку.
--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 версии 1, и двоичные значения должны быть переданы буквально. При предоставлении содержимого из файла, сопоставляющегося с двоичным блоком, 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.
Для включения автоматических резервных копий между регионами
В следующем примере автоматические резервные копии реплицируются из базы данных в регионе США Восточный (Северная Вирджиния) в регион США Западный (Орегон). Срок хранения резервных копий — 14 дней.
aws rds start-db-instance-automated-backups-replication \
--region us-west-2 \
--source-db-instance-arn "arn:aws:rds:us-east-1:123456789012:db:new-orcl-db" \
--backup-retention-period 14
Вывод:
{
"DBInstanceAutomatedBackup": {
"DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:new-orcl-db",
"DbiResourceId": "db-JKIB2GFQ5RV7REPLZA4EXAMPLE",
"Region": "us-east-1",
"DBInstanceIdentifier": "new-orcl-db",
"RestoreWindow": {},
"AllocatedStorage": 20,
"Status": "pending",
"Port": 1521,
"InstanceCreateTime": "2020-12-04T15:28:31Z",
"MasterUsername": "admin",
"Engine": "oracle-se2",
"EngineVersion": "12.1.0.2.v21",
"LicenseModel": "bring-your-own-license",
"OptionGroupName": "default:oracle-se2-12-1",
"Encrypted": false,
"StorageType": "gp2",
"IAMDatabaseAuthenticationEnabled": false,
"BackupRetentionPeriod": 14,
"DBInstanceAutomatedBackupsArn": "arn:aws:rds:us-west-2:123456789012:auto-backup:ab-jkib2gfq5rv7replzadausbrktni2bn4example"
}
}
Дополнительные сведения см. в разделе Включение автоматических резервных копий между регионами в Руководстве пользователя Amazon RDS.
Вывод
DBInstanceAutomatedBackup -> (структура)
Автоматическое резервное копирование экземпляра базы данных. Оно состоит из системных резервных копий, журналов транзакций и свойств экземпляра базы данных, существовавших на момент удаления исходного экземпляра.
DBInstanceArn -> (строка)
DbiResourceId -> (строка)
Region -> (строка)
DBInstanceIdentifier -> (строка)
RestoreWindow -> (структура)
Наименьшее и наибольшее время, в которое экземпляр базы данных может быть восстановлен.
EarliestTime -> (метка времени)
LatestTime -> (метка времени)
AllocatedStorage -> (целое число)
Status -> (строка)
Список статуса информации об автоматическом резервном копировании:
-
active- Автоматические резервные копии для текущих экземпляров. -
retained- Автоматические резервные копии для удалённых экземпляров. -
creating- Автоматические резервные копии, ожидающие доступности первого автоматического снимка.
Port -> (целое число)
Номер порта, используемый автоматическим резервным копированием для соединений.
По умолчанию: Наследуется от исходного экземпляра базы данных
Допустимые значения: 1150-65535
AvailabilityZone -> (строка)
VpcId -> (строка)
InstanceCreateTime -> (метка времени)
MasterUsername -> (строка)
Engine -> (строка)
EngineVersion -> (строка)
LicenseModel -> (строка)
Iops -> (целое число)
OptionGroupName -> (строка)
TdeCredentialArn -> (строка)
Encrypted -> (булево)
StorageType -> (строка)
KmsKeyId -> (строка)
Идентификатор ключа Amazon Web Services KMS для автоматического резервного копирования.
Идентификатор ключа Amazon Web Services KMS — это ARN ключа, идентификатор ключа, ARN псевдонима или имя псевдонима для ключа KMS.
Timezone -> (строка)
Timezone пустой. Timezone содержимое появляется только для экземпляров базы данных Microsoft SQL Server, которые были созданы с указанием временной зоны.IAMDatabaseAuthenticationEnabled -> (булево)
BackupRetentionPeriod -> (целое число)
DBInstanceAutomatedBackupsArn -> (строка)
DBInstanceAutomatedBackupsReplications -> (список)
Список реплик в различных регионах Amazon Web Services, связанных с автоматическим резервным копированием.
(структура)
Автоматические резервные копии экземпляра базы данных, реплицированные в другой регион Amazon Web Services. Они состоят из системных резервных копий, журналов транзакций и свойств экземпляра базы данных.
DBInstanceAutomatedBackupsArn -> (строка)
BackupTarget -> (строка)
StorageThroughput -> (целое число)
AwsBackupRecoveryPointArn -> (строка)
DedicatedLogVolume -> (булево)
MultiTenant -> (булево)
© Copyright 2025, Amazon Web Services. Created using Sphinx.