Monitor an import image task - VM Import/Export
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

Monitor an import image task

You can monitor the progress of an import image task for VM Import/Export. The following are the status values for an import image task:

  • active — The import task is in progress.

  • deleting — The import task is being canceled.

  • deleted — The import task is canceled.

  • updating — Import status is updating.

  • validating — The imported image is being validated.

  • validated — The imported image was validated.

  • converting — The imported image is being converted into an AMI.

  • completed — The import task is completed and the AMI is ready to use.

Amazon CLI
To get the status of an import image task

Use the following describe-import-image-tasks command.

aws ec2 describe-import-image-tasks \
    --import-task-ids import-ami-1234567890abcdef0

The following is example output. When the import task is completed, the ID of the AMI is provided in ImageId.

{
    "ImportImageTasks": [
        {
            "ImportTaskId": "import-ami-01234567890abcdef",
            "ImageId": "ami-1234567890EXAMPLE",
            "SnapshotDetails": [
                {
                    "DiskImageSize": 705638400.0,
                    "Format": "ova",
                    "SnapshotId": "snap-111222333444aaabb",
                    "Status": "completed",
                    "UserBucket": {
                        "S3Bucket": "amzn-s3-demo-import-bucket",
                        "S3Key": "vms/my-server-vm.ova"
                    }
                }
            ],
            "Status": "completed"
        }
    ]
}
To get the status of all import image tasks

Use the following describe-import-image-tasks command. The sed command truncates the status message. If the task fails and the status message is long, it makes the table harder to read.

aws ec2 describe-import-image-tasks \
  --query "ImportImageTasks[*].{Description:Description, Progress:Progress, Status:Status, ImportTaskId:ImportTaskId, StatusMessage:StatusMessage}" \
  --output table | \
    sed 's/\(.\{120\}\).*/\1|/'

The following is example output. You can display any additional fields that you need.

+---------------------+-------------------------------+-----------+----------+-----------------
|    Description      |         ImportTaskId          | Progress  | Status   |  StatusMessage |
+----------------------------------+------------------+-----------+----------+----------------+
|  My server disks    |  import-ami-01234567890abaaaa |  62       |  active  |  booting       |
|  My server OVA      |  import-ami-01234567890abbbbb |  62       |  active  |  booting       |
|  My server disks    |  import-ami-01234567890accccc |  62       |  active  |  booting       |
+----------------------------------+------------------+-----------+----------+----------------+
PowerShell
To get the status of an import image task

Use the Get-EC2ImportImageTask cmdlet as follows.

Get-EC2ImportImageTask `
    -ImportTaskId import-ami-01234567890abcdef |
        Format-List ImportTaskId, Status, Progress, ImageId, 
           @{Name='SnapshotDetails';Expression={ $_.SnapshotDetails | Out-String }}, 
           @{Name='UserBucket';Expression={ $_.SnapshotDetails.UserBucket | Out-String }},

The following is example output. When the import task is completed, the ID of the AMI is provided in ImageId.

ImportTaskId          : import-ami-01234567890abcdef
Status                : completed
Progress              : 
ImageId               : ami-1234567890EXAMPLE
SnapshotDetails       : 
                        Description   : 
                        DeviceName    : /dev/sda1
                        DiskImageSize : 549272064
                        Format        : VMDK
                        Progress      : 
                        SnapshotId    : snap-111222333444aaabb
                        Status        : completed
                        StatusMessage : 
                        Url           : 
                        UserBucket    : Amazon.EC2.Model.UserBucketDetails
UserBucket            : 
                        S3Bucket : amzn-s3-demo-import-bucket
                        S3Key    : vms/my-server-vm.ova
To get the status of all import image tasks

Use the Get-EC2ImportImageTask cmdlet as follows.

Get-EC2ImportImageTask | 
    Format-Table Description, ImportTaskId, Progress, Status, StatusMessage -AutoSize

The following is example output. You can display any additional fields that you need.

Description       ImportTaskId                 Progress Status     StatusMessage
----------------- ------------                 -------- ------     -------------
My server disks   import-ami-01234567890abaaaa 62       active     booting
My server OVA     import-ami-01234567890abbbbb 62       active     booting
My server disks   import-ami-01234567890accccc          completed