How do I use VM Import/Export to export a VM-based instance on my AMI?

Short description

Use the AWS Command Line Interface (AWS CLI) and VM Import/Export to start an image export task. This exports a copy of your AMI as a VM file that's written to an Amazon Simple Storage Service (Amazon S3) bucket. Use the exported VM to deploy a new and standardized instance in your on-site virtualization environment. Most AMIs can export to Citrix Xen, Microsoft Hyper-V, or VMware vSphere.

Prerequisites:

• Review the VM export limitations to verify that VM Import/Export supports your AMI.
• If you sign in as an AWS Identity and Access Management (IAM) user, then make sure that you have the required IAM user permissions in your policy.

Resolution

Note: If you receive errors when running AWS CLI commands, make sure that you're using the most recent version of the AWS CLI.

1.    Create an Amazon Elastic Block Store (Amazon EBS) backed AMI from the Amazon Elastic Compute Cloud (EC2) instance that you want to export.

• For Linux, see Create an Amazon EBS backed Linux AMI.
• For Windows, see Create a custom Windows AMI.

2.    Install the AWS CLI on a client machine. Then, configure the AWS CLI with the AWS credentials for your IAM user.

3.    Create a new S3 bucket in the same AWS Region as the AMI that you plan to export.

4.    Activate AWS Security Token Service (AWS STS) in the Region that you're using for VM Import/Export. Then, create the required service role.

5.    From the client machine that you installed the AWS CLI on, run the export-image command to start the export image task:

aws ec2 export-image --image-id example-ami-id --disk-image-format example-disk-image-format --s3-export-location S3Bucket=example-export-bucket,S3Prefix=exports/

Note: In the preceding example, the Amazon S3 key prefixexport-ami-id.format is used to write the exported file to your specified Amazon S3 bucket. You can add prefixes to the exported file.

Example export-image command output:

{  
    "DiskImageFormat": "vmdk",  
    "ExportImageTaskId": "export-ami-1234567890abcdef0"  
    "ImageId": "example-ami-id",  
    "RoleName": "vmimport",  
    "Progress": "0",  
    "S3ExportLocation": {  
        "S3Bucket": "example-export-bucket",  
        "S3Prefix": "exports/"  
    },  
    "Status": "active",  
    "StatusMessage": "validating"  
}

6.    To check the status of your export image task, run the describe-export-image-tasks command:

aws ec2 describe-export-image-tasks --example-image-task-id example-ami-id

Example describe-export-image-tasks command output:

{  
    "ExportImageTasks": [  
        {  
            "ExportImageTaskId": "export-ami-1234567890abcdef0"  
            "Progress": "21",  
            "S3ExportLocation": {  
                "S3Bucket": "my-export-bucket",  
                "S3Prefix": "exports/"  
            },  
            "Status": "active",  
            "StatusMessage": "updating"  
        }  
    ]  
}

7.    Confirm that the status of your export image task changes to completed. This indicates that your exported file is ready as an object in your Amazon S3 bucket.

Example output of completed status:

{  
    "ExportImageTasks": [  
        {  
            "ExportImageTaskId": "example-export-ami-id"  
            "S3ExportLocation": {  
                "S3Bucket": "example-export-bucket",  
                "S3Prefix": "exports/"  
            },  
            "Status": "completed"  
        }  
    ]  
}

8.    Use the Amazon S3 console to access your Amazon S3 bucket. Then, locate and download the object.

Related information

Exporting a VM directly from an Amazon Machine Image (AMI)

Creating an IAM user in your AWS account

AWS security credentials

Amazon Machine Images (AMI)

Troubleshooting VM Import/Export