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

Описание

Создаёт новый кластер баз данных из снимка базы данных или снимка кластера баз данных.

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

Примечание

Данная операция восстанавливает только кластер баз данных, а не экземпляры баз данных для этого кластера. Вы должны вызвать операцию CreateDBInstance для создания экземпляров баз данных для восстановленного кластера баз данных, указав идентификатор восстановленного кластера баз данных в DBClusterIdentifier . Вы можете создать экземпляры баз данных только после завершения операции RestoreDBClusterFromSnapshot и готовности кластера баз данных.

Для получения дополнительной информации о кластерах баз данных Amazon Aurora см. Раздел Что такое Amazon Aurora? в Руководстве пользователя Amazon Aurora.

Для получения дополнительной информации о кластерах баз данных Multi-AZ см. Раздел Развёртывание кластеров баз данных Multi-AZ в Руководстве пользователя Amazon RDS.

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

Синтаксис

  restore-db-cluster-from-snapshot
[--availability-zones <value>]
--db-cluster-identifier <value>
--snapshot-identifier <value>
--engine <value>
[--engine-version <value>]
[--port <value>]
[--db-subnet-group-name <value>]
[--database-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]
[--backtrack-window <value>]
[--enable-cloudwatch-logs-exports <value>]
[--engine-mode <value>]
[--scaling-configuration <value>]
[--db-cluster-parameter-group-name <value>]
[--deletion-protection | --no-deletion-protection]
[--copy-tags-to-snapshot | --no-copy-tags-to-snapshot]
[--domain <value>]
[--domain-iam-role-name <value>]
[--db-cluster-instance-class <value>]
[--storage-type <value>]
[--iops <value>]
[--publicly-accessible | --no-publicly-accessible]
[--serverless-v2-scaling-configuration <value>]
[--network-type <value>]
[--rds-custom-cluster-configuration <value>]
[--monitoring-interval <value>]
[--monitoring-role-arn <value>]
[--enable-performance-insights | --no-enable-performance-insights]
[--performance-insights-kms-key-id <value>]
[--performance-insights-retention-period <value>]
[--engine-lifecycle-support <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]

Параметры

--availability-zones (список)

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

Допустимо для: только кластеров баз данных Aurora

(строка)

Синтаксис:

"string" "string" ...

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

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

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

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

Пример: my-snapshot-id

Допустимо для: кластеров баз данных Aurora и кластеров баз данных Multi-AZ

--snapshot-identifier (строка)

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

Вы можете использовать либо имя, либо Amazon Resource Name (ARN) для указания снимка кластера баз данных. Однако вы можете использовать только ARN для указания снимка базы данных.

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

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

Допустимо для: кластеров баз данных Aurora и кластеров баз данных Multi-AZ

--engine (строка)

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

По умолчанию: такой же, как у источника

Ограничение: должен быть совместим с движком источника

Допустимо для: кластеров баз данных Aurora и кластеров баз данных Multi-AZ

--engine-version (строка)

Версия движка базы данных для использования в новом кластере баз данных. Если вы не укажете версию движка, используется версия по умолчанию для движка базы данных в регионе Amazon Web Services.

Чтобы перечислить все доступные версии движков для Aurora MySQL, используйте следующую команду:

aws rds describe-db-engine-versions --engine aurora-mysql --query "DBEngineVersions[].EngineVersion"

Чтобы перечислить все доступные версии движков для Aurora PostgreSQL, используйте следующую команду:

aws rds describe-db-engine-versions --engine aurora-postgresql --query "DBEngineVersions[].EngineVersion"

Чтобы перечислить все доступные версии движков для RDS для MySQL, используйте следующую команду:

aws rds describe-db-engine-versions --engine mysql --query "DBEngineVersions[].EngineVersion"

Чтобы перечислить все доступные версии движков для RDS для PostgreSQL, используйте следующую команду:

aws rds describe-db-engine-versions --engine postgres --query "DBEngineVersions[].EngineVersion"

Aurora MySQL

См. Обновления движков баз данных для Amazon Aurora MySQL в Руководстве пользователя Amazon Aurora.

Aurora PostgreSQL

См. Выпуска и версии движков Amazon Aurora PostgreSQL в Руководстве пользователя Amazon Aurora.

MySQL

См. Amazon RDS для MySQL в Руководстве пользователя Amazon RDS.

PostgreSQL

См. Версии и расширения Amazon RDS для PostgreSQL в Руководстве пользователя Amazon RDS.

Допустимо для: кластеров баз данных Aurora и кластеров баз данных Multi-AZ

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

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

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

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

Допустимо для: кластеров баз данных Aurora и кластеров баз данных Multi-AZ

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

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

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

Пример: mydbsubnetgroup

Допустимо для: кластеров баз данных Aurora и кластеров баз данных Multi-AZ

--database-name (строка)

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

Допустимо для: кластеров баз данных Aurora и кластеров баз данных Multi-AZ

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

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

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

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

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

Допустимо для: кластеров баз данных Aurora и кластеров баз данных Multi-AZ

(строка)

Синтаксис:

"string" "string" ...

--tags (список)

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

Допустимо для: кластеров баз данных Aurora и кластеров баз данных Multi-AZ

(структура)

Метаданные, назначенные ресурсу 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"
  }
  ...
]

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

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

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

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

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

Допустимо для: кластеров баз данных Aurora и кластеров баз данных Multi-AZ

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

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

Для получения дополнительной информации см. IAM-аутентификация для баз данных в Руководстве пользователя Amazon Aurora или IAM-аутентификацию для баз данных MariaDB, MySQL и PostgreSQL в Руководстве пользователя Amazon RDS.

Допустимо для: кластеров баз данных Aurora и кластеров баз данных Multi-AZ

--backtrack-window (целое число)

Целевой интервал возврата, в секундах. Для отключения возврата установите это значение в 0.

Примечание

В настоящее время функция «Возврат» поддерживается только для кластеров баз данных Aurora MySQL.

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

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

Если указано, это значение должно быть от 0 до 259 200 (72 часов).

Допустимо для: только кластеров баз данных Aurora

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

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

RDS для MySQL

Возможные значения — error , general , slowquery и iam-db-auth-error .

RDS для PostgreSQL

Возможные значения — postgresql , upgrade и iam-db-auth-error .

Aurora MySQL

Возможные значения — audit , error , general , instance , slowquery и iam-db-auth-error .

Aurora PostgreSQL

Возможные значения — instance , postgresql и iam-db-auth-error .

Дополнительные сведения об экспорте журналов CloudWatch Logs для Amazon RDS см. в Руководстве пользователя Amazon RDS.

Дополнительные сведения об экспорте журналов CloudWatch Logs для Amazon Aurora см. в Руководстве пользователя Amazon Aurora.

Допустимо для: кластеров баз данных Aurora и кластеров баз данных Multi-AZ

(строка)

Синтаксис:

"string" "string" ...

--engine-mode (строка)

Режим движка базы данных кластера баз данных, либо provisioned, либо serverless.

Дополнительные сведения см. в CreateDBCluster.

Допустимо для: только кластеров баз данных Aurora

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

Для кластеров БД в режиме serverless движка БД, свойства масштабирования кластера БД.

Применимо к: только кластерам БД Aurora

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

Минимальная емкость для кластера БД Aurora в режиме serverless движка БД.

Для Aurora MySQL, допустимые значения емкости являются 1 , 2 , 4 , 8 , 16 , 32 , 64 , 128 и 256 .

Для Aurora PostgreSQL, допустимые значения емкости являются 2 , 4 , 8 , 16 , 32 , 64 , 192 и 384 .

Минимальная емкость должна быть меньше или равна максимальной емкости.

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

Максимальная емкость для кластера БД Aurora в режиме serverless движка БД.

Для Aurora MySQL, допустимые значения емкости являются 1 , 2 , 4 , 8 , 16 , 32 , 64 , 128 и 256 .

Для Aurora PostgreSQL, допустимые значения емкости являются 2 , 4 , 8 , 16 , 32 , 64 , 192 и 384 .

Максимальная емкость должна быть больше или равна минимальной емкости.

AutoPause -> (логическое значение)

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

Примечание

Если кластер БД приостановлен более семи дней, кластер БД может быть резервным с помощью снимка. В этом случае кластер БД восстанавливается при запросе подключения к нему.

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

Время в секундах, до приостановления кластера БД Aurora в режиме serverless.

Укажите значение от 300 до 86400 секунд.

TimeoutAction -> (строка)

Действие, выполняемое при достижении таймаута, либо ForceApplyCapacityChange , либо RollbackCapacityChange .

ForceApplyCapacityChange устанавливает емкость до заданного значения как можно скорее.

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

Предупреждение

Если вы укажете ForceApplyCapacityChange , подключения, которые препятствуют Aurora Serverless v1 от поиска точки масштабирования, могут быть прерваны.

Для получения дополнительной информации см. Автомасштабирование для Aurora Serverless v1 в Руководстве пользователя Amazon Aurora .

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

Количество времени в секундах, в течение которого Aurora Serverless v1 пытается найти точку масштабирования для бесшовного масштабирования перед применением действия таймаута. По умолчанию 300.

Укажите значение от 60 до 600 секунд.

Сокращенная синтаксис:

MinCapacity=integer,MaxCapacity=integer,AutoPause=boolean,SecondsUntilAutoPause=integer,TimeoutAction=string,SecondsBeforeTimeout=integer

Синтаксис JSON:

{
  "MinCapacity": integer,
  "MaxCapacity": integer,
  "AutoPause": true|false,
  "SecondsUntilAutoPause": integer,
  "TimeoutAction": "string",
  "SecondsBeforeTimeout": integer
}

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

Имя группы параметров кластера БД, которую нужно ассоциировать с этим кластером БД. Если этот аргумент опущен, используется группа параметров кластера БД по умолчанию для указанного движка.

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

При указании должно совпадать с именем существующей группы параметров кластера БД по умолчанию.
Должно содержать от 1 до 255 букв, цифр или дефисов.
Первый символ должен быть буквой.
Не может оканчиваться на дефис или содержать два дефиса подряд.

Применимо к: кластерам БД Aurora и многозонным кластерам БД

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

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

Применимо к: кластерам БД Aurora и многозонным кластерам БД

--copy-tags-to-snapshot | --no-copy-tags-to-snapshot (логическое значение)

Указывает, копировать ли все теги из восстановленного кластера БД в снимки восстановленного кластера БД. По умолчанию не копировать.

Применимо к: кластерам БД Aurora и многозонным кластерам БД

--domain (строка)

Идентификатор каталога Active Directory, в котором нужно восстановить кластер БД. Домен должен быть создан до выполнения этой операции. В настоящее время экземпляры БД MySQL, Microsoft SQL Server, Oracle и PostgreSQL могут быть созданы в домене Active Directory.

Для получения дополнительной информации см. Аутентификацию Kerberos в Руководстве пользователя Amazon RDS .

Применимо к: только кластерам БД Aurora

--domain-iam-role-name (строка)

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

Применимо к: только кластерам БД Aurora

--db-cluster-instance-class (строка)

Вычислительная и емкость памяти каждого экземпляра БД в многозонном кластере БД, например db.m6gd.xlarge. Не все классы экземпляров БД доступны во всех регионах Amazon Web Services или для всех движков баз данных.

Полный список классов экземпляров БД и доступность для вашего движка см. в Руководстве пользователя Amazon RDS Класс экземпляра БД.

Применимо к: только многозонным кластерам БД

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

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

При указании для многозонного кластера БД требуется значение параметра Iops.

Допустимые значения: aurora , aurora-iopt1 (кластеры БД Aurora); io1 (многозонные кластеры БД)

По умолчанию: aurora (кластеры БД Aurora); io1 (многозонные кластеры БД)

Применимо к: кластерам БД Aurora и многозонным кластерам БД

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

Количество Provisioned IOPS (операций ввода/вывода в секунду), которые должны быть выделены по умолчанию для каждого экземпляра БД в многозонном кластере БД.

Справочную информацию о допустимых значениях IOPS см. в Руководстве пользователя Amazon RDS Amazon RDS Provisioned IOPS storage.

Ограничения: должно быть кратным .5 и 50 от размера хранилища для экземпляра БД.

Применимо к: кластерам БД Aurora и многозонным кластерам БД

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

Указывает, доступен ли кластер БД через Интернет.

Когда кластер БД доступен через Интернет, его DNS-адрес разрешается до частного IP-адреса изнутри виртуальной частной сети (VPC) кластера БД. Он разрешается до общедоступного IP-адреса снаружи VPC кластера БД. Доступ к кластеру БД в конечном счете контролируется используемой им группой безопасности. Этот общедоступный доступ не разрешен, если группа безопасности, назначенная кластеру БД, его не разрешает.

Когда кластер БД недоступен через Интернет, это внутренний кластер БД с DNS-именем, которое разрешается до частного IP-адреса.

По умолчанию: поведение по умолчанию зависит от того, указан ли параметр DBSubnetGroupName.

Если DBSubnetGroupName не указан, и PubliclyAccessible не указан, применяется следующее:

Если в целевом регионе по умолчанию VPC не подключена к интернет-шлюзу, кластер БД является частным.
Если в целевом регионе по умолчанию VPC подключена к интернет-шлюзу, кластер БД является общедоступным.

Если DBSubnetGroupName указан, и PubliclyAccessible не указан, применяется следующее:

Если подсети являются частью VPC, к которой не подключен интернет-шлюз, кластер БД является частным.
Если подсети являются частью VPC, к которой подключен интернет-шлюз, кластер БД является общедоступным.

Применимо к: кластерам БД Aurora и многозонным кластерам БД

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

Содержит конфигурацию масштабирования кластера БД Aurora Serverless v2.

Для получения дополнительной информации см. Использование Amazon Aurora Serverless v2 в Руководстве пользователя Amazon Aurora .

MinCapacity -> (двойное)

Минимальное количество единиц емкости Aurora (ACU) для экземпляра БД в кластере Aurora Serverless v2. Вы можете указывать значения ACU с шагом 0,5, например 8, 8,5, 9 и т.д. Для версий Aurora, поддерживающих функцию автоматического приостановления Aurora Serverless v2, наименьшее значение, которое вы можете использовать, равно 0. Для версий, которые не поддерживают функцию автоматического приостановления Aurora Serverless v2, наименьшее значение, которое вы можете использовать, равно 0,5.

MaxCapacity -> (двойное)

Максимальное количество единиц емкости Aurora (ACU) для экземпляра БД в кластере Aurora Serverless v2. Вы можете указывать значения ACU с шагом 0,5, например 32, 32,5, 33 и т.д. Наибольшее значение, которое вы можете использовать, равно 256 для последних версий Aurora или 128 для более старых версий.

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

Указывает количество секунд, в течение которых экземпляр БД Aurora Serverless v2 должен быть неактивным, прежде чем Aurora попытается автоматически приостановить его.

Укажите значение от 300 секунд (пять минут) до 86400 секунд (один день). По умолчанию 300 секунд.

Сокращенная синтаксис:

MinCapacity=double,MaxCapacity=double,SecondsUntilAutoPause=integer

Синтаксис JSON:

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

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

Тип сети кластера БД.

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

IPV4
DUAL

Тип сети определяется по DBSubnetGroup , указанному для кластера БД. DBSubnetGroup может поддерживать только протокол IPv4 или протоколы IPv4 и IPv6 (DUAL).

Для получения дополнительной информации см. Работа с экземпляром БД в VPC в Руководстве пользователя Amazon Aurora.

Применимо к: только кластерам БД Aurora

--rds-custom-cluster-configuration (структура)

Зарезервировано для будущего использования.

InterconnectSubnetId -> (строка)

Зарезервировано для будущего использования.

TransitGatewayMulticastDomainId -> (строка)

Зарезервировано для будущего использования.

ReplicaMode -> (строка)

Зарезервировано для будущего использования.

Сокращенная синтаксис:

InterconnectSubnetId=string,TransitGatewayMulticastDomainId=string,ReplicaMode=string

Синтаксис JSON:

{
  "InterconnectSubnetId": "string",
  "TransitGatewayMulticastDomainId": "string",
  "ReplicaMode": "open-read-only"|"mounted"
}

--monitoring-interval (целое число)

Интервал в секундах между точками, когда метрики отслеживания производительности (Enhanced Monitoring) собираются для кластера БД. Чтобы отключить сбор метрик Enhanced Monitoring, укажите 0.

Если указано MonitoringRoleArn, также установите MonitoringInterval на значение, отличное от 0.

Допустимые значения: 0 | 1 | 5 | 10 | 15 | 30 | 60

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

--monitoring-role-arn (строка)

Amazon Resource Name (ARN) для роли IAM, которая разрешает RDS отправлять метрики Enhanced Monitoring в Amazon CloudWatch Logs. Пример: arn:aws:iam:123456789012:role/emaccess.

Если MonitoringInterval установлено на значение, отличное от 0, укажите значение MonitoringRoleArn.

--enable-performance-insights | --no-enable-performance-insights (булево)

Указывает, включить ли Performance Insights для кластера БД.

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

Идентификатор ключа KMS Amazon Web Services для шифрования данных Performance Insights.

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

Если вы не укажете значение для PerformanceInsightsKMSKeyId, Amazon RDS использует ваш ключ KMS по умолчанию. Для вашей учетной записи Amazon Web Services существует ключ KMS по умолчанию. У каждой учетной записи Amazon Web Services в каждом регионе Amazon Web Services есть отдельный ключ KMS по умолчанию.

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

Количество дней хранения данных Performance Insights.

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

7
месяц * 31, где месяц — число от 1 до 23. Примеры: 93 (3 месяца * 31), 341 (11 месяцев * 31), 589 (19 месяцев * 31)
731

По умолчанию: 7 дней

Если вы укажете некорректный период хранения, например, 94, Amazon RDS выдаст ошибку.

--engine-lifecycle-support (строка)

Тип жизненного цикла для данного кластера БД.

Примечание

По умолчанию это значение установлено в open-source-rds-extended-support, что подключает ваш кластер БД к Amazon RDS Extended Support. По окончании стандартной поддержки вы можете избежать платы за Extended Support, установив значение в open-source-rds-extended-support-disabled. В этом случае RDS автоматически повысит версию вашего восстановленного кластера БД до более высокой версии движка, если основная версия движка прошла дату окончания стандартной поддержки.

Вы можете использовать это значение, чтобы подключить свой кластер БД к Amazon RDS Extended Support. С RDS Extended Support вы можете запускать выбранную основную версию движка на вашем кластере БД после окончания стандартной поддержки для этой версии движка. Дополнительную информацию см. в следующих разделах:

Amazon Aurora — Amazon RDS Extended Support с Amazon Aurora в руководстве пользователя Amazon Aurora
Amazon RDS — Amazon RDS Extended Support с Amazon RDS в руководстве пользователя Amazon RDS

Допустимо для типа кластера: кластеры БД Aurora и кластеры БД Multi-AZ

Допустимые значения: open-source-rds-extended-support | open-source-rds-extended-support-disabled

По умолчанию: open-source-rds-extended-support

--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
текст
таблица
yaml
yaml-поток

--query (строка)

Запрос JMESPath для фильтрации данных ответа.

--profile (строка)

Использовать определенный профиль из файла учетных данных.

--region (строка)

Использовать указанный регион. Переопределяет настройки конфигурации/окружения.

--version (строка)

Отобразить версию этого инструмента.

--color (строка)

Включить/выключить цветной вывод.

вкл
выкл
авто

--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 в руководстве пользователя AWS CLI.

Если не указано иное, все примеры имеют правила цитирования, аналогичные Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в руководстве пользователя AWS CLI.

Восстановление кластера БД из снимка

Следующий restore-db-cluster-from-snapshot восстанавливает совместимый с PostgreSQL версии 10.7 кластер БД Aurora PostgreSQL из снимка кластера БД под названием test-instance-snapshot.

aws rds restore-db-cluster-from-snapshot \
    --db-cluster-identifier newdbcluster \
    --snapshot-identifier test-instance-snapshot \
    --engine aurora-postgresql \
    --engine-version 10.7

Вывод:

{
    "DBCluster": {
        "AllocatedStorage": 1,
        "AvailabilityZones": [
            "us-west-2c",
            "us-west-2a",
            "us-west-2b"
        ],
        "BackupRetentionPeriod": 7,
        "DatabaseName": "",
        "DBClusterIdentifier": "newdbcluster",
        "DBClusterParameterGroup": "default.aurora-postgresql10",
        "DBSubnetGroup": "default",
        "Status": "creating",
        "Endpoint": "newdbcluster.cluster-############.us-west-2.rds.amazonaws.com",
        "ReaderEndpoint": "newdbcluster.cluster-ro-############.us-west-2.rds.amazonaws.com",
        "MultiAZ": false,
        "Engine": "aurora-postgresql",
        "EngineVersion": "10.7",
        "Port": 5432,
        "MasterUsername": "postgres",
        "PreferredBackupWindow": "09:33-10:03",
        "PreferredMaintenanceWindow": "sun:12:22-sun:12:52",
        "ReadReplicaIdentifiers": [],
        "DBClusterMembers": [],
        "VpcSecurityGroups": [
            {
                "VpcSecurityGroupId": "sg-########",
                "Status": "active"
            }
        ],
        "HostedZoneId": "Z1PVIF0EXAMPLE",
        "StorageEncrypted": true,
        "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/287364e4-33e3-4755-a3b0-a1b2c3d4e5f6",
        "DbClusterResourceId": "cluster-5DSB5IFQDDUVAWOUWM1EXAMPLE",
        "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:newdbcluster",
        "AssociatedRoles": [],
        "IAMDatabaseAuthenticationEnabled": false,
        "ClusterCreateTime": "2020-06-05T15:06:58.634Z",
        "EngineMode": "provisioned",
        "DeletionProtection": false,
        "HttpEndpointEnabled": false,
        "CopyTagsToSnapshot": false,
        "CrossAccountClone": false,
        "DomainMemberships": []
    }
}

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

Вывод

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

Содержит подробности о кластере баз данных Amazon Aurora или кластере баз данных Multi-AZ.

Для кластера баз данных Amazon Aurora этот тип данных используется в качестве элемента ответа в операциях CreateDBCluster , DeleteDBCluster , DescribeDBClusters , FailoverDBCluster , ModifyDBCluster , PromoteReadReplicaDBCluster , RestoreDBClusterFromS3 , RestoreDBClusterFromSnapshot , RestoreDBClusterToPointInTime , StartDBCluster и StopDBCluster .

Для кластера баз данных Multi-AZ этот тип данных используется в качестве элемента ответа в операциях CreateDBCluster , DeleteDBCluster , DescribeDBClusters , FailoverDBCluster , ModifyDBCluster , RebootDBCluster , RestoreDBClusterFromSnapshot и RestoreDBClusterToPointInTime .

Дополнительную информацию о кластерах баз данных Amazon Aurora см. в разделе Что такое Amazon Aurora? в Руководстве пользователя Amazon Aurora.

Дополнительную информацию о кластерах баз данных Multi-AZ см. в разделе Развертывания Multi-AZ с двумя читаемыми резервными экземплярами баз данных в Руководстве пользователя Amazon RDS.

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

AllocatedStorage указывает размер выделенного хранилища в гигабайтах (GiB). Для Aurora, AllocatedStorage может изменяться, так как размер хранилища кластера баз данных Aurora изменяется по мере необходимости.

AvailabilityZones -> (список)

Список зон доступности (AZ), в которых можно создавать экземпляры в кластере баз данных.

(строка)

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

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

CharacterSetName -> (строка)

Если присутствует, указывает имя набора символов, с которым связан этот кластер.

DatabaseName -> (строка)

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

DBClusterIdentifier -> (строка)

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

DBClusterParameterGroup -> (строка)

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

DBSubnetGroup -> (строка)

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

Status -> (строка)

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

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

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

PercentProgress -> (строка)

Прогресс операции в процентах.

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

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

Endpoint -> (строка)

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

ReaderEndpoint -> (строка)

Точка подключения для чтения для кластера баз данных. Точка подключения для чтения для кластера баз данных распределяет соединения по Aurora Replicas, доступным в кластере баз данных. По мере того как клиенты запрашивают новые соединения с точкой подключения для чтения, Aurora распределяет запросы на соединение между Aurora Replicas в кластере баз данных. Это может помочь сбалансировать вашу рабочую нагрузку для чтения по нескольким Aurora Replicas в вашем кластере баз данных.

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

CustomEndpoints -> (список)

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

(строка)

MultiAZ -> (булево)

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

Engine -> (строка)

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

EngineVersion -> (строка)

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

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

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

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

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

MasterUsername -> (строка)

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

DBClusterOptionGroupMemberships -> (список)

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

(структура)

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

DBClusterOptionGroupName -> (строка)

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

Status -> (строка)

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

PreferredBackupWindow -> (строка)

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

PreferredMaintenanceWindow -> (строка)

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

ReplicationSourceIdentifier -> (строка)

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

ReadReplicaIdentifiers -> (список)

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

(строка)

StatusInfos -> (список)

Зарезервировано для будущего использования.

(структура)

Зарезервировано для будущего использования.

StatusType -> (строка)

Зарезервировано для будущего использования.

Normal -> (булево)

Зарезервировано для будущего использования.

Status -> (строка)

Зарезервировано для будущего использования.

Message -> (строка)

Зарезервировано для будущего использования.

DBClusterMembers -> (список)

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

(структура)

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

DBInstanceIdentifier -> (строка)

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

IsClusterWriter -> (булево)

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

DBClusterParameterGroupStatus -> (строка)

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

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

Значение, определяющее порядок, в котором Aurora Replica повышается до первичного экземпляра после сбоя существующего первичного экземпляра. Дополнительная информация в разделе Избыточность для кластера баз данных Aurora в Руководстве пользователя Amazon Aurora.

VpcSecurityGroups -> (список)

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

(структура)

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

VpcSecurityGroupId -> (строка)

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

Status -> (строка)

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

В настоящее время единственное допустимое состояние — active .

HostedZoneId -> (строка)

Идентификатор, который Amazon Route 53 назначает при создании зоны размещения.

StorageEncrypted -> (булево)

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

KmsKeyId -> (строка)

Если StorageEncrypted включено, идентификатор ключа KMS Amazon Web Services для зашифрованного кластера баз данных.

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

DbClusterResourceId -> (строка)

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

DBClusterArn -> (строка)

Amazon Resource Name (ARN) для кластера баз данных.

AssociatedRoles -> (список)

Список ролей управления доступом и идентификацией Amazon Web Services (IAM), связанных с кластером баз данных. Роли IAM, связанные с кластером баз данных, предоставляют разрешение кластеру баз данных на доступ к другим службам Amazon Web Services от вашего имени.

(структура)

Описание роли управления доступом и идентификацией Amazon Web Services (IAM), связанной с кластером баз данных.

RoleArn -> (строка)

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

Status -> (строка)

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

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

FeatureName -> (строка)

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

IAMDatabaseAuthenticationEnabled -> (булево)

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

CloneGroupId -> (строка)

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

Если вы клонируете кластер баз данных, когда ID равен null, операция заполняет значение ID для исходного кластера и клона, поскольку оба кластера становятся частью одной группы клонирования. Даже если вы удалите клон кластера, ID группы клонирования остается на протяжении всего жизненного цикла исходного кластера, чтобы показать, что он использовался в операции клонирования.

Для PITR ID группы клонирования наследуется от исходного кластера. Для операций восстановления по снимку ID группы клонирования не наследуется от исходного кластера.

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

Время создания кластера баз данных в универсальном координированном времени (UTC).

EarliestBacktrackTime -> (временная метка)

Самое раннее время, к которому может быть обращен кластер баз данных.

BacktrackWindow -> (длинное)

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

BacktrackConsumedChangeRecords -> (длинное)

Количество записей изменений, сохраненных для Backtrack.

EnabledCloudwatchLogsExports -> (список)

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

Типы журналов различаются в зависимости от движка базы данных. Сведения о типах журналов для каждого движка базы данных см. в разделе Файлы журналов базы данных Amazon RDS в Руководстве пользователя Amazon Aurora.

(строка)

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

Текущая ёмкость кластера баз данных Aurora Serverless v1. Ёмкость равна 0 (ноль), когда кластер приостановлен.

Для получения дополнительной информации об Aurora Serverless v1 см. раздел Использование Amazon Aurora Serverless v1 в руководстве Amazon Aurora User Guide.

EngineMode -> (строка)

Режим работы базы данных кластера, либо provisioned, либо serverless.

Для получения дополнительной информации см. CreateDBCluster.

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

Настройка масштабирования для кластера баз данных Aurora в режиме работы serverless.

Для получения дополнительной информации см. Использование Amazon Aurora Serverless v1 в руководстве Amazon Aurora User Guide.

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

Минимальная ёмкость кластера баз данных Aurora в режиме работы serverless.

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

Максимальная ёмкость кластера баз данных Aurora в режиме работы serverless.

AutoPause -> (булево)

Указывает, разрешено ли автоматическое приостановление работы кластера баз данных Aurora в режиме serverless.

Когда значение установлено в false для кластера баз данных Aurora Serverless v1, кластер автоматически возобновляет работу.

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

Оставшееся время в секундах до приостановки работы кластера баз данных Aurora в режиме serverless. Кластер может быть приостановлен только при отсутствии подключений.

TimeoutAction -> (строка)

Действие, которое выполняется, когда Aurora превышает время ожидания при попытке изменить ёмкость кластера Aurora Serverless v1. Значение может быть либо ForceApplyCapacityChange, либо RollbackCapacityChange.

ForceApplyCapacityChange, по умолчанию, устанавливает ёмкость на заданное значение как можно скорее.

RollbackCapacityChange игнорирует изменение ёмкости, если точка масштабирования не найдена в период ожидания.

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

Количество секунд до истечения времени ожидания масштабирования. Что происходит при истечении времени ожидания масштабирования, определяется параметром TimeoutAction.

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

Зарезервировано для будущего использования.

InterconnectSubnetId -> (строка)

Зарезервировано для будущего использования.

TransitGatewayMulticastDomainId -> (строка)

Зарезервировано для будущего использования.

ReplicaMode -> (строка)

Зарезервировано для будущего использования.

DeletionProtection -> (булево)

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

HttpEndpointEnabled -> (булево)

Указывает, включён ли HTTP-точку входа для кластера баз данных Aurora.

При включении HTTP-точка входа предоставляет API веб-службы без подключения (RDS Data API) для выполнения SQL-запросов в кластере баз данных. Вы также можете запросить свою базу данных внутри консоли RDS с помощью редактора запросов RDS.

Для получения дополнительной информации см. Использование RDS Data API в руководстве Amazon Aurora User Guide.

ActivityStreamMode -> (строка)

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

ActivityStreamStatus -> (строка)

Статус потока событий активности базы данных.

ActivityStreamKmsKeyId -> (строка)

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

ActivityStreamKinesisStreamName -> (строка)

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

CopyTagsToSnapshot -> (булево)

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

CrossAccountClone -> (булево)

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

DomainMemberships -> (список)

Записи членства в домене Active Directory, связанные с кластером баз данных.

(структура)

Запись членства в домене Active Directory, связанная с экземпляром или кластером баз данных.

Domain -> (строка)

Идентификатор домена Active Directory.

Status -> (строка)

Статус членства в домене Active Directory для экземпляра или кластера баз данных. Значения включают joined, pending-join, failed и т. д.

FQDN -> (строка)

Полное доменное имя (FQDN) домена Active Directory.

IAMRoleName -> (строка)

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

OU -> (строка)

Организационная единица Active Directory для экземпляра или кластера баз данных.

AuthSecretArn -> (строка)

ARN секрета Secrets Manager с учетными данными пользователя, являющегося членом домена.

DnsIps -> (список)

IP-адреса DNS IPv4 первичных и вторичных контроллеров домена Active Directory.

(строка)

TagList -> (список)

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

Для получения дополнительной информации см. Разметка ресурсов Amazon RDS в руководстве Amazon RDS User Guide или Разметка ресурсов Amazon Aurora и Amazon RDS в руководстве Amazon Aurora User Guide.

(структура)

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

Key -> (строка)

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

Value -> (строка)

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

GlobalWriteForwardingStatus -> (строка)

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

GlobalWriteForwardingRequested -> (булево)

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

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

Информация о ожидаемых изменениях в кластере баз данных. Эта информация возвращается только при наличии ожидаемых изменений. Конкретные изменения определяются подэлементами.

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

Список типов журналов, конфигурация которых все еще ожидается. Другими словами, эти типы журналов находятся в процессе активации или деактивации.

LogTypesToEnable -> (список)

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

(строка)

LogTypesToDisable -> (список)

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

(строка)

DBClusterIdentifier -> (строка)

Значение DBClusterIdentifier для кластера баз данных.

MasterUserPassword -> (строка)

Основные учетные данные для кластера баз данных.

IAMDatabaseAuthenticationEnabled -> (булево)

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

EngineVersion -> (строка)

Версия программного обеспечения базы данных.

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

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

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

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

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

Зарезервировано для будущего использования.

InterconnectSubnetId -> (строка)

Зарезервировано для будущего использования.

TransitGatewayMulticastDomainId -> (строка)

Зарезервировано для будущего использования.

ReplicaMode -> (строка)

Зарезервировано для будущего использования.

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

Значение Provisioned IOPS (операций ввода-вывода в секунду). Этот параметр предназначен только для кластеров баз данных Multi-AZ, не являющихся Aurora.

StorageType -> (строка)

Тип хранилища для кластера баз данных.

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

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

Для получения дополнительной информации см. Использование SSL/TLS для шифрования подключения к экземпляру базы данных в руководстве Amazon RDS User Guide и Использование SSL/TLS для шифрования подключения к кластеру баз данных в руководстве Amazon Aurora User Guide.

CAIdentifier -> (строка)

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

ValidTill -> (временная метка)

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

DBClusterInstanceClass -> (строка)

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

Этот параметр предназначен только для кластеров баз данных Multi-AZ, не являющихся Aurora.

StorageType -> (строка)

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

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

Значение Provisioned IOPS (операций ввода-вывода в секунду).

Этот параметр предназначен только для кластеров баз данных Multi-AZ, не являющихся Aurora.

PubliclyAccessible -> (булево)

Указывает, доступен ли кластер баз данных публично.

Когда кластер баз данных доступен публично и вы подключаетесь извне виртуальной частной сети (VPC) кластера баз данных, его конечная точка DNS отображается на общедоступный IP-адрес. Когда вы подключаетесь изнутри той же VPC, что и кластер баз данных, конечная точка отображается на частный IP-адрес. Доступ к кластеру баз данных в конечном итоге контролируется используемой им группой безопасности. Этот публичный доступ не разрешен, если назначенная кластеру баз данных группа безопасности его не разрешает.

Когда кластер баз данных не доступен публично, это внутренний кластер баз данных с именем DNS, которое отображается на частный IP-адрес.

Для получения дополнительной информации см. CreateDBCluster.

Этот параметр предназначен только для кластеров баз данных Multi-AZ, не являющихся Aurora.

AutoMinorVersionUpgrade -> (булево)

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

Эта настройка предназначена для кластеров баз данных Aurora и кластеров баз данных Multi-AZ.

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

MonitoringInterval -> (integer)

Интервал в секундах между моментами сбора метрик расширенного мониторинга для кластера баз данных.

Эта настройка предназначена только для кластеров баз данных Aurora и кластеров баз данных Multi-AZ.

MonitoringRoleArn -> (string)

ARN для роли IAM, разрешающей RDS отправлять метрики расширенного мониторинга в Amazon CloudWatch Logs.

Эта настройка предназначена только для кластеров баз данных Aurora и кластеров баз данных Multi-AZ.

DatabaseInsightsMode -> (string)

Режим Database Insights, включённый для кластера баз данных.

PerformanceInsightsEnabled -> (boolean)

Указывает, включен ли Performance Insights для кластера баз данных.

Эта настройка предназначена только для кластеров баз данных Aurora и кластеров баз данных Multi-AZ.

PerformanceInsightsKMSKeyId -> (string)

Идентификатор ключа Amazon Web Services KMS для шифрования данных Performance Insights.

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

Эта настройка предназначена только для кластеров баз данных Aurora и кластеров баз данных Multi-AZ.

PerformanceInsightsRetentionPeriod -> (integer)

Количество дней для хранения данных Performance Insights.

Эта настройка предназначена только для кластеров баз данных Aurora и кластеров баз данных Multi-AZ.

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

7
месяц * 31, где месяц — число месяцев от 1 до 23. Примеры: 93 (3 месяца * 31), 341 (11 месяцев * 31), 589 (19 месяцев * 31)
731

По умолчанию: 7 дней

ServerlessV2ScalingConfiguration -> (structure)

Настройка масштабирования для кластера баз данных Aurora Serverless v2.

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

MinCapacity -> (double)

Минимальное количество единиц ёмкости Aurora (ACU) для экземпляра базы данных в кластере Aurora Serverless v2. Вы можете указывать значения ACU с шагом 0,5, например 8, 8,5, 9 и т. д. Для версий Aurora, поддерживающих функцию автоматической приостановки Aurora Serverless v2, минимальное значение составляет 0. Для версий, не поддерживающих функцию автоматической приостановки Aurora Serverless v2, минимальное значение составляет 0,5.

MaxCapacity -> (double)

Максимальное количество единиц ёмкости Aurora (ACU) для экземпляра базы данных в кластере Aurora Serverless v2. Вы можете указывать значения ACU с шагом 0,5, например 32, 32,5, 33 и т. д. Максимальное значение для последних версий Aurora составляет 256 или 128 для более старых версий.

SecondsUntilAutoPause -> (integer)

Количество секунд, в течение которых экземпляр базы данных Aurora Serverless v2 должен быть неактивным, прежде чем Aurora попытается автоматически приостановить его. Этот параметр отображается только при установке минимальной ёмкости кластера в 0 ACU. Изменение минимальной ёмкости на ненулевое значение удаляет этот параметр. Если вы впоследствии измените минимальную ёмкость обратно на 0 ACU, этот параметр будет сброшен до значения по умолчанию, если вы его не укажете.

Это значение колеблется от 300 секунд (пять минут) до 86 400 секунд (один день). По умолчанию — 300 секунд.

NetworkType -> (string)

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

Тип сети определяется значением DBSubnetGroup, указанным для кластера баз данных. DBSubnetGroup может поддерживать только протокол IPv4 или протоколы IPv4 и IPv6 (DUAL).

Дополнительную информацию см. в разделе Работа с экземпляром базы данных во VPC в Руководстве пользователя Amazon Aurora.

Эта настройка предназначена только для кластеров баз данных Aurora.

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

DBSystemId -> (string)

Зарезервировано для будущего использования.

MasterUserSecret -> (structure)

Секрет, управляемый RDS в Amazon Web Services Secrets Manager, для пароля пользователя master.

Дополнительную информацию см. в разделе Управление паролями с помощью Amazon Web Services Secrets Manager в Руководстве пользователя Amazon RDS и Управление паролями с помощью Amazon Web Services Secrets Manager в Руководстве пользователя Amazon Aurora.

SecretArn -> (string)

Amazon Resource Name (ARN) секрета.

SecretStatus -> (string)

Статус секрета.

Возможные значения статуса:

creating — секрет создаётся.
active — секрет доступен для обычного использования и смены.
rotating — секрет меняется.
impaired — секрет может использоваться для доступа к учетным данным базы данных, но его нельзя менять. Секрет может иметь такой статус, например, если права изменены таким образом, что RDS больше не может получить доступ ни к секрету, ни к ключу KMS для секрета. При таком статусе секрета вы можете исправить ситуацию, вызвавшую этот статус. В качестве альтернативы измените экземпляр базы данных, чтобы отключить автоматическое управление учетными данными базы данных, а затем снова измените экземпляр базы данных, чтобы включить автоматическое управление учетными данными базы данных.

KmsKeyId -> (string)

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

IOOptimizedNextAllowedModificationTime -> (timestamp)

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

Эта настройка предназначена только для кластеров баз данных Aurora.

LocalWriteForwardingStatus -> (string)

Указывает, включено ли в кластере Aurora перенаправление записей (write forwarding), не включено, запрошено или включение в процессе.

AwsBackupRecoveryPointArn -> (string)

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

LimitlessDatabase -> (structure)

Подробная информация для Aurora Limitless Database.

Status -> (string)

Статус Aurora Limitless Database.

MinRequiredACU -> (double)

Минимальная необходимая ёмкость Aurora Limitless Database в единицах ёмкости Aurora (ACU).

StorageThroughput -> (integer)

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

Эта настройка предназначена только для кластеров баз данных Multi-AZ, не являющихся кластерами Aurora.

ClusterScalabilityType -> (string)

Режим масштабирования кластера баз данных Aurora. При установке в limitless кластер работает как Aurora Limitless Database. При установке в standard (значение по умолчанию) кластер использует обычное создание экземпляров базы данных.

CertificateDetails -> (structure)

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

Дополнительную информацию см. в разделах Использование SSL/TLS для шифрования подключения к экземпляру базы данных в Руководстве пользователя Amazon RDS и Использование SSL/TLS для шифрования подключения к кластеру баз данных в Руководстве пользователя Amazon Aurora.

CAIdentifier -> (string)

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

ValidTill -> (timestamp)

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

EngineLifecycleSupport -> (string)

Тип жизненного цикла для кластера баз данных.

Дополнительную информацию см. в CreateDBCluster.