GET /#Action=ExportImage

Exports an Amazon Machine Image (AMI) to a VM file. For more information, see Exporting a VM directly from an Amazon Machine Image (AMI) in the VM Import/Export User Guide.

Servers

Request headers

Name Type Required Description
X-Amz-Content-Sha256 String No
X-Amz-Credential String No
X-Amz-Date String No
X-Amz-Algorithm String No
X-Amz-SignedHeaders String No
X-Amz-Security-Token String No
X-Amz-Signature String No

Query parameters

Name Type Required Description
Version String Yes

Possible values:

  • "2016-11-15"
ClientToken String No

Token to enable idempotency for export image requests.

DiskImageFormat String Yes

The disk image format.

Possible values:

  • "VHD"
  • "VMDK"
  • "RAW"
ImageId String Yes

The ID of the image.

RoleName String No

The name of the role that grants VM Import/Export permission to export images to your Amazon S3 bucket. If this parameter is not specified, the default role is named 'vmimport'.

S3ExportLocation Object Yes

The Amazon S3 bucket for the destination image. The destination bucket must exist.

TagSpecification[] Array No

The tags to apply to the export image task during creation.

DryRun Boolean No

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.

Description String No

A description of the image being exported. The maximum length is 255 characters.

Action String Yes

Possible values:

  • "ExportImage"

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.