Skip to main content

import_image_tasks

Creates, updates, deletes, gets or lists an import_image_tasks resource.

Overview

Nameimport_image_tasks
TypeResource
Idaws.ec2.import_image_tasks

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
architecturestringThe architecture of the virtual machine. Valid values: i386 | x86_64 | arm64
boot_modestringThe boot mode of the virtual machine.
descriptionstringA description of the import task.
encryptedbooleanIndicates whether the image is encrypted.
hypervisorstringThe target hypervisor for the import task. Valid values: xen
image_idstringThe ID of the Amazon Machine Image (AMI) of the imported virtual machine.
import_task_idstringThe ID of the import image task.
kms_key_idstringThe identifier for the KMS key that was used to create the encrypted image.
license_specificationsstringThe ARNs of the license configurations that are associated with the import image task.
license_typestringThe license type of the virtual machine.
platformstringThe description string for the import image task.
progressstringThe percentage of progress of the import image task.
snapshot_detailsstringInformation about the snapshots.
statusstringA brief status for the import image task.
status_messagestringA descriptive status message for the import image task.
tagsstringThe tags for the import image task.
usage_operationstringThe usage operation value.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
describe_import_image_tasksselectregionDryRun, Filters, ImportTaskId, MaxResults, NextTokenDisplays details about an import virtual machine or import snapshot tasks that are already created.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
regionstringAWS region (default: us-east-1)
DryRunbooleanChecks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.
FiltersarrayFilter tasks using the task-state filter and one of the following values: active, completed, deleting, or deleted.
ImportTaskIdarrayThe IDs of the import image tasks.
MaxResultsintegerThe maximum number of results to return in a single call.
NextTokenstringA token that indicates the next page of results.

SELECT examples

Displays details about an import virtual machine or import snapshot tasks that are already created.

SELECT
architecture,
boot_mode,
description,
encrypted,
hypervisor,
image_id,
import_task_id,
kms_key_id,
license_specifications,
license_type,
platform,
progress,
snapshot_details,
status,
status_message,
tags,
usage_operation
FROM aws.ec2.import_image_tasks
WHERE region = '{{ region }}' -- required
AND DryRun = '{{ DryRun }}'
AND Filters = '{{ Filters }}'
AND ImportTaskId = '{{ ImportTaskId }}'
AND MaxResults = '{{ MaxResults }}'
AND NextToken = '{{ NextToken }}'
;