describe-import-image-tasks
Описание
Отображает подробности о задачах импорта виртуальных машин или снимков, которые уже созданы.
См. также: Документация API AWS
describe-import-image-tasks это постраничная операция. Для получения всего набора результатов могут быть выполнены несколько вызовов API. Вы можете отключить постраничность, указав аргумент --no-paginate. При использовании --output text и аргумента --query в ответе с постраничностью, аргумент --query должен извлекать данные из результатов следующих выражений запроса: ImportImageTasks
Синтаксис
describe-import-image-tasks
[--dry-run | --no-dry-run]
[--filters <value>]
[--import-task-ids <value>]
[--cli-input-json | --cli-input-yaml]
[--starting-token <value>]
[--page-size <value>]
[--max-items <value>]
[--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]
Параметры
--dry-run | --no-dry-run (boolean)
DryRunOperation. В противном случае — UnauthorizedOperation.--filters (список)
Фильтровать задачи, используя фильтр task-state и одно из следующих значений: active, completed, deleting или deleted.
(структура)
Пара имя-значение фильтра, используемая для возврата более конкретного списка результатов из операции describe. Фильтры могут использоваться для сопоставления набора ресурсов по определенным критериям, таким как теги, атрибуты или идентификаторы.
Если вы укажете несколько фильтров, фильтры соединяются с помощью AND, и запрос возвращает только результаты, соответствующие всем указанным фильтрам.
Дополнительную информацию см. в разделе Список и фильтрация с помощью командной строки и API в руководстве Amazon EC2 User Guide.
Имя -> (строка)
Значения -> (список)
Значения фильтра. Значения фильтров чувствительны к регистру. Если вы укажете несколько значений для фильтра, значения соединяются с помощью OR, и запрос возвращает все результаты, соответствующие любому из указанных значений.
(строка)
Сокращённый синтаксис:
Name=string,Values=string,string ...
Синтаксис JSON:
[
{
"Name": "string",
"Values": ["string", ...]
}
...
]
--import-task-ids (список)
Идентификаторы задач импорта изображений.
(строка)
Синтаксис:
"string" "string" ...
--cli-input-json | --cli-input-yaml (строка) Читает аргументы из предоставленной строки JSON. Строка JSON соответствует формату, предоставленному --generate-cli-skeleton. Если другие аргументы предоставлены в командной строке, эти значения переопределяют значения, предоставленные в формате JSON. Невозможно передавать произвольные двоичные значения с помощью значения, предоставленного в формате JSON, так как строка будет воспринята буквально. Это не может быть указано вместе с --cli-input-yaml.
--starting-token (строка)
Маркер для указания начала постраничного вывода. Это NextToken из ранее усечённого ответа.
Примеры использования см. в разделе Постраничный вывод в руководстве AWS Command Line Interface User Guide.
--page-size (целое число)
Размер каждой страницы для получения в вызове AWS-сервиса. Это не влияет на количество элементов, возвращённых в выводе команды. Установка меньшего размера страницы приводит к большему количеству вызовов AWS-сервиса, получая меньше элементов в каждом вызове. Это может помочь предотвратить сбой вызовов AWS-сервиса.
Примеры использования см. в разделе Постраничный вывод в руководстве AWS Command Line Interface User Guide.
--max-items (целое число)
Общее количество элементов для возврата в выводе команды. Если общее количество доступных элементов больше указанного значения, предоставляется NextToken в выводе команды. Для возобновления постраничного вывода укажите значение NextToken в аргументе starting-token последующей команды. **Не** используйте элемент ответа NextToken напрямую вне AWS CLI.
Примеры использования см. в разделе Постраничный вывод в руководстве AWS Command Line Interface User Guide.
--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 (строка)
Переопределить URL по умолчанию для команды указанным URL.
--no-verify-ssl (boolean)
По умолчанию AWS CLI использует SSL при взаимодействии с AWS-сервисами. Для каждого соединения SSL AWS CLI будет проверять сертификаты SSL. Этот параметр переопределяет поведение проверки сертификатов SSL по умолчанию.
--no-paginate (boolean)
Отключить автоматическую постраничность. Если автоматическая постраничность отключена, AWS CLI выполнит только один вызов для первой страницы результатов.
--output (строка)
Стиль форматирования вывода команды.
- json
- text
- table
- yaml
- yaml-stream
--query (строка)
Запрос JMESPath для фильтрации данных ответа.
--profile (строка)
Использовать определённый профиль из файла учетных данных.
--region (строка)
Регион для использования. Переопределяет настройки конфигурации/среды.
--version (строка)
Показать версию этого инструмента.
--color (строка)
Включить/выключить цветной вывод.
- on
- off
- auto
--no-sign-request (boolean)
Не подписывать запросы. Учетные данные не будут загружены, если этот аргумент предоставлен.
--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 (boolean)
Отключить постраничный вывод для вывода.
--cli-auto-prompt (boolean)
Автоматически запрашивать параметры CLI.
--no-cli-auto-prompt (boolean)
Отключить автоматическое запрошение параметров CLI.
Примеры
Примечание
Для использования следующих примеров необходимо установить и настроить AWS CLI. См. руководство по началу работы в руководстве AWS CLI User Guide для получения дополнительной информации.
Если не указано иное, все примеры имеют правила цитирования, аналогичные правилам Unix. Эти примеры необходимо адаптировать к правилам цитирования вашей оболочки. См. Использование кавычек со строками в руководстве AWS CLI User Guide.
Для отслеживания задачи импорта изображения
Следующий пример describe-import-image-tasks проверяет состояние указанной задачи импорта изображения.
aws ec2 describe-import-image-tasks \
--import-task-ids import-ami-1234567890abcdef0
Вывод для задачи импорта изображения, которая выполняется.
{
"ImportImageTasks": [
{
"ImportTaskId": "import-ami-1234567890abcdef0",
"Progress": "28",
"SnapshotDetails": [
{
"DiskImageSize": 705638400.0,
"Format": "ova",
"Status": "completed",
"UserBucket": {
"S3Bucket": "my-import-bucket",
"S3Key": "vms/my-server-vm.ova"
}
}
],
"Status": "active",
"StatusMessage": "converting"
}
]
}
Вывод для задачи импорта изображения, которая завершена. Идентификатор результирующего AMI предоставляется ImageId.
{
"ImportImageTasks": [
{
"ImportTaskId": "import-ami-1234567890abcdef0",
"ImageId": "ami-1234567890abcdef0",
"SnapshotDetails": [
{
"DiskImageSize": 705638400.0,
"Format": "ova",
"SnapshotId": "snap-1234567890abcdef0"
"Status": "completed",
"UserBucket": {
"S3Bucket": "my-import-bucket",
"S3Key": "vms/my-server-vm.ova"
}
}
],
"Status": "completed"
}
]
}
Вывод
ImportImageTasks -> (список)
Список из нуля или более задач импорта изображений, которые в настоящее время активны или были завершены или отменены в течение последних 7 дней.
(структура)
Описание задачи импорта изображения.
Архитектура -> (строка)
Архитектура виртуальной машины.
Допустимые значения: i386 | x86_64 | arm64
Описание -> (строка)
Зашифровано -> (логическое значение)
Гипервизор -> (строка)
Целевой гипервизор для задачи импорта.
Допустимые значения: xen
ImageId -> (строка)
ImportTaskId -> (строка)
KmsKeyId -> (строка)
Тип лицензии -> (строка)
Платформа -> (строка)
Прогресс -> (строка)
SnapshotDetails -> (список)
Информация о снимках.
(структура)
Описание снимка, созданного из импортированного диска.
Описание -> (строка)
DeviceName -> (строка)
Размер диска изображения -> (число с плавающей точкой)
Формат -> (строка)
Прогресс -> (строка)
SnapshotId -> (строка)
Статус -> (строка)
Сообщение о статусе -> (строка)
Url -> (строка)
UserBucket -> (структура)
Amazon S3-ведро для образа диска.
S3Bucket -> (строка)
S3Key -> (строка)
Статус -> (строка)
Сообщение о статусе -> (строка)
Теги -> (список)
Теги для задачи импорта изображения.
(структура)
Описание тега.
Ключ -> (строка)
Ключ тега.
Ограничения: Ключи тегов чувствительны к регистру и принимают не более 127 символов Юникода. Не должен начинаться с aws: .
Значение -> (строка)
Значение тега.
Ограничения: Значения тегов чувствительны к регистру и принимают не более 256 символов Юникода.
LicenseSpecifications -> (список)
ARN лицензионных конфигураций, связанных с задачей импорта изображения.
(структура)
Информация о лицензионных конфигурациях.
LicenseConfigurationArn -> (строка)
UsageOperation -> (строка)
BootMode -> (строка)
NextToken -> (строка)
null, когда больше результатов нет.
© Copyright 2025, Amazon Web Services. Created using Sphinx.