import-image
Описание
Примечание
Для импорта виртуальных машин (ВМ) с опытом работы на основе консоли вы можете использовать шаблон Импорт образов виртуальных машин в Amazon Web Services в консоли Migration Hub Orchestrator. Дополнительную информацию см. в руководстве пользователя ` Migration Hub Orchestrator https://docs.aws.amazon.com/migrationhub-orchestrator/latest/userguide/import-vm-images.html`__.Импортируйте образы дисков с одним или несколькими томами или моментальные снимки EBS в Amazon Machine Image (AMI).
Предупреждение
Amazon Web Services VM Import/Export настоятельно рекомендует указать значение для параметра--license-type или --usage-operation при создании новой задачи импорта ВМ. Это гарантирует, что ваша операционная система лицензирована должным образом, а ваш расчет оптимизирован.Дополнительную информацию см. в разделе Импорт ВМ в виде образа с помощью VM Import/Export в руководстве пользователя VM Import/Export .
См. также: Документацию API AWS
Синтаксис
import-image
[--architecture <value>]
[--client-data <value>]
[--client-token <value>]
[--description <value>]
[--disk-containers <value>]
[--dry-run | --no-dry-run]
[--encrypted | --no-encrypted]
[--hypervisor <value>]
[--kms-key-id <value>]
[--license-type <value>]
[--platform <value>]
[--role-name <value>]
[--license-specifications <value>]
[--tag-specifications <value>]
[--usage-operation <value>]
[--boot-mode <value>]
[--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]
Параметры
--architecture (строка)
Архитектура виртуальной машины.
Допустимые значения: i386 | x86_64
--client-data (структура)
Данные, специфичные для клиента.
Комментарий -> (строка)
UploadEnd -> (временная метка)
UploadSize -> (двойное)
UploadStart -> (временная метка)
Сокращенный синтаксис:
Comment=string,UploadEnd=timestamp,UploadSize=double,UploadStart=timestamp
Синтаксис JSON:
{
"Comment": "string",
"UploadEnd": timestamp,
"UploadSize": double,
"UploadStart": timestamp
}
--client-token (строка)
--description (строка)
--disk-containers (список)
Информация о контейнерах дисков.
(структура)
Описание объекта контейнера диска для задачи импорта образа.
Описание -> (строка)
DeviceName -> (строка)
Формат -> (строка)
Формат импортируемого образа диска.
Допустимые значения: OVA | VHD | VHDX | VMDK | RAW
SnapshotId -> (строка)
Url -> (строка)
UserBucket -> (структура)
Ведро S3 для образа диска.
S3Bucket -> (строка)
S3Key -> (строка)
Сокращенный синтаксис:
Description=string,DeviceName=string,Format=string,SnapshotId=string,Url=string,UserBucket={S3Bucket=string,S3Key=string} ...
Синтаксис JSON:
[
{
"Description": "string",
"DeviceName": "string",
"Format": "string",
"SnapshotId": "string",
"Url": "string",
"UserBucket": {
"S3Bucket": "string",
"S3Key": "string"
}
}
...
]
--dry-run | --no-dry-run (булево)
DryRunOperation. В противном случае — UnauthorizedOperation.--encrypted | --no-encrypted (булево)
KmsKeyId. Дополнительную информацию см. в разделе Шифрование Amazon EBS в руководстве пользователя Amazon Elastic Compute Cloud.--hypervisor (строка)
Целевая платформа гипервизора.
Допустимые значения: xen
--kms-key-id (строка)
Идентификатор симметричного ключа KMS, который следует использовать при создании зашифрованного AMI. Этот параметр необходим только в случае использования ключа KMS, отличного от стандартного; если этот параметр не указан, используется стандартный ключ KMS для EBS. Если указан KmsKeyId, флаг Encrypted также должен быть установлен.
Идентификатор ключа KMS может быть предоставлен в любом из следующих форматов:
- Идентификатор ключа
- Псевдоним ключа
- ARN с использованием идентификатора ключа. ARN идентификатора содержит префикс
arn:aws:kms, за которым следует регион ключа, идентификатор учетной записи Amazon Web Services владельца ключа, префиксkeyи, наконец, идентификатор ключа. Например, arn:aws:kms:us-east-1 :012345678910 :key/abcd1234-a123-456a-a12b-a123b4cd56ef . - ARN с использованием псевдонима ключа. ARN псевдонима содержит префикс
arn:aws:kms, за которым следует регион ключа, идентификатор учетной записи Amazon Web Services владельца ключа, префиксaliasи, наконец, псевдоним ключа. Например, arn:aws:kms:us-east-1 :012345678910 :alias/ExampleAlias .
Amazon Web Services анализирует KmsKeyId асинхронно, что означает, что вызываемое действие может завершиться успешно, даже если предоставлен неверный идентификатор. Это действие в конечном итоге сообщит об ошибке.
Указанный ключ KMS должен существовать в регионе, в который копируется AMI.
Ассиметричные ключи KMS не поддерживаются Amazon EBS.
--license-type (строка)
Тип лицензии, который будет использоваться для Amazon Machine Image (AMI) после импорта.
Укажите AWS, чтобы заменить лицензию исходной системы лицензией Amazon Web Services, или BYOL, чтобы сохранить лицензию исходной системы. Оставление этого параметра неопределенным эквивалентно выбору AWS при импорте операционной системы Windows Server и выбору BYOL при импорте операционной системы Windows клиента (например, Windows 10) или операционной системы Linux.
Чтобы использовать BYOL, у вас должны быть существующие лицензии с правами на использование этих лицензий в облаке третьей стороны, например, Amazon Web Services. Дополнительную информацию см. в разделе Требования в руководстве пользователя VM Import/Export.
--platform (строка)
Операционная система виртуальной машины. Если вы импортируете ВМ, совместимую с Unified Extensible Firmware Interface (UEFI), с помощью моментального снимка EBS, вы должны указать значение для платформы.
Допустимые значения: Windows | Linux
--role-name (строка)
--license-specifications (список)
ARN-адреса конфигураций лицензий.
(структура)
Информация о запросе конфигураций лицензий.
LicenseConfigurationArn -> (строка)
Сокращенный синтаксис:
LicenseConfigurationArn=string ...
Синтаксис JSON:
[
{
"LicenseConfigurationArn": "string"
}
...
]
--tag-specifications (список)
Теги, которые следует применить к задаче импорта образа при создании.
(структура)
Теги, которые следует применить к ресурсу при создании. При указании тега необходимо указать тип ресурса, иначе запрос завершится ошибкой.
Примечание
СписокValid Values содержит все типы ресурсов, которые могут быть помечены. Однако используемое действие может не поддерживать все эти типы ресурсов. Если вы попытаетесь пометить ресурс, тип которого не поддерживается используемым действием, вы получите ошибку.ResourceType -> (строка)
Tags -> (список)
Теги, которые нужно применить к ресурсу.
(структура)
Описание тега.
Key -> (строка)
Ключ тега.
Ограничения: ключи тегов чувствительны к регистру и принимают максимум 127 символов Unicode. Не могут начинаться с aws:.
Value -> (строка)
Значение тега.
Ограничения: значения тегов чувствительны к регистру и принимают максимум 256 символов Unicode.
Сокращенный синтаксис:
ResourceType=string,Tags=[{Key=string,Value=string},{Key=string,Value=string}] ...
Синтаксис JSON:
[
{
"ResourceType": "capacity-reservation"|"client-vpn-endpoint"|"customer-gateway"|"carrier-gateway"|"coip-pool"|"declarative-policies-report"|"dedicated-host"|"dhcp-options"|"egress-only-internet-gateway"|"elastic-ip"|"elastic-gpu"|"export-image-task"|"export-instance-task"|"fleet"|"fpga-image"|"host-reservation"|"image"|"import-image-task"|"import-snapshot-task"|"instance"|"instance-event-window"|"internet-gateway"|"ipam"|"ipam-pool"|"ipam-scope"|"ipv4pool-ec2"|"ipv6pool-ec2"|"key-pair"|"launch-template"|"local-gateway"|"local-gateway-route-table"|"local-gateway-virtual-interface"|"local-gateway-virtual-interface-group"|"local-gateway-route-table-vpc-association"|"local-gateway-route-table-virtual-interface-group-association"|"natgateway"|"network-acl"|"network-interface"|"network-insights-analysis"|"network-insights-path"|"network-insights-access-scope"|"network-insights-access-scope-analysis"|"outpost-lag"|"placement-group"|"prefix-list"|"replace-root-volume-task"|"reserved-instances"|"route-table"|"security-group"|"security-group-rule"|"service-link-virtual-interface"|"snapshot"|"spot-fleet-request"|"spot-instances-request"|"subnet"|"subnet-cidr-reservation"|"traffic-mirror-filter"|"traffic-mirror-session"|"traffic-mirror-target"|"transit-gateway"|"transit-gateway-attachment"|"transit-gateway-connect-peer"|"transit-gateway-multicast-domain"|"transit-gateway-policy-table"|"transit-gateway-route-table"|"transit-gateway-route-table-announcement"|"volume"|"vpc"|"vpc-endpoint"|"vpc-endpoint-connection"|"vpc-endpoint-service"|"vpc-endpoint-service-permission"|"vpc-peering-connection"|"vpn-connection"|"vpn-gateway"|"vpc-flow-log"|"capacity-reservation-fleet"|"traffic-mirror-filter-rule"|"vpc-endpoint-connection-device-type"|"verified-access-instance"|"verified-access-group"|"verified-access-endpoint"|"verified-access-policy"|"verified-access-trust-provider"|"vpn-connection-device-type"|"vpc-block-public-access-exclusion"|"route-server"|"route-server-endpoint"|"route-server-peer"|"ipam-resource-discovery"|"ipam-resource-discovery-association"|"instance-connect-endpoint"|"verified-access-endpoint-target"|"ipam-external-resource-verification-token"|"mac-modification-task",
"Tags": [
{
"Key": "string",
"Value": "string"
}
...
]
}
...
]
--usage-operation (строка)
--boot-mode (строка)
Режим загрузки виртуальной машины.
Примечание
Режим загрузкиuefi-preferred не поддерживается для импорта образов. Дополнительную информацию см. в разделе Режимы загрузки в руководстве пользователя VM Import/Export .Возможные значения:
legacy-biosuefiuefi-preferred
--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)
Включить/выключить цветной вывод.
- включить
- выключить
- автоматически
--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-auto-prompt (boolean)
Автоматически запрашивать параметры ввода CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическое запросы параметров ввода CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. Подробнее см. руководство по началу работы в руководстве пользователя AWS CLI.
Если не указано иное, все примеры используют правила цитирования по образцу Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. Подробнее см. раздел «Использование кавычек со строками» в руководстве пользователя AWS CLI.
Импорт файла образа виртуальной машины как AMI
В следующем import-image примере импортируется указанный OVA.
aws ec2 import-image \
--disk-containers Format=ova,UserBucket="{S3Bucket=my-import-bucket,S3Key=vms/my-server-vm.ova}"
Вывод:
{
"ImportTaskId": "import-ami-1234567890abcdef0",
"Progress": "2",
"SnapshotDetails": [
{
"DiskImageSize": 0.0,
"Format": "ova",
"UserBucket": {
"S3Bucket": "my-import-bucket",
"S3Key": "vms/my-server-vm.ova"
}
}
],
"Status": "active",
"StatusMessage": "pending"
}
Вывод
Архитектура -> (строка)
Описание -> (строка)
Зашифровано -> (логическое значение)
Гипервизор -> (строка)
ImageId -> (строка)
ImportTaskId -> (строка)
KmsKeyId -> (строка)
ТипЛицензии -> (строка)
Платформа -> (строка)
Прогресс -> (строка)
SnapshotDetails -> (список)
Информация о моментальных снимках.
(структура)
Описание моментального снимка, созданного из импортированного диска.
Описание -> (строка)
DeviceName -> (строка)
РазмерДиска -> (двойное значение)
Формат -> (строка)
Прогресс -> (строка)
SnapshotId -> (строка)
Состояние -> (строка)
СообщениеСостояния -> (строка)
Url -> (строка)
BucketПользователя -> (структура)
Amazon S3 bucket для образа диска.
S3Bucket -> (строка)
S3Key -> (строка)
Состояние -> (строка)
СообщениеСостояния -> (строка)
LicenseSpecifications -> (список)
ARN лицензионных конфигураций.
(структура)
Информация о лицензионных конфигурациях.
LicenseConfigurationArn -> (строка)
Теги -> (список)
Присвоенные теги к задаче импорта образа.
(структура)
Описание тега.
Ключ -> (строка)
Ключ тега.
Ограничения: Ключи тегов регистрозависимы и принимают не более 127 символов Юникода. Не может начинаться с aws: .
Значение -> (строка)
Значение тега.
Ограничения: Значения тегов регистрозависимы и принимают не более 256 символов Юникода.
UsageOperation -> (строка)
© Copyright 2025, Amazon Web Services. Created using Sphinx.