Spec-Zone.ru › AWS CLI v2

[ aws . ec2 ]

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

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

Url -> (строка)

URL образа диска на основе Amazon S3. URL может быть https-URL (https://..) или Amazon S3-URL (s3://..).

UserBucket -> (структура)

Ведро S3 для образа диска.

S3Bucket -> (строка)

Имя ведра Amazon S3, в котором расположен образ диска.

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

Указывает, должен ли целевой AMI импортированного образа быть зашифрован. Используется стандартный ключ KMS для EBS, если не указан другой ключ KMS с помощью 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 (строка)

Имя роли для использования вместо стандартной роли «vmimport».

--license-specifications (список)

ARN-адреса конфигураций лицензий.

(структура)

Информация о запросе конфигураций лицензий.

LicenseConfigurationArn -> (строка)

ARN конфигурации лицензии.

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

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

Значение операции использования. Дополнительную информацию см. в разделе Варианты лицензирования в руководстве пользователя VM Import/Export.

--boot-mode (строка)

Режим загрузки виртуальной машины.

Примечание

Режим загрузки uefi-preferred не поддерживается для импорта образов. Дополнительную информацию см. в разделе Режимы загрузки в руководстве пользователя VM Import/Export .

Возможные значения:

  • legacy-bios
  • uefi
  • uefi-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"
}

Вывод

Архитектура -> (строка)

Архитектура виртуальной машины.

Описание -> (строка)

Описание задачи импорта.

Зашифровано -> (логическое значение)

Указывает, зашифрован ли AMI.

Гипервизор -> (строка)

Целевой гипервизор задачи импорта.

ImageId -> (строка)

Идентификатор созданного Amazon Machine Image (AMI) в результате задачи импорта.

ImportTaskId -> (строка)

Идентификатор задачи импорта образа.

KmsKeyId -> (строка)

Идентификатор симметричного KMS-ключа, использованного для создания зашифрованного AMI.

ТипЛицензии -> (строка)

Тип лицензии виртуальной машины.

Платформа -> (строка)

Операционная система виртуальной машины.

Прогресс -> (строка)

Прогресс выполнения задачи.

SnapshotDetails -> (список)

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

(структура)

Описание моментального снимка, созданного из импортированного диска.

Описание -> (строка)

Описание моментального снимка.

DeviceName -> (строка)

Карта блочных устройств для моментального снимка.

РазмерДиска -> (двойное значение)

Размер диска в моментальном снимке в GiB.

Формат -> (строка)

Формат образа диска, из которого создается моментальный снимок.

Прогресс -> (строка)

Процент выполнения задачи.

SnapshotId -> (строка)

Идентификатор моментального снимка импортируемого диска.

Состояние -> (строка)

Краткое состояние создания моментального снимка.

СообщениеСостояния -> (строка)

Подробное сообщение состояния создания моментального снимка.

Url -> (строка)

URL для доступа к образу диска.

BucketПользователя -> (структура)

Amazon S3 bucket для образа диска.

S3Bucket -> (строка)

Amazon S3 bucket, из которого был создан образ диска.

S3Key -> (строка)

Имя файла образа диска.

Состояние -> (строка)

Краткое состояние задачи.

СообщениеСостояния -> (строка)

Подробное сообщение состояния задачи импорта.

LicenseSpecifications -> (список)

ARN лицензионных конфигураций.

(структура)

Информация о лицензионных конфигурациях.

LicenseConfigurationArn -> (строка)

ARN лицензионной конфигурации.

Теги -> (список)

Присвоенные теги к задаче импорта образа.

(структура)

Описание тега.

Ключ -> (строка)

Ключ тега.

Ограничения: Ключи тегов регистрозависимы и принимают не более 127 символов Юникода. Не может начинаться с aws: .

Значение -> (строка)

Значение тега.

Ограничения: Значения тегов регистрозависимы и принимают не более 256 символов Юникода.

UsageOperation -> (строка)

Значение операции использования.

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

Spec-Zone.ru

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