db-snapshot-deleted
Описание
Ожидайте, пока длина запроса JMESPath (DBSnapshots) == 0 вернёт True при опросе с помощью describe-db-snapshots. Будет происходить опрос каждые 30 секунд до достижения успешного состояния. Выполнение завершится с кодом возврата 255 после 60 неудачных проверок.
См. также: Документацию API AWS
db-snapshot-deleted — это постраничная операция. Для получения всего набора результатов могут быть вызваны несколько API-запросов. Вы можете отключить постраничный вывод, предоставив аргумент --no-paginate. При использовании --output text и аргумента --query с постраничным ответом, аргумент --query должен извлекать данные из результатов следующих выражений запроса: DBSnapshots
Синтаксис
db-snapshot-deleted
[--db-instance-identifier <value>]
[--db-snapshot-identifier <value>]
[--snapshot-type <value>]
[--filters <value>]
[--include-shared | --no-include-shared]
[--include-public | --no-include-public]
[--dbi-resource-id <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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-instance-identifier (строка)
Идентификатор экземпляра БД для получения списка снимков БД. Параметр нечувствителен к регистру.
Ограничения:
- При указании, должен совпадать с идентификатором существующего DBInstance.
--db-snapshot-identifier (строка)
Уникальный идентификатор снимка БД для описания. Это значение хранится как строка в нижнем регистре.
Ограничения:
- При указании, должен совпадать с идентификатором существующего снимка DBSnapshot.
- Если этот идентификатор относится к автоматическому снимку, также должен быть указан параметр
SnapshotType.
--snapshot-type (строка)
Тип снимков, которые нужно вернуть. Вы можете указать одно из следующих значений:
-
automated— Вернуть все снимки БД, автоматически созданные Amazon RDS для моей учетной записи Amazon Web Services. -
manual— Вернуть все снимки БД, созданные моей учетной записью Amazon Web Services. -
shared— Вернуть все ручные снимки БД, которые были предоставлены для использования моей учетной записью Amazon Web Services. -
public— Вернуть все снимки БД, помеченные как публичные. -
awsbackup— Вернуть снимки БД, управляемые службой резервного копирования Amazon Web Services. Для получения информации о службе резервного копирования Amazon Web Services см. руководство разработчика Amazon Web Services Backup https://docs.aws.amazon.com/aws-backup/latest/devguide/whatisbackup.html. Типawsbackupне применяется к Aurora.
Если вы не укажете значение для SnapshotType, то будут возвращены как автоматические, так и ручные снимки. По умолчанию общие и публичные снимки БД не включаются в результаты. Вы можете включить общие снимки в результаты, активировав параметр IncludeShared. Вы можете включить публичные снимки в эти результаты, активировав параметр IncludePublic.
Параметры IncludeShared и IncludePublic не применяются к значениям SnapshotType manual или automated. Параметр IncludePublic не применяется, когда SnapshotType установлено в значение shared. Параметр IncludeShared не применяется, когда SnapshotType установлено в значение public.
--filters (список)
Фильтр, который определяет один или несколько снимков БД для описания.
Поддерживаемые фильтры:
-
db-instance-id— Принимает идентификаторы экземпляров БД и Amazon Resource Names (ARN) экземпляров БД. -
db-snapshot-id— Принимает идентификаторы снимков БД. -
dbi-resource-id— Принимает идентификаторы исходных экземпляров БД. -
snapshot-type— Принимает типы снимков БД. -
engine— Принимает имена баз данных.
(структура)
Пара имя-значение фильтра, используемая для возврата более конкретного списка результатов операции describe. Фильтры могут использоваться для сопоставления набора ресурсов по определённым критериям, таким как идентификаторы. Поддерживаемые фильтры для операции describe документированы вместе с операцией describe.
Примечание
В настоящее время в фильтрах не поддерживаются подстановочные знаки.Следующие действия могут быть отфильтрованы:
DescribeDBClusterBacktracksDescribeDBClusterEndpointsDescribeDBClustersDescribeDBInstancesDescribeDBRecommendationsDescribeDBShardGroupsDescribePendingMaintenanceActions
Имя -> (строка)
Значения -> (список)
Одно или несколько значений фильтра. Значения фильтров чувствительны к регистру.
(строка)
Сокращённый синтаксис:
Name=string,Values=string,string ...
Синтаксис JSON:
[
{
"Name": "string",
"Values": ["string", ...]
}
...
]
--include-shared | --no-include-shared (булево)
Указывает, нужно ли включать общие ручные снимки кластеров БД из других учетных записей Amazon Web Services, которым этой учетной записи предоставлено право копировать или восстанавливать их. По умолчанию эти снимки не включаются.
Вы можете предоставить учетной записи Amazon Web Services право восстановить ручной снимок БД из другой учетной записи Amazon Web Services, используя API-действие ModifyDBSnapshotAttribute.
Это настройка не применяется к RDS Custom.
--include-public | --no-include-public (булево)
Указывает, нужно ли включать ручные снимки кластеров БД, которые являются общедоступными и могут быть скопированы или восстановлены любой учетной записью Amazon Web Services. По умолчанию публичные снимки не включаются.
Вы можете сделать ручной снимок БД общедоступным, используя API-действие ModifyDBSnapshotAttribute.
Это настройка не применяется к RDS Custom.
--dbi-resource-id (строка)
--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, заданному в --generate-cli-skeleton. Если на командной строке указаны другие аргументы, эти значения переопределят значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет взята буквально. Это не может быть указано вместе с --cli-input-yaml.
--starting-token (строка)
Токен для указания начала постраничного вывода. Это NextToken из ранее усечённого ответа.
Примеры использования см. в разделе Постраничный вывод в Руководстве пользователя AWS CLI.
--page-size (целое число)
Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращаемых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить таймаут вызовов AWS-сервиса.
Примеры использования см. в разделе Постраничный вывод в Руководстве пользователя AWS CLI.
--max-items (целое число)
Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды предоставляется NextToken. Для возобновления постраничного вывода укажите значение NextToken в аргументе starting-token последующей команды. **Не** используйте элемент ответа NextToken напрямую вне AWS CLI.
Примеры использования см. в разделе Постраничный вывод в Руководстве пользователя AWS CLI.
--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 V1, и двоичные значения должны передаваться буквально. При предоставлении содержимого из файла, которое соответствует двоичному блоку 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.
Вывод
Нет
© Copyright 2025, Amazon Web Services. Created using Sphinx.