image management 3.4 spec imaging service

Table of Contents Instance Import/Export API Service Design EC2 Instance Import/Export Service Import/Export Operations Internal Import/Export Operations Test Plan

Instance Import/Export API

The Imaging service is:

• The engine for driving image conversion/import tasks.
• Is the ground-truth for conversion task state
• Will have to be queried for information needed to fulfill EC2 Instance Import/Export Service requests.

This service has several parts:

Service Design

• EC2 Instance Import/Export service: User facing service implementing AWS/EC2 specified operations.
• Imaging service: Internal-only service which manages all conversion tasks (not only the import/export requests).

EC2 Instance Import/Export Service

This service is part of the EC2 API implementation and performs a portion of the work of processing requests:

• Accepts user requests
• Validates the parameters
• Sends the request to the imaging service
• Responds to the user.
• Subsequently, the user can poll the state of the import task.

Import/Conversion task state is stored in the persistence subsystem (DB) and is managed by the Imaging service.

Import/Export Operations

These are the user-facing service operations defined by AWS as part of the Instance Import/Export services:

See Instance Import/Export Service API and Imaging Service API

Name	Description
ImportInstance	EC2 ImportInstance This is the new operation corresponding to the user-facing EC2 ImportInstance operation. The important distinction here is that the runtime validations are performed and the instance is subsequently made available to the user. This operation is a composition of the below primitives.
ImportVolume	EC2 ImportVolume This is the new operation corresponding to the user-facing EC2 ImportVolume operation. The important distinction here is that the runtime validations are performed and the volume is subsequently made available to the user. This operation is a composition of the below primitives.
DescribeConversionTasks	EC2 DescribeConversionTasks This operation lists the status of currently ongoing import tasks (any of the above kinds need to be queryable in this fashion)
CancelConversionTask	EC2 CancelConversionTask This operation cancels an extent conversion task
CreateInstanceExportTask	EC2 CreateInstanceExportTask
CancelExportTask	EC2 CancelExportTask
DescribeExportTasks	EC2 DescribeExportTasks

The backend implementation for the bolded operations are required for 3.4 while those that are italicized are out of scope for 3.4.

Internal Import/Export Operations

These operations are to serve as the internal complement for the user-facing operations defined above for the EC2 Instance Import/Export service.

Name	Description
ImportImage	Internal service operation which takes a manifest URL reference and creates an internally bundled, converted, validated image in an (optionally provided) output bucket.
ImportVolume	Internal service operation which takes a manifest URL reference and creates an internally bundled, converted, validated image in a volume.
ValidateInstance	runs a collection of image validation checks which are performed on a running instance, again, using the image toolkit.
DescribeImagingTasks	This is an internal service operation which corresponds with the internal import image workflow supporting bundling of instances.
CancelImagingTask	Cancels the imaging task indicated by the supplied identifier

Test Plan

---

tag:rls-3.4