создание-экземпляров-из-снэпшота
Описание
Создает один или несколько новых экземпляров из ручного или автоматического снимка экземпляра.
Операция create instances from snapshot поддерживает контроль доступа на основе тегов через теги запроса и теги ресурсов, примененные к ресурсу, идентифицированному по instance snapshot name . Дополнительную информацию см. в руководстве разработчика Amazon Lightsail.
См. также: Документацию API AWS
Синтаксис
create-instances-from-snapshot
--instance-names <value>
[--attached-disk-mapping <value>]
--availability-zone <value>
[--instance-snapshot-name <value>]
--bundle-id <value>
[--user-data <value>]
[--key-pair-name <value>]
[--tags <value>]
[--add-ons <value>]
[--ip-address-type <value>]
[--source-instance-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]
Параметры
--instance-names (список)
Имена новых экземпляров.
(строка)
Синтаксис:
"string" "string" ...
--attached-disk-mapping (словарь)
Объект, содержащий информацию об одном или нескольких отображениях дисков.
ключ -> (строка)
значение -> (список)
(структура)
Описание отображения диска блочного хранения.
originalDiskPath -> (строка)
/dev/sdh ).newDiskName -> (строка)
my-new-disk ).Сокращенный синтаксис:
KeyName1=[{originalDiskPath=string,newDiskName=string},{originalDiskPath=string,newDiskName=string}],KeyName2=[{originalDiskPath=string,newDiskName=string},{originalDiskPath=string,newDiskName=string}]
Синтаксис JSON:
{"string": [
{
"originalDiskPath": "string",
"newDiskName": "string"
}
...
]
...}
--availability-zone (строка)
us-east-2a (регистрозависимый). Список зон доступности можно получить, используя операцию get regions. Не забудьте добавить параметр include Availability Zones в запрос.--instance-snapshot-name (строка)
Имя снимка экземпляра, на основе которого создаются новые экземпляры. Используйте операцию get instance snapshots для получения информации о существующих снимках.
Ограничение:
- Этот параметр не может быть определен вместе с параметром
source instance name. Параметрыinstance snapshot nameиsource instance nameвзаимоисключающие.
--bundle-id (строка)
micro_x_x ).--user-data (строка)
Можно создать сценарий запуска, который настраивает сервер с дополнительными данными пользователя. Например, apt-get -y update .
Примечание
В зависимости от выбранного образа машины, команда для получения программного обеспечения на вашем экземпляре различается. Amazon Linux и CentOS используютyum , Debian и Ubuntu используют apt-get , а FreeBSD использует pkg . Полный список см. в руководстве разработчика Amazon Lightsail.--key-pair-name (строка)
--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 for Research.threshold -> (строка)
duration -> (строка)
Сокращенный синтаксис:
addOnType=string,autoSnapshotAddOnRequest={snapshotTimeOfDay=string},stopInstanceOnIdleRequest={threshold=string,duration=string} ...
Синтаксис JSON:
[
{
"addOnType": "AutoSnapshot"|"StopInstanceOnIdle",
"autoSnapshotAddOnRequest": {
"snapshotTimeOfDay": "string"
},
"stopInstanceOnIdleRequest": {
"threshold": "string",
"duration": "string"
}
}
...
]
--ip-address-type (строка)
Возможные значения: ipv4 для только IPv4, ipv6 для только IPv6 и dualstack для IPv4 и IPv6.
Значение по умолчанию: dualstack .
Возможные значения:
dualstackipv4ipv6
--source-instance-name (строка)
Ограничения:
- Этот параметр не может быть определен вместе с параметром
instance snapshot name. Параметрыsource instance nameиinstance 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 (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.
--cli-auto-prompt (boolean)
Автоматически запрашивать параметры входных данных CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическое запросы параметров входных данных CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Более подробную информацию см. в руководстве по началу работы в Руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования Unix-подобных систем. Эти примеры необходимо адаптировать к правилам цитирования вашей терминальной среды. См. использование кавычек со строками в Руководстве пользователя AWS CLI.
Для создания экземпляра из моментального снимка
Следующий create-instances-from-snapshot пример создает экземпляр из указанного моментального снимка экземпляра в указанном AWS-регионе и зоне доступности, используя пакет $12 USD.
Примечание: Указанный вами пакет должен быть равным или превосходящим пакет исходного экземпляра, используемого для создания моментального снимка.
aws lightsail create-instances-from-snapshot \
--instance-snapshot-name WordPress-1-1569866208 \
--instance-names WordPress-2 \
--availability-zone us-west-2a \
--bundle-id small_3_0
Вывод:
{
"operations": [
{
"id": "003f8271-b711-464d-b9b8-7f3806cb496e",
"resourceName": "WordPress-2",
"resourceType": "Instance",
"createdAt": 1569865914.908,
"location": {
"availabilityZone": "us-west-2a",
"regionName": "us-west-2"
},
"isTerminal": false,
"operationType": "CreateInstancesFromSnapshot",
"status": "Started",
"statusChangedAt": 1569865914.908
}
]
}
Вывод
operations -> (список)
Массив объектов, описывающих результат действия, такой как статус запроса, метка времени запроса и ресурсы, затронутые запросом.
(структура)
Описывает операцию API.
id -> (строка)
resourceName -> (строка)
resourceType -> (строка)
createdAt -> (метка времени)
1479816991.349).location -> (структура)
AWS-регион и зона доступности.
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.