Spec-Zone.ru › AWS CLI v2

[ aws . rds ]

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

Amazon Resource Name (ARN) исходной базы данных для реплицированных автоматических резервных копий, например, arn:aws:rds:us-west-2:123456789012:db:mydatabase .

--backup-retention-period (целое число)

Срок хранения реплицированных автоматических резервных копий.

--kms-key-id (строка)

Идентификатор ключа Amazon Web Services KMS для шифрования реплицированных автоматических резервных копий. Идентификатор ключа KMS — это Amazon Resource Name (ARN) для ключа шифрования KMS в целевом регионе Amazon Web Services, например, 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 -> (строка)

Идентификатор Amazon Resource Name (ARN) для автоматических резервных копий.

DbiResourceId -> (строка)

Идентификатор ресурса исходного экземпляра базы данных, который нельзя изменить и который уникален для каждой зоны Amazon Web Services.

Region -> (строка)

Зона Amazon Web Services, связанная с автоматическим резервным копированием.

DBInstanceIdentifier -> (строка)

Идентификатор исходного экземпляра базы данных, который нельзя изменить и который уникален для каждой зоны Amazon Web Services.

RestoreWindow -> (структура)

Наименьшее и наибольшее время, в которое экземпляр базы данных может быть восстановлен.

EarliestTime -> (метка времени)

Наименьшее время, к которому можно восстановить экземпляр.

LatestTime -> (метка времени)

Наибольшее время, к которому можно восстановить экземпляр.

AllocatedStorage -> (целое число)

Размер выделенного хранилища для автоматического резервного копирования в гигабайтах (GiB).

Status -> (строка)

Список статуса информации об автоматическом резервном копировании:

  • active - Автоматические резервные копии для текущих экземпляров.
  • retained - Автоматические резервные копии для удалённых экземпляров.
  • creating - Автоматические резервные копии, ожидающие доступности первого автоматического снимка.

Port -> (целое число)

Номер порта, используемый автоматическим резервным копированием для соединений.

По умолчанию: Наследуется от исходного экземпляра базы данных

Допустимые значения: 1150-65535

AvailabilityZone -> (строка)

Зона доступности, в которой было создано автоматическое резервное копирование. Для получения информации о зонах Amazon Web Services, см. [Регионы и зоны доступности](###NON_TRANSLATABLE_LINK###).

VpcId -> (строка)

Идентификатор VPC, связанный с экземпляром базы данных.

InstanceCreateTime -> (метка времени)

Дата и время создания экземпляра базы данных.

MasterUsername -> (строка)

Имя пользователя мастера автоматической резервной копии.

Engine -> (строка)

Имя СУБД для этого автоматического резервного копирования.

EngineVersion -> (строка)

Версия СУБД для автоматического резервного копирования.

LicenseModel -> (строка)

Информация о лицензии для автоматического резервного копирования.

Iops -> (целое число)

Значение IOPS (операций ввода-вывода в секунду) для автоматического резервного копирования.

OptionGroupName -> (строка)

Группа параметров, с которой связано автоматическое резервное копирование. Если опущено, используется группа параметров по умолчанию для указанного движка.

TdeCredentialArn -> (строка)

ARN из хранилища ключей, с которым связано автоматическое резервное копирование для шифрования TDE.

Encrypted -> (булево)

Указывает, зашифровано ли автоматическое резервное копирование.

StorageType -> (строка)

Тип хранилища, связанный с автоматическим резервным копированием.

KmsKeyId -> (строка)

Идентификатор ключа Amazon Web Services KMS для автоматического резервного копирования.

Идентификатор ключа Amazon Web Services KMS — это ARN ключа, идентификатор ключа, ARN псевдонима или имя псевдонима для ключа KMS.

Timezone -> (строка)

Временная зона автоматического резервного копирования. В большинстве случаев элемент Timezone пустой. Timezone содержимое появляется только для экземпляров базы данных Microsoft SQL Server, которые были созданы с указанием временной зоны.

IAMDatabaseAuthenticationEnabled -> (булево)

Истинно, если сопоставление учетных записей Amazon Web Services Identity and Access Management (IAM) с учетными записями баз данных включено, и ложно в противном случае.

BackupRetentionPeriod -> (целое число)

Срок хранения автоматических резервных копий.

DBInstanceAutomatedBackupsArn -> (строка)

Идентификатор Amazon Resource Name (ARN) для реплицированных автоматических резервных копий.

DBInstanceAutomatedBackupsReplications -> (список)

Список реплик в различных регионах Amazon Web Services, связанных с автоматическим резервным копированием.

(структура)

Автоматические резервные копии экземпляра базы данных, реплицированные в другой регион Amazon Web Services. Они состоят из системных резервных копий, журналов транзакций и свойств экземпляра базы данных.

DBInstanceAutomatedBackupsArn -> (строка)

Amazon Resource Name (ARN) реплицированных автоматических резервных копий.

BackupTarget -> (строка)

Место расположения автоматических резервных копий: Amazon Web Services Outposts или регион Amazon Web Services.

StorageThroughput -> (целое число)

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

AwsBackupRecoveryPointArn -> (строка)

Amazon Resource Name (ARN) точки восстановления в Amazon Web Services Backup.

DedicatedLogVolume -> (булево)

Указывает, включен ли для экземпляра базы данных выделенный том журналов (DLV).

MultiTenant -> (булево)

Указывает, является ли автоматическое резервное копирование для экземпляра базы данных в многоарендной конфигурации (ИСТИНА) или одноарендной конфигурации (ЛОЖЬ).

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

END_OF_DOCUMENT_MARKER

Spec-Zone.ru

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