восстановление-уровня-снимка

Описание

Восстанавливает архивный снимок Amazon EBS для временного или постоянного использования, или изменяет период восстановления или тип восстановления для снимка, который был ранее временно восстановлен.

Для получения дополнительной информации см. Восстановление архивного снимка и изменение периода восстановления или типа восстановления для временно восстановленного снимка в руководстве пользователя Amazon EBS.

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

Синтаксис

  restore-snapshot-tier
--snapshot-id <value>
[--temporary-restore-days <value>]
[--permanent-restore | --no-permanent-restore]
[--dry-run | --no-dry-run]
[--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]

Параметры

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

--temporary-restore-days (целое число)

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

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

--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-auto-prompt (логическое значение)

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

--no-cli-auto-prompt (логическое значение)

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

Примеры

Пример 1: Постоянное восстановление архивного снимка

Следующий пример постоянно восстанавливает указанный снимок. Укажите --snapshot-id и включите параметр permanent-restore.

aws ec2 restore-snapshot-tier \
    --snapshot-id snap-01234567890abcedf \
    --permanent-restore

Вывод:

{
    "SnapshotId": "snap-01234567890abcedf",
    "IsPermanentRestore": true
}

Для получения дополнительной информации об архивировании снимков см. Архивирование снимков Amazon EBS в руководстве пользователя Amazon EBS.

Пример 2: Временное восстановление архивного снимка

Следующий пример временно восстанавливает указанный снимок. Опустите параметр --permanent-restore. Укажите параметр --snapshot-id и, для temporary-restore-days, укажите количество дней, в течение которых нужно восстановить снимок. temporary-restore-days должен быть указан в днях. Допустимый диапазон — от 1 до 180. Если значение не указано, оно по умолчанию равно 1 дню.

aws ec2 restore-snapshot-tier \
    --snapshot-id snap-01234567890abcedf \
    --temporary-restore-days 5

Вывод:

{
    "SnapshotId": "snap-01234567890abcedf",
    "RestoreDuration": 5,
    "IsPermanentRestore": false
}

Для получения дополнительной информации об архивировании снимков см. Архивирование снимков Amazon EBS в руководстве пользователя Amazon EBS.

Пример 3: Изменение периода восстановления

Следующий пример изменяет период восстановления для указанного снимка на 10 дней.

aws ec2 restore-snapshot-tier \
    --snapshot-id snap-01234567890abcedf
    --temporary-restore-days 10

Вывод:

{
    "SnapshotId": "snap-01234567890abcedf",
    "RestoreDuration": 10,
    "IsPermanentRestore": false
}

Для получения дополнительной информации об архивировании снимков см. Архивирование снимков Amazon EBS в руководстве пользователя Amazon EBS.

Пример 4: Изменение типа восстановления

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

aws ec2 restore-snapshot-tier \
    --snapshot-id snap-01234567890abcedf
    --permanent-restore

Вывод:

{
    "SnapshotId": "snap-01234567890abcedf",
    "IsPermanentRestore": true
}

Для получения дополнительной информации об архивировании снимков см. Архивирование снимков Amazon EBS в руководстве пользователя Amazon EBS.

Вывод

SnapshotId -> (строка)

RestoreStartTime -> (дата и время)

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

IsPermanentRestore -> (логическое значение)