восстановление-кластера-баз-данных-до-точки-времени

Описание

Восстанавливает кластер баз данных до произвольной точки во времени. Пользователи могут восстановить до любой точки во времени до LatestRestorableTime в течение BackupRetentionPeriod дней. Целевой кластер баз данных создаётся из исходного кластера баз данных с такой же конфигурацией, как и исходный кластер баз данных, за исключением того, что новый кластер баз данных создаётся с группой безопасности баз данных по умолчанию.

Примечание

Это действие восстанавливает только кластер баз данных, а не экземпляры баз данных для этого кластера баз данных. Вы должны вызвать действие CreateDBInstance, чтобы создать экземпляры баз данных для восстановленного кластера баз данных, указав идентификатор восстановленного кластера баз данных в DBClusterIdentifier. Вы можете создавать экземпляры баз данных только после завершения действия RestoreDBClusterToPointInTime и готовности кластера баз данных.

См. также: Документация API AWS

Синтаксис

  restore-db-cluster-to-point-in-time
--db-cluster-identifier <value>
[--restore-type <value>]
--source-db-cluster-identifier <value>
[--restore-to-time <value>]
[--use-latest-restorable-time | --no-use-latest-restorable-time]
[--port <value>]
[--db-subnet-group-name <value>]
[--option-group-name <value>]
[--vpc-security-group-ids <value>]
[--tags <value>]
[--kms-key-id <value>]
[--enable-iam-database-authentication | --no-enable-iam-database-authentication]
[--enable-cloudwatch-logs-exports <value>]
[--db-cluster-parameter-group-name <value>]
[--deletion-protection | --no-deletion-protection]
[--serverless-v2-scaling-configuration <value>]
[--storage-type <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]

Параметры

--db-cluster-identifier (строка)

Имя нового кластера баз данных, который должен быть создан.

Ограничения:

Должно содержать от 1 до 63 букв, цифр или дефисов
Первый символ должен быть буквой
Не должно заканчиваться дефисом или содержать два последовательных дефиса

--restore-type (строка)

Тип выполняемого восстановления. Вы можете указать одно из следующих значений:

full-copy - Новый кластер баз данных восстанавливается как полная копия исходного кластера баз данных.
copy-on-write - Новый кластер баз данных восстанавливается как клон исходного кластера баз данных.

Если вы не указываете значение RestoreType, то новый кластер баз данных восстанавливается как полная копия исходного кластера баз данных.

--source-db-cluster-identifier (строка)

Идентификатор исходного кластера баз данных, из которого нужно выполнить восстановление.

Ограничения:

Должно совпадать с идентификатором существующего кластера баз данных.

--restore-to-time (отметка времени)

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

Допустимые значения: Значение должно быть временем в формате UTC (Всемирное координированное время)

Ограничения:

Должно быть раньше последнего восстанавливаемого времени для экземпляра базы данных
Должно быть указано, если параметр UseLatestRestorableTime не указан
Не может быть указано, если параметр UseLatestRestorableTime имеет значение true
Не может быть указано, если параметр RestoreType имеет значение copy-on-write

Пример: 2015-03-07T23:45:00Z

--use-latest-restorable-time | --no-use-latest-restorable-time (логическое значение)

Значение, установленное в true для восстановления кластера баз данных до последнего восстанавливаемого резервного времени, и false в противном случае.

По умолчанию: false

Ограничения: Не может быть указано, если указан параметр RestoreToTime.

--port (целое число)

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

Ограничения: Значение должно быть 1150-65535

По умолчанию: тот же порт, что и в исходном кластере баз данных.

--db-subnet-group-name (строка)

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

Ограничения: если указано, должно соответствовать имени существующей группы подсетей баз данных.

Пример: mySubnetgroup

--option-group-name (строка)

(Не поддерживается Neptune)

--vpc-security-group-ids (список)

Список групп безопасности VPC, к которым принадлежит новый кластер баз данных.

(строка)

Синтаксис:

"string" "string" ...

--tags (список)

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

(структура)

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

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

Ключ — это требуемое имя тега. Значение строки может быть длиной от 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"
  }
  ...
]

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

Идентификатор ключа Amazon KMS, используемый при восстановлении зашифрованного кластера баз данных из зашифрованного кластера баз данных.

Идентификатор ключа KMS — это Amazon Resource Name (ARN) ключа шифрования KMS. Если вы восстанавливаете кластер баз данных с помощью той же учётной записи Amazon, которая является владельцем ключа шифрования KMS, используемого для шифрования нового кластера баз данных, то вы можете использовать псевдоним ключа KMS вместо ARN ключа шифрования KMS.

Вы можете восстановить в новый кластер баз данных и зашифровать новый кластер баз данных с помощью ключа KMS, отличного от ключа KMS, использованного для шифрования исходного кластера баз данных. Новый кластер баз данных шифруется с помощью ключа KMS, идентифицируемого параметром KmsKeyId.

Если вы не указываете значение для параметра KmsKeyId, то произойдёт следующее:

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

Если DBClusterIdentifier относится к кластеру баз данных, который не зашифрован, то запрос на восстановление отклоняется.

--enable-iam-database-authentication | --no-enable-iam-database-authentication (логическое значение)

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

По умолчанию: false

--enable-cloudwatch-logs-exports (список)

Список журналов, которые должен экспортировать восстановленный кластер баз данных в CloudWatch Logs.

(строка)

Синтаксис:

"string" "string" ...

--db-cluster-parameter-group-name (строка)

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

Ограничения:

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

--deletion-protection | --no-deletion-protection (логическое значение)

Значение, указывающее, включена ли защита от удаления для кластера баз данных. База данных не может быть удалена, если защита от удаления включена. По умолчанию защита от удаления отключена.

--serverless-v2-scaling-configuration (структура)

Содержит конфигурацию масштабирования кластера баз данных Neptune Serverless.

Дополнительную информацию см. в разделе Использование Amazon Neptune Serverless в руководстве пользователя Amazon Neptune.

MinCapacity -> (двойное значение)

Минимальное количество единиц мощности Neptune (NCU) для экземпляра базы данных в кластере Neptune Serverless. Вы можете указывать значения NCU с шагом 0,5, например, 8, 8,5, 9 и так далее.

MaxCapacity -> (двойное значение)

Максимальное количество единиц мощности Neptune (NCU) для экземпляра базы данных в кластере Neptune Serverless. Вы можете указывать значения NCU с шагом 0,5, например, 40, 40,5, 41 и так далее.

Краткая запись:

MinCapacity=double,MaxCapacity=double

Синтаксис JSON:

{
  "MinCapacity": double,
  "MaxCapacity": double
}

--storage-type (строка)

Указывает тип хранилища, который следует ассоциировать с кластером баз данных.

Допустимые значения: standard , iopt1

По умолчанию: standard

--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 версии 1, и бинарные значения должны передаваться буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку fileb:// всегда будет обрабатываться как бинарный и будет использоваться содержимое файла напрямую независимо от настройки cli-binary-format. При использовании file:// содержимое файла должно быть правильно отформатировано для настроенного cli-binary-format.

base64
raw-in-base64-out

--no-cli-pager (boolean)

Отключить вывод кли-пейджера.

--cli-auto-prompt (boolean)

Автоматически запросить параметры ввода CLI.

--no-cli-auto-prompt (boolean)

Отключить автоматический запрос параметров ввода CLI.

Вывод

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

Содержит сведения об кластере Amazon Neptune DB.

Этот тип данных используется в качестве элемента ответа в операции DescribeDBClusters .

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

AllocatedStorage всегда возвращает 1, потому что размер хранилища кластера Neptune DB не фиксирован, а вместо этого автоматически корректируется по мере необходимости.

AvailabilityZones -> (список)

Предоставляет список зон доступности EC2, в которых могут быть созданы экземпляры в кластере DB.

(строка)

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

Указывает количество дней, в течение которых сохраняются автоматические снимки DB.

CharacterSetName -> (строка)

Не поддерживается Neptune.

DatabaseName -> (строка)

Содержит имя начальной базы данных этого кластера DB, предоставленное при создании, если оно было указано при создании кластера DB. Это же имя возвращается на протяжении всего жизненного цикла кластера DB.

DBClusterIdentifier -> (строка)

Содержит предоставленный пользователем идентификатор кластера DB. Этот идентификатор является уникальным ключом, идентифицирующим кластер DB.

DBClusterParameterGroup -> (строка)

Указывает имя группы параметров кластера DB для кластера DB.

DBSubnetGroup -> (строка)

Указывает информацию о группе подсетей, связанной с кластером DB, включая имя, описание и подсети в группе подсетей.

Status -> (строка)

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

PercentProgress -> (строка)

Указывает процент выполнения операции.

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

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

Endpoint -> (строка)

Указывает конечную точку подключения для основного экземпляра кластера DB.

ReaderEndpoint -> (строка)

Конечная точка чтения для кластера DB. Конечная точка чтения для кластера DB распределяет подключения по репликам чтения, доступным в кластере DB. По мере того, как клиенты запрашивают новые подключения к конечной точке чтения, Neptune распределяет запросы на подключение между репликами чтения в кластере DB. Эта функция может помочь сбалансировать вашу нагрузку чтения между несколькими репликами чтения в вашем кластере DB.

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

MultiAZ -> (булево)

Указывает, имеет ли кластер DB экземпляры в нескольких зонах доступности.

Engine -> (строка)

Предоставляет имя используемого для этого кластера DB движка базы данных.

EngineVersion -> (строка)

Указывает версию движка базы данных.

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

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

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

Указывает порт, на котором работает движок базы данных.

MasterUsername -> (строка)

Не поддерживается Neptune.

DBClusterOptionGroupMemberships -> (список)

Не поддерживается Neptune.

(структура)

Не поддерживается Neptune.

DBClusterOptionGroupName -> (строка)

Не поддерживается Neptune.

Status -> (строка)

Не поддерживается Neptune.

PreferredBackupWindow -> (строка)

Указывает диапазон времени в течение суток, в который создаются автоматические резервные копии, если автоматическое создание резервных копий включено, как определяется значением BackupRetentionPeriod .

PreferredMaintenanceWindow -> (строка)

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

ReplicationSourceIdentifier -> (строка)

Не поддерживается Neptune.

ReadReplicaIdentifiers -> (список)

Содержит один или несколько идентификаторов реплик чтения, связанных с этим кластером DB.

(строка)

DBClusterMembers -> (список)

Предоставляет список экземпляров, составляющих кластер DB.

(структура)

Содержит информацию об экземпляре, который является частью кластера DB.

DBInstanceIdentifier -> (строка)

Указывает идентификатор экземпляра для этого члена кластера DB.

IsClusterWriter -> (булево)

Значение, которое true, если член кластера является основным экземпляром для кластера DB, и false в противном случае.

DBClusterParameterGroupStatus -> (строка)

Указывает состояние группы параметров кластера DB для этого члена кластера DB.

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

Значение, которое определяет порядок повышения реплики чтения до основного экземпляра после сбоя существующего основного экземпляра.

VpcSecurityGroups -> (список)

Предоставляет список групп безопасности VPC, к которым принадлежит кластер DB.

(структура)

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

VpcSecurityGroupId -> (строка)

Имя группы безопасности VPC.

Status -> (строка)

Состояние группы безопасности VPC.

HostedZoneId -> (строка)

Указывает ID, назначенный Amazon Route 53 при создании вами размещенной зоны.

StorageEncrypted -> (булево)

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

KmsKeyId -> (строка)

Если StorageEncrypted равно true, идентификатор ключа Amazon KMS для зашифрованного кластера DB.

DbClusterResourceId -> (строка)

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

DBClusterArn -> (строка)

Amazon Resource Name (ARN) для кластера DB.

AssociatedRoles -> (список)

Предоставляет список ролей Amazon Identity and Access Management (IAM), связанных с кластером DB. Роли IAM, связанные с кластером DB, предоставляют разрешения для доступа кластера DB к другим службам Amazon от вашего имени.

(структура)

Описание роли Amazon Identity and Access Management (IAM), связанной с кластером DB.

RoleArn -> (строка)

Amazon Resource Name (ARN) роли IAM, связанной с кластером DB.

Status -> (строка)

Описывает состояние связи между ролью IAM и кластером DB. Свойство Status возвращает одно из следующих значений:

ACTIVE - ARN роли IAM связан с кластером DB и может использоваться для доступа к другим службам Amazon от вашего имени.
PENDING - ARN роли IAM связывается с кластером DB.
INVALID - ARN роли IAM связан с кластером DB, но кластер DB не может принять роль IAM для доступа к другим службам Amazon от вашего имени.

FeatureName -> (строка)

Имя функции, связанной с ролью Amazon Identity and Access Management (IAM). Список поддерживаемых имен функций см. в документации DescribeDBEngineVersions .

IAMDatabaseAuthenticationEnabled -> (булево)

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

CloneGroupId -> (строка)

Идентифицирует группу клонов, к которой связан кластер DB.

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

Указывает время создания кластера DB в формате всемирного координированного времени (UTC).

CopyTagsToSnapshot -> (булево)

Если установлено значение ``true`` , теги копируются в любой созданный снимок кластера DB.

EnabledCloudwatchLogsExports -> (список)

Список типов журналов, которые этот кластер DB настроен экспортировать в CloudWatch Logs. Допустимые типы журналов: audit (для публикации аудиторских журналов в CloudWatch) и slowquery (для публикации журналов медленных запросов в CloudWatch). См. публикацию журналов Neptune в Amazon CloudWatch Logs .

(строка)

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

Этот тип данных используется как элемент ответа в операции ModifyDBCluster и содержит изменения, которые будут применены во время следующего окна технического обслуживания.

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

Эта PendingCloudwatchLogsExports структура определяет ожидающие изменения, в отношении которых включены или отключены журналы CloudWatch.

LogTypesToEnable -> (список)

Типы журналов, которые в процессе отключения. После их отключения эти типы журналов не экспортируются в CloudWatch Logs.

(строка)

LogTypesToDisable -> (список)

Типы журналов, которые в процессе включения. После их включения эти типы журналов экспортируются в CloudWatch Logs.

(строка)

DBClusterIdentifier -> (строка)

Значение DBClusterIdentifier для кластера DB.

IAMDatabaseAuthenticationEnabled -> (булево)

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

EngineVersion -> (строка)

Версия движка базы данных.

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

Количество дней, в течение которых сохраняются автоматические снимки DB.

StorageType -> (строка)

Ожидаемое изменение типа хранилища для кластера DB. Допустимые значения:

**standard ** – ( по умолчанию ) Настраивает экономичное хранилище базы данных для приложений со средней или низкой активностью ввода-вывода.
**iopt1 ** – Включает оптимизированное для ввода-вывода хранилище, которое предназначено для удовлетворения потребностей высокопроизводительных графических рабочих нагрузок, которые требуют предсказуемой стоимости с низкой задержкой ввода-вывода и постоянной пропускной способностью ввода-вывода. Оптимизированное для ввода-вывода хранилище Neptune доступно только начиная с версии движка 1.3.0.0.

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

Размер выделенного хранилища в гигабайтах (GiB) для движков базы данных. Для Neptune AllocatedStorage всегда возвращает 1, потому что размер хранилища кластера Neptune DB не фиксирован, а вместо этого автоматически корректируется по мере необходимости.

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

Значение Provisioned IOPS (операции ввода-вывода в секунду). Это значение используется только для кластеров DB с Multi-AZ.

DeletionProtection -> (булево)

Указывает, включена ли защита от удаления для кластера DB. База данных не может быть удалена, когда защита от удаления включена.

CrossAccountClone -> (булево)

Если установлено значение true, кластер DB можно клонировать между учетными записями.

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

Время, в которое кластер DB будет автоматически перезапущен.

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

Показывает конфигурацию масштабирования кластера серверного БД Neptune.

Дополнительную информацию см. в разделе Использование Amazon Neptune Serverless в руководстве пользователя Amazon Neptune.

MinCapacity -> (double)

Минимальное количество единиц емкости Neptune (NCU) для экземпляра БД в кластере серверной БД Neptune. Вы можете задавать значения NCU с шагом в половину, например, 8, 8,5, 9 и т. д.

MaxCapacity -> (double)

Максимальное количество единиц емкости Neptune (NCU) для экземпляра БД в кластере серверной БД Neptune. Вы можете задавать значения NCU с шагом в половину, например, 40, 40,5, 41 и т. д.

GlobalClusterIdentifier -> (string)

Содержит предоставленный пользователем идентификатор глобального кластера базы данных. Этот идентификатор — уникальный ключ, определяющий глобальную базу данных.

IOOptimizedNextAllowedModificationTime -> (timestamp)

Следующее время, когда вы можете изменить кластер БД для использования типа хранения iopt1.

StorageType -> (string)

Тип хранения, используемый кластером БД.

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

**standard ** – (по умолчанию) Обеспечивает экономичное хранение базы данных для приложений с умеренным или низким использованием ввода-вывода.
**iopt1 ** – Включает оптимизированное хранилище ввода-вывода, которое разработано для удовлетворения потребностей интенсивно использующих ввод-вывод рабочих нагрузок графов, требующих предсказуемой цены с низкой задержкой ввода-вывода и постоянной пропускной способностью ввода-вывода. Оптимизированное хранилище ввода-вывода Neptune доступно только начиная с версии движка 1.3.0.0.