Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

describe-fast-snapshot-restores

Описание

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

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

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

Синтаксис

  describe-fast-snapshot-restores
[--filters <value>]
[--dry-run | --no-dry-run]
[--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]

Параметры

--filters (список)

Фильтры. Возможные значения:

  • availability-zone : Доступная зона снимка.
  • owner-id : Идентификатор учётной записи Amazon Web Services, которая включила быстрое восстановление моментальных снимков для снимка.
  • snapshot-id : Идентификатор снимка.
  • state : Состояние быстрого восстановления моментального снимка (enabling | optimizing | enabled | disabling | disabled ).

(структура)

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

Если вы указываете несколько фильтров, фильтры объединяются с помощью AND, и запрос возвращает только результаты, соответствующие всем указанным фильтрам.

Дополнительную информацию см. в разделе «Список и фильтрация с помощью командной строки и API» в руководстве Amazon EC2 User Guide .

Name -> (строка)

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

Values -> (список)

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

(строка)

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

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

Синтаксис JSON:

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

--dry-run | --no-dry-run (булево)

Проверяет, имеете ли вы необходимые разрешения для действия, не выполняя сам запрос, и предоставляет ответ об ошибке. Если у вас есть необходимые разрешения, ответ об ошибке — DryRunOperation. В противном случае — UnauthorizedOperation.

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

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

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

Примеры использования см. в разделе «Постраничная навигация» в руководстве AWS Command Line Interface User Guide.

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

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

Примеры использования см. в разделе «Постраничная навигация» в руководстве AWS Command Line Interface User Guide.

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

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

Примеры использования см. в разделе «Постраничная навигация» в руководстве AWS Command Line Interface User Guide.

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

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

  • включено
  • выключено
  • автоматически

--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 (булево)

Автоматический запрос параметров командной строки.

--no-cli-auto-prompt (булево)

Отключение автоматического запроса параметров командной строки.

Примеры

Примечание

Чтобы использовать следующие примеры, необходимо установить и настроить AWS CLI. См. руководство по началу работы в руководстве AWS CLI User Guide для получения дополнительной информации.

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

Для описания быстрых восстановлений моментальных снимков

Следующий пример describe-fast-snapshot-restores отображает подробности всех быстрых восстановлений моментальных снимков со статусом disabled.

aws ec2 describe-fast-snapshot-restores \
    --filters Name=state,Values=disabled

Вывод:

{
    "FastSnapshotRestores": [
        {
            "SnapshotId": "snap-1234567890abcdef0",
            "AvailabilityZone": "us-west-2c",
            "State": "disabled",
            "StateTransitionReason": "Client.UserInitiated - Lifecycle state transition",
            "OwnerId": "123456789012",
            "EnablingTime": "2020-01-25T23:57:49.596Z",
            "OptimizingTime": "2020-01-25T23:58:25.573Z",
            "EnabledTime": "2020-01-25T23:59:29.852Z",
            "DisablingTime": "2020-01-26T00:40:56.069Z",
            "DisabledTime": "2020-01-26T00:41:27.390Z"
        }
    ]
}

Следующий пример describe-fast-snapshot-restores описывает все быстрые восстановления моментальных снимков.

aws ec2 describe-fast-snapshot-restores

Вывод

FastSnapshotRestores -> (список)

Информация о состоянии быстрых восстановлений моментальных снимков.

(структура)

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

SnapshotId -> (строка)

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

AvailabilityZone -> (строка)

Доступная зона.

State -> (строка)

Состояние быстрого восстановления моментального снимка.

StateTransitionReason -> (строка)

Причина перехода состояния. Возможные значения:

  • Client.UserInitiated - Состояние успешно перешло в enabling или disabling.
  • Client.UserInitiated - Lifecycle state transition - Состояние успешно перешло в optimizing, enabled или disabled.

OwnerId -> (строка)

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

OwnerAlias -> (строка)

Псевдоним владельца Amazon Web Services, который включил быстрые восстановления моментальных снимков для снимка. Этот элемент предназначен для использования в будущем.

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

Время, в которое быстрые восстановления моментальных снимков перешли в состояние enabling.

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

Время, в которое быстрые восстановления моментальных снимков перешли в состояние optimizing.

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

Время, в которое быстрые восстановления моментальных снимков перешли в состояние enabled.

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

Время, в которое быстрые восстановления моментальных снимков перешли в состояние disabling.

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

Время, в которое быстрые восстановления моментальных снимков перешли в состояние disabled.

NextToken -> (строка)

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

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

Spec-Zone.ru

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