Spec-Zone.ru › AWS CLI v2

[ aws . rds ]

удалить-снимки-бд

Описание

Удаляет снимок БД. Если снимок копируется, операция копирования завершается.

Примечание

Снимок БД должен быть в состоянии available, чтобы его можно было удалить.

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

Синтаксис

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

Идентификатор снимка БД.

Ограничения: Должен быть именем существующего снимка БД в состоянии available.

--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.

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

Для удаления снимка БД

В следующем delete-db-snapshot примере удаляется указанный снимок БД.

aws rds delete-db-snapshot \
    --db-snapshot-identifier mydbsnapshot

Вывод:

{
    "DBSnapshot": {
        "DBSnapshotIdentifier": "mydbsnapshot",
        "DBInstanceIdentifier": "database-mysql",
        "SnapshotCreateTime": "2019-06-18T22:08:40.702Z",
        "Engine": "mysql",
        "AllocatedStorage": 100,
        "Status": "deleted",
        "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": 100,
        "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 DB.

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

DBSnapshotIdentifier -> (строка)

Указывает идентификатор снимка резервной копии DB.

DBInstanceIdentifier -> (строка)

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

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

Указывает время создания снимка в формате UTC (Координированного универсального времени). Изменяется при копировании снимка.

Engine -> (строка)

Указывает имя СУБД.

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

Указывает размер выделенного хранилища в гигабайтах (GiB).

Status -> (строка)

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

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

Указывает порт, на котором работала СУБД в момент создания снимка.

AvailabilityZone -> (строка)

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

VpcId -> (строка)

Предоставляет идентификатор VPC, связанный со снимком резервной копии DB.

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

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

MasterUsername -> (строка)

Предоставляет имя пользователя мастера для снимка резервной копии DB.

EngineVersion -> (строка)

Указывает версию СУБД.

LicenseModel -> (строка)

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

SnapshotType -> (строка)

Предоставляет тип снимка резервной копии DB.

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

Указывает значение Provisioned IOPS (I/O операций в секунду) экземпляра DB в момент создания снимка.

OptionGroupName -> (строка)

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

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

Процент завершенного переноса данных.

SourceRegion -> (строка)

Регион Amazon Web Services, в котором был создан или скопирован снимок резервной копии DB.

SourceDBSnapshotIdentifier -> (строка)

Amazon Resource Name (ARN) снимка резервной копии DB, с которого был скопирован текущий снимок. Имеет значение только при межрегиональном или межаккаунтовом копировании.

StorageType -> (строка)

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

TdeCredentialArn -> (строка)

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

Encrypted -> (булево)

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

KmsKeyId -> (строка)

Если Encrypted имеет значение true, идентификатор ключа Amazon Web Services KMS для зашифрованного снимка резервной копии DB.

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

DBSnapshotArn -> (строка)

Amazon Resource Name (ARN) снимка резервной копии DB.

Timezone -> (строка)

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

IAMDatabaseAuthenticationEnabled -> (булево)

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

ProcessorFeatures -> (список)

Количество ядер процессора и количество потоков на ядро для класса экземпляра DB в момент создания снимка резервной копии.

(структура)

Содержит характеристики процессора класса экземпляра DB.

Для указания количества ядер процессора используйте имя функции coreCount для параметра Name. Для указания количества потоков на ядро используйте имя функции threadsPerCore для параметра Name.

Вы можете настроить характеристики процессора класса экземпляра DB для экземпляра DB, вызвав одно из следующих действий:

  • CreateDBInstance
  • ModifyDBInstance
  • RestoreDBInstanceFromDBSnapshot
  • RestoreDBInstanceFromS3
  • RestoreDBInstanceToPointInTime

Вы можете просмотреть допустимые значения процессора для определенного класса экземпляра, вызвав действие DescribeOrderableDBInstanceOptions и указав класс экземпляра для параметра DBInstanceClass.

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

  • DescribeDBInstances
  • DescribeDBSnapshots
  • DescribeValidDBInstanceModifications

Если вы вызываете DescribeDBInstances, ProcessorFeature возвращает ненулевые значения только при соблюдении следующих условий:

  • Вы обращаетесь к экземпляру Oracle DB.
  • Ваш класс экземпляра Oracle DB поддерживает настройку количества ядер процессора и потоков на ядро.
  • Текущее количество ядер процессора и потоков установлено не по умолчанию.

Дополнительную информацию см. в разделе Настройка процессора для класса экземпляра DB в RDS для Oracle в руководстве пользователя Amazon RDS.

Name -> (строка)

Имя характеристики процессора. Допустимые имена — coreCount и threadsPerCore.

Value -> (строка)

Значение характеристики процессора.

DbiResourceId -> (строка)

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

TagList -> (список)

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

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

(структура)

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

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

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}_.:/=+\-@]*)$”).

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

Указывает время операции CreateDBSnapshot в формате UTC (Координированного универсального времени). Не изменяется при копировании снимка.

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

Маркер времени последней транзакции, примененной к базе данных, которую вы резервируете. Таким образом, при восстановлении снимка SnapshotDatabaseTime — это последняя транзакция в восстановленном экземпляре DB. В отличие от этого, originalSnapshotCreateTime — это системное время завершения создания снимка.

Если вы резервируете копию реплики чтения, вы можете определить задержку репликации, сравнив SnapshotDatabaseTime и originalSnapshotCreateTime. Например, если originalSnapshotCreateTime на два часа позже SnapshotDatabaseTime, то задержка репликации составляет два часа.

SnapshotTarget -> (строка)

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

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

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

DBSystemId -> (строка)

Идентификатор Oracle системы (SID), представляющий собой имя экземпляра базы данных Oracle, управляющего файлами вашей базы данных. SID Oracle также является именем вашей CDB.

DedicatedLogVolume -> (булево)

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

MultiTenant -> (булево)

Указывает, является ли снимок снимка экземпляра DB с многопользовательской конфигурацией (TRUE) или с однопользовательской конфигурацией (FALSE).

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

Spec-Zone.ru

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