create-db-snapshot
Описание
Создаёт снимок экземпляра БД. Исходный экземпляр БД должен быть в состоянии available или storage-optimization.
См. также: Документацию API AWS
Синтаксис
create-db-snapshot
--db-snapshot-identifier <value>
--db-instance-identifier <value>
[--tags <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-snapshot-identifier (строка)
Идентификатор снимка БД.
Ограничения:
- Не может быть пустым или содержать только пробелы
- Должен содержать от 1 до 255 букв, цифр или дефисов
- Первым символом должна быть буква
- Не может заканчиваться дефисом или содержать два дефиса подряд
Пример: my-snapshot-id
--db-instance-identifier (строка)
Идентификатор экземпляра БД, для которого требуется создать снимок.
Ограничения:
- Должен соответствовать идентификатору существующего экземпляра DBInstance.
--tags (список)
Список тегов.
Дополнительную информацию см. в разделе «Тегирование ресурсов Amazon RDS» в Руководстве пользователя Amazon RDS или в разделе «Тегирование ресурсов Amazon Aurora и Amazon RDS» в Руководстве пользователя Amazon Aurora.
(структура)
Метаданные, назначенные ресурсу Amazon RDS, представляющие собой пару ключ-значение.
Дополнительную информацию см. в разделе «Тегирование ресурсов Amazon RDS» в Руководстве пользователя Amazon RDS или в разделе «Тегирование ресурсов Amazon Aurora и Amazon RDS» в Руководстве пользователя Amazon Aurora.
Ключ -> (строка)
aws: или rds:. Строка может содержать только символы Юникода, цифры, пробелы, «_», «.», «:», «/», «=», «+», «-», «@» (Java regex: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).Значение -> (строка)
aws: или rds:. Строка может содержать только символы Юникода, цифры, пробелы, «_», «.», «:», «/», «=», «+», «-», «@» (Java regex: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).Сокращённый синтаксис:
Key=string,Value=string ...
Синтаксис JSON:
[
{
"Key": "string",
"Value": "string"
}
...
]
--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
- таблица
- 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-auto-prompt (логическое значение)
Автоматически запрашивать параметры ввода для CLI.
--no-cli-auto-prompt (логическое значение)
Отключить автоматическое запросы параметров ввода для CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Дополнительную информацию см. в руководстве «Начало работы» в Руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования в стиле Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей консоли. См. «Использование кавычек со строками» в Руководстве пользователя AWS CLI.
Для создания снимка БД
Следующий create-db-snapshot пример создаёт снимок БД.
aws rds create-db-snapshot \
--db-instance-identifier database-mysql \
--db-snapshot-identifier mydbsnapshot
Вывод:
{
"DBSnapshot": {
"DBSnapshotIdentifier": "mydbsnapshot",
"DBInstanceIdentifier": "database-mysql",
"Engine": "mysql",
"AllocatedStorage": 100,
"Status": "creating",
"Port": 3306,
"AvailabilityZone": "us-east-1b",
"VpcId": "vpc-6594f31c",
"InstanceCreateTime": "2019-04-30T15:45:53.663Z",
"MasterUsername": "admin",
"EngineVersion": "5.6.40",
"LicenseModel": "general-public-license",
"SnapshotType": "manual",
"Iops": 1000,
"OptionGroupName": "default:mysql-5-6",
"PercentProgress": 0,
"StorageType": "io1",
"Encrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE",
"DBSnapshotArn": "arn:aws:rds:us-east-1:123456789012:snapshot:mydbsnapshot",
"IAMDatabaseAuthenticationEnabled": false,
"ProcessorFeatures": [],
"DbiResourceId": "db-AKIAIOSFODNN7EXAMPLE"
}
}
Дополнительную информацию см. в разделе «Создание снимка БД» в Руководстве пользователя Amazon RDS.
Вывод
DBSnapshot -> (структура)
Содержит сведения о снимке резервной копии базы данных Amazon RDS.
Этот тип данных используется в качестве элемента ответа в действии DescribeDBSnapshots.
DBSnapshotIdentifier -> (строка)
DBInstanceIdentifier -> (строка)
SnapshotCreateTime -> (метка времени)
Engine -> (строка)
AllocatedStorage -> (целое число)
Status -> (строка)
Port -> (целое число)
AvailabilityZone -> (строка)
VpcId -> (строка)
InstanceCreateTime -> (метка времени)
MasterUsername -> (строка)
EngineVersion -> (строка)
LicenseModel -> (строка)
SnapshotType -> (строка)
Iops -> (целое число)
OptionGroupName -> (строка)
PercentProgress -> (целое число)
SourceRegion -> (строка)
SourceDBSnapshotIdentifier -> (строка)
StorageType -> (строка)
TdeCredentialArn -> (строка)
Encrypted -> (булево)
KmsKeyId -> (строка)
Если значение Encrypted равно true, то идентификатор ключа шифрования Amazon Web Services KMS для зашифрованного снимка резервной копии.
Идентификатор ключа Amazon Web Services KMS — это ARN ключа, ID ключа, ARN псевдонима или имя псевдонима ключа KMS.
DBSnapshotArn -> (строка)
Timezone -> (строка)
Timezone пустой. Содержимое Timezone появляется только для снимков, созданных из экземпляров базы данных Microsoft SQL Server, созданных с указанным часовым поясом.IAMDatabaseAuthenticationEnabled -> (булево)
ProcessorFeatures -> (список)
Количество ядер процессора и количество потоков на ядро для класса экземпляра базы данных на момент создания снимка.
(структура)
Содержит характеристики процессора класса экземпляра базы данных.
Для указания количества ядер процессора используйте имя атрибута coreCount для параметра Name. Для указания количества потоков на ядро используйте имя атрибута threadsPerCore для параметра Name.
Вы можете настроить характеристики процессора для класса экземпляра базы данных, вызвав одно из следующих действий:
CreateDBInstanceModifyDBInstanceRestoreDBInstanceFromDBSnapshotRestoreDBInstanceFromS3RestoreDBInstanceToPointInTime
Вы можете просмотреть допустимые значения процессора для определенного класса экземпляра, вызвав действие DescribeOrderableDBInstanceOptions и указав класс экземпляра для параметра DBInstanceClass.
Кроме того, для получения информации о процессоре класса экземпляра базы данных можно использовать следующие действия:
DescribeDBInstancesDescribeDBSnapshotsDescribeValidDBInstanceModifications
Если вы вызываете DescribeDBInstances, ProcessorFeature возвращает значения, отличные от null, только если выполнены следующие условия:
- Вы обращаетесь к экземпляру Oracle базы данных.
- Ваш экземпляр Oracle базы данных поддерживает настройку количества ядер процессора и потоков на ядро.
- Текущее количество ядер процессора и потоков на ядро установлено не по умолчанию.
Дополнительная информация приведена в разделе Настройка процессора для класса экземпляра базы данных в RDS для Oracle в руководстве Amazon RDS User Guide.
Name -> (строка)
coreCount и threadsPerCore.Value -> (строка)
DbiResourceId -> (строка)
TagList -> (список)
Список тегов.
Дополнительная информация приведена в разделе Тегирование ресурсов Amazon RDS в руководстве Amazon RDS User Guide или Тегирование ресурсов Amazon Aurora и Amazon RDS в руководстве Amazon Aurora User Guide.
(структура)
Метаданные, присвоенные ресурсу Amazon RDS, представляющие собой пару ключ-значение.
Дополнительная информация приведена в разделе Тегирование ресурсов Amazon RDS в руководстве Amazon RDS User Guide или Тегирование ресурсов Amazon Aurora и Amazon RDS в руководстве Amazon Aurora User Guide.
Key -> (строка)
aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, ‘_’, ‘.’, ‘:’, ‘/’, ‘=’, ‘+’, ‘-’, ‘@’ (регулярное выражение Java: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).Value -> (строка)
aws: или rds:. Строка может содержать только набор символов Юникода, цифр, пробелов, ‘_’, ‘.’, ‘:’, ‘/’, ‘=’, ‘+’, ‘-’, ‘@’ (регулярное выражение Java: “^([\p{L}\p{Z}\p{N}_.:/=+\-@]*)$”).OriginalSnapshotCreateTime -> (метка времени)
SnapshotDatabaseTime -> (метка времени)
Метка времени последней транзакции, применённой к базе данных, которую вы резервируете. Таким образом, при восстановлении снимка SnapshotDatabaseTime — это последняя транзакция в восстановленном экземпляре базы данных. В отличие от этого, originalSnapshotCreateTime указывает системное время завершения создания снимка.
Если вы резервируете реплику чтения, вы можете определить задержку реплики, сравнив SnapshotDatabaseTime и originalSnapshotCreateTime. Например, если originalSnapshotCreateTime на два часа позже SnapshotDatabaseTime, то задержка реплики составляет два часа.
SnapshotTarget -> (строка)
StorageThroughput -> (целое число)
DBSystemId -> (строка)
DedicatedLogVolume -> (булево)
MultiTenant -> (булево)
© Copyright 2025, Amazon Web Services. Created using Sphinx.