db-cluster-snapshot-deleted

Описание

Ожидайте, пока длина запроса JMESPath (DBClusterSnapshots) == 0 вернёт True при опросе с помощью describe-db-cluster-snapshots. Будет происходить опрос каждые 30 секунд до достижения успешного состояния. Команда завершится с кодом возврата 255 после 60 неудачных проверок.

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

db-cluster-snapshot-deleted — это постраничная операция. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничность, указав аргумент --no-paginate. При использовании --output text и аргумента --query в постраничном ответе, аргумент --query должен извлекать данные из результатов следующих выражений запроса: DBClusterSnapshots

Синтаксис

  db-cluster-snapshot-deleted
[--db-cluster-identifier <value>]
[--db-cluster-snapshot-identifier <value>]
[--snapshot-type <value>]
[--filters <value>]
[--include-shared | --no-include-shared]
[--include-public | --no-include-public]
[--db-cluster-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-cluster-identifier (строка)

Идентификатор кластера БД для получения списка снимков кластера БД. Этот параметр нельзя использовать совместно с параметром DBClusterSnapshotIdentifier. Этот параметр не чувствителен к регистру.

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

Если указан, должен соответствовать идентификатору существующего DBCluster.

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

Конкретный идентификатор снимка кластера БД для описания. Этот параметр нельзя использовать совместно с параметром DBClusterIdentifier. Это значение хранится как строка в нижнем регистре.

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

Если указан, должен соответствовать идентификатору существующего DBClusterSnapshot.
Если этот идентификатор относится к автоматическому снимку, также должен быть указан параметр SnapshotType.

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

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

automated — Возвращает все снимки кластера БД, которые были автоматически созданы Amazon RDS для моей учётной записи Amazon Web Services.
manual — Возвращает все снимки кластера БД, созданные моей учётной записью Amazon Web Services.
shared — Возвращает все ручные снимки кластера БД, которые были предоставлены в мою учётную запись Amazon Web Services.
public — Возвращает все снимки кластера БД, помеченные как общедоступные.

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

Параметры IncludeShared и IncludePublic не применяются для значений SnapshotType равных manual или automated. Параметр IncludePublic не применяется, когда SnapshotType установлено в shared. Параметр IncludeShared не применяется, когда SnapshotType установлено в public.

--filters (список)

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

Поддерживаемые фильтры:

db-cluster-id — Принимает идентификаторы кластеров БД и Amazon Resource Names (ARN) кластеров БД.
db-cluster-snapshot-id — Принимает идентификаторы снимков кластеров БД.
snapshot-type — Принимает типы снимков кластеров БД.
engine — Принимает имена СУБД.

(структура)

Пара имя-значение фильтра, которая используется для возвращения более конкретного списка результатов из операции describe. Фильтры могут использоваться для сопоставления набора ресурсов по определенным критериям, таким как идентификаторы. Фильтры, поддерживаемые операцией describe, документированы с операцией describe.

Примечание

В настоящее время подстановки символов в фильтрах не поддерживаются.

Следующие действия могут быть отфильтрованы:

DescribeDBClusterBacktracks
DescribeDBClusterEndpoints
DescribeDBClusters
DescribeDBInstances
DescribeDBRecommendations
DescribeDBShardGroups
DescribePendingMaintenanceActions

Имя -> (строка)

Имя фильтра. Имена фильтров чувствительны к регистру.

Значения -> (список)

Одно или несколько значений фильтра. Значения фильтров чувствительны к регистру.

(строка)

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

Name=string,Values=string,string ...

Синтаксис JSON:

[
  {
    "Name": "string",
    "Values": ["string", ...]
  }
  ...
]

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

Указывает, нужно ли включать общие ручные снимки кластера БД из других учётных записей Amazon Web Services, для которых этой учётной записи Amazon Web Services предоставлены разрешения на копирование или восстановление. По умолчанию эти снимки не включаются.

Вы можете предоставить учётной записи Amazon Web Services разрешение на восстановление ручного снимка кластера БД из другой учётной записи Amazon Web Services с помощью API-действия ModifyDBClusterSnapshotAttribute.

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

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

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

--db-cluster-resource-id (строка)

Конкретный идентификатор ресурса кластера БД для описания.

--cli-input-json | --cli-input-yaml (строка) Считывает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, указанному в --generate-cli-skeleton. Если на командной строке предоставлены другие аргументы, эти значения переопределяют значения, предоставленные в JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в JSON, так как строка будет интерпретироваться буквально. Это не может быть указано вместе с --cli-input-yaml.

--starting-token (строка)

Токен для указания места начала постраничного вывода. Это значение NextToken из предыдущего усеченного ответа.

Примеры использования см. в разделе Постраничный вывод в руководстве пользователя AWS Command Line Interface.

--page-size (целое число)

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

Примеры использования см. в разделе Постраничный вывод в руководстве пользователя AWS Command Line Interface.

--max-items (целое число)

Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов превышает указанное значение, в выводе команды предоставляется NextToken. Для возобновления постраничного вывода укажите значение NextToken в аргументе starting-token последующей команды. Не используйте элемент ответа NextToken непосредственно за пределами AWS CLI.

Примеры использования см. в разделе Постраничный вывод в руководстве пользователя AWS Command Line Interface.

--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
table
yaml
yaml-stream

--query (строка)

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

--profile (строка)

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

--region (строка)

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

--version (строка)

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

--color (строка)

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

on
off
auto

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

Вывод

Нет