Table Of Contents


User Guide

First time using the AWS CLI? See the User Guide for help getting started.

[ aws . ec2 ]



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

See also: AWS API Documentation

See 'aws help' for descriptions of global parameters.


[--dry-run | --no-dry-run]
[--filters <value>]
[--import-task-ids <value>]
[--max-results <value>]
[--next-token <value>]
[--cli-input-json <value>]
[--generate-cli-skeleton <value>]


--dry-run | --no-dry-run (boolean)

Checks 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 .

--filters (list)

Filter tasks using the task-state filter and one of the following values: active, completed, deleting, deleted.

Shorthand Syntax:

Name=string,Values=string,string ...

JSON Syntax:

    "Name": "string",
    "Values": ["string", ...]

--import-task-ids (list)

A list of import image task IDs.


"string" "string" ...

--max-results (integer)

The maximum number of results to return in a single call. To retrieve the remaining results, make another call with the returned NextToken value.

--next-token (string)

A token that indicates the next page of results.

--cli-input-json (string) Performs service operation based on the JSON string provided. The JSON string follows the format provided by --generate-cli-skeleton. If other arguments are provided on the command line, the CLI values will override the JSON-provided values. It is not possible to pass arbitrary binary values using a JSON-provided value as the string will be taken literally.

--generate-cli-skeleton (string) Prints a JSON skeleton to standard output without sending an API request. If provided with no value or the value input, prints a sample input JSON that can be used as an argument for --cli-input-json. If provided with the value output, it validates the command inputs and returns a sample output JSON for that command.

See 'aws help' for descriptions of global parameters.


ImportImageTasks -> (list)

A list of zero or more import image tasks that are currently active or were completed or canceled in the previous 7 days.


Describes an import image task.

Architecture -> (string)

The architecture of the virtual machine.

Valid values: i386 | x86_64

Description -> (string)

A description of the import task.

Encrypted -> (boolean)

Indicates whether the image is encrypted.

Hypervisor -> (string)

The target hypervisor for the import task.

Valid values: xen

ImageId -> (string)

The ID of the Amazon Machine Image (AMI) of the imported virtual machine.

ImportTaskId -> (string)

The ID of the import image task.

KmsKeyId -> (string)

The identifier for the AWS Key Management Service (AWS KMS) customer master key (CMK) that was used to create the encrypted image.

LicenseType -> (string)

The license type of the virtual machine.

Platform -> (string)

The description string for the import image task.

Progress -> (string)

The percentage of progress of the import image task.

SnapshotDetails -> (list)

Information about the snapshots.


Describes the snapshot created from the imported disk.

Description -> (string)

A description for the snapshot.

DeviceName -> (string)

The block device mapping for the snapshot.

DiskImageSize -> (double)

The size of the disk in the snapshot, in GiB.

Format -> (string)

The format of the disk image from which the snapshot is created.

Progress -> (string)

The percentage of progress for the task.

SnapshotId -> (string)

The snapshot ID of the disk being imported.

Status -> (string)

A brief status of the snapshot creation.

StatusMessage -> (string)

A detailed status message for the snapshot creation.

Url -> (string)

The URL used to access the disk image.

UserBucket -> (structure)

The S3 bucket for the disk image.

S3Bucket -> (string)

The S3 bucket from which the disk image was created.

S3Key -> (string)

The file name of the disk image.

Status -> (string)

A brief status for the import image task.

StatusMessage -> (string)

A descriptive status message for the import image task.

NextToken -> (string)

The token to use to get the next page of results. This value is null when there are no more results to return.