create-disk-from-snapshot
Описание
Создаёт диск блочного хранилища из ручного или автоматического снимка диска. Результирующий диск можно подключить к экземпляру Amazon Lightsail в той же зоне доступности (us-east-2a).
Операция create disk from snapshot поддерживает контроль доступа на основе тегов через теги запроса и теги ресурсов, применённые к ресурсу, идентифицируемому disk snapshot name. Для получения дополнительной информации см. руководство для разработчиков Amazon Lightsail.
См. также: Документация API AWS
Синтаксис
create-disk-from-snapshot
--disk-name <value>
[--disk-snapshot-name <value>]
--availability-zone <value>
--size-in-gb <value>
[--tags <value>]
[--add-ons <value>]
[--source-disk-name <value>]
[--restore-date <value>]
[--use-latest-restorable-auto-snapshot | --no-use-latest-restorable-auto-snapshot]
[--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]
Параметры
--disk-name (строка)
my-disk).--disk-snapshot-name (строка)
Имя снимка диска (my-snapshot), из которого создать новый диск хранилища.
Ограничение:
- Этот параметр нельзя задавать вместе с параметром
source disk name. Параметрыdisk snapshot nameиsource disk nameвзаимоисключающие.
--availability-zone (строка)
Зона доступности, в которой вы хотите создать диск (us-east-2a). Выберите ту же зону доступности, что и экземпляр Lightsail, на котором вы хотите создать диск.
Используйте операцию GetRegions для перечисления зон доступности, в которых в настоящее время доступен Lightsail.
--size-in-gb (целое число)
32).--tags (список)
Ключи тегов и необязательные значения, которые нужно добавить к ресурсу при создании.
Используйте действие TagResource для добавления тегов к ресурсу после его создания.
(структура)
Описывает ключ тега и необязательное значение, назначенное ресурсу Amazon Lightsail.
Дополнительную информацию о тегах в Lightsail см. в руководстве для разработчиков Amazon Lightsail.
key -> (строка)
Ключ тега.
Ограничения: ключи тегов принимают максимум 128 символов, цифр, пробелов в UTF-8 или следующих символов: + - = . _ : / @
value -> (строка)
Значение тега.
Ограничения: значения тегов принимают максимум 256 символов, цифр, пробелов в UTF-8 или следующих символов: + - = . _ : / @
Сокращённый синтаксис:
key=string,value=string ...
Синтаксис JSON:
[
{
"key": "string",
"value": "string"
}
...
]
--add-ons (список)
Массив объектов, представляющих дополнения, которые нужно включить для нового диска.
(структура)
Описывает запрос на включение, изменение или отключение дополнения для ресурса Amazon Lightsail.
Примечание
Возможно, потребуется дополнительная плата за включение дополнений. Дополнительную информацию см. на странице ценообразования Lightsail.addOnType -> (строка)
autoSnapshotAddOnRequest -> (структура)
Объект, представляющий дополнительные параметры при включении или изменении дополнения автоматического снимка.
snapshotTimeOfDay -> (строка)
Время в день, когда будет создан автоматический снимок.
Ограничения:
- Должен быть в формате
HH:00и с часовыми интервалами. - Указано в координированном универсальном времени (UTC).
- Снимок будет автоматически создан между указанным временем и в течение 45 минут после него.
stopInstanceOnIdleRequest -> (структура)
Объект, представляющий дополнительные параметры при включении или изменении дополнения StopInstanceOnIdle.
Предупреждение
Этот объект применим только к ресурсам Lightsail для исследований.threshold -> (строка)
duration -> (строка)
Сокращённый синтаксис:
addOnType=string,autoSnapshotAddOnRequest={snapshotTimeOfDay=string},stopInstanceOnIdleRequest={threshold=string,duration=string} ...
Синтаксис JSON:
[
{
"addOnType": "AutoSnapshot"|"StopInstanceOnIdle",
"autoSnapshotAddOnRequest": {
"snapshotTimeOfDay": "string"
},
"stopInstanceOnIdleRequest": {
"threshold": "string",
"duration": "string"
}
}
...
]
--source-disk-name (строка)
Имя исходного диска, из которого был создан исходный автоматический снимок.
Ограничения:
- Этот параметр нельзя задавать вместе с параметром
disk snapshot name. Параметрыsource disk nameиdisk snapshot nameвзаимоисключающие. - Указывайте этот параметр только при создании нового диска из автоматического снимка. Дополнительную информацию см. в руководстве для разработчиков Amazon Lightsail.
--restore-date (строка)
Дата автоматического снимка, который нужно использовать для нового диска. Используйте операцию get auto snapshots для определения дат доступных автоматических снимков.
Ограничения:
- Должен быть указан в формате
YYYY-MM-DD. - Этот параметр нельзя задавать вместе с параметром
use latest restorable auto snapshot. Параметрыrestore dateиuse latest restorable auto snapshotвзаимоисключающие. - Указывайте этот параметр только при создании нового диска из автоматического снимка. Дополнительную информацию см. в руководстве для разработчиков Amazon Lightsail.
--use-latest-restorable-auto-snapshot | --no-use-latest-restorable-auto-snapshot (булево)
Булево значение, указывающее, использовать ли последний доступный автоматический снимок.
Ограничения:
- Этот параметр нельзя задавать вместе с параметром
restore date. Параметрыuse latest restorable auto snapshotиrestore dateвзаимоисключающие. - Указывайте этот параметр только при создании нового диска из автоматического снимка. Дополнительную информацию см. в руководстве для разработчиков Amazon Lightsail.
--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.
Для создания диска из снимка диска
Следующий пример create-disk-from-snapshot создаёт диск блочного хранилища с именем Disk-2 из указанного снимка диска блочного хранилища. Диск создаётся в указанном AWS-регионе и зоне доступности с размером хранилища 32 ГБ.
aws lightsail create-disk-from-snapshot \
--disk-name Disk-2 \
--disk-snapshot-name Disk-1-1566839161 \
--availability-zone us-west-2a \
--size-in-gb 32
Вывод:
{
"operations": [
{
"id": "d42b605d-5ef1-4b4a-8791-7a3e8b66b5e7",
"resourceName": "Disk-2",
"resourceType": "Disk",
"createdAt": 1569624941.471,
"location": {
"availabilityZone": "us-west-2a",
"regionName": "us-west-2"
},
"isTerminal": false,
"operationType": "CreateDiskFromSnapshot",
"status": "Started",
"statusChangedAt": 1569624941.791
}
]
}
Дополнительную информацию см. в разделе Создание диска блочного хранилища из снимка в Amazon Lightsail в руководстве для разработчиков Lightsail.
Вывод
operations -> (список)
Массив объектов, описывающих результат действия, например, статус запроса, отметка времени запроса и ресурсы, затронутые запросом.
(структура)
Описывает операцию API.
id -> (строка)
resourceName -> (строка)
resourceType -> (строка)
createdAt -> (отметка времени)
1479816991.349).location -> (структура)
Регион и зона доступности Amazon Web Services.
availabilityZone -> (строка)
us-east-2a (регистрозависимо).regionName -> (строка)
isTerminal -> (булево)
operationDetails -> (строка)
Debian-1GB-Ohio-1).operationType -> (строка)
status -> (строка)
statusChangedAt -> (отметка времени)
1479816991.349).errorCode -> (строка)
errorDetails -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.