Menu
AWS Import/Export
Developer Guide

Import to Amazon EBS Manifest File Options

The Amazon EBS import manifest file includes information related to importing your data into Amazon EBS and returning your storage device. This section explains options that are unique to Amazon EBS import manifest files. For information about options that are common to all manifest files, see Common Manifest File Options.

Note

Amazon EBS use manifest file version 3.0. Set manifestVersion to 3.0 for all Amazon EBS manifest files.

An Amazon EBS import creates a virtual copy of your device as a single image. The device's file system won't be automatically mounted to an Amazon EC2 instance. The maximum size of an Amazon EBS volume is 16 TB. Note that the maximum capacity of a device is independent of the amount of data stored on the device.

Option Description Required
eraseDevice

A value that acknowledges that AWS will erase the contents of your storage device after importing the data. All writable blocks on your storage device will be overwritten with zeros. You will need to repartition and format your device after the wipe.

Example

Copy
eraseDevice: yes

Type: String

Default: None

Valid Values: yes | true

Yes
operations

The operations option is a container for one or more subfields. You specify operations parameters by a dash followed by a set of subfields.

 

The following example shows the operations option with the required Amazon EBS subfields.

Copy
operations: - destination: ebs-snapshot source: device region: us-east-1 deviceCapacityGreaterThan1TB: no

See Operations Subfields for details about each subfield.

Type: String

Default: None

Yes

pinCode

If a storage device with hardware-based encryption was supplied, the PIN code for the device. For more information, see Encrypting Your Data.

Copy
pinCode: 1234

Important

Do not lose your PIN code, or you will not be able to decrypt your data. AWS Import/Export will not send the PIN code with the encrypted device.

Type: Integer

Default: None

No

Operations Subfields

The following table describes the subfields of the Operations parameter

Operations Subfields Description Required
destination

The destination of the data.

For an Amazon EBS import operation the destination is ebs-snapshot.

Type: String

Default: None

Valid Values: ebs-snapshot

Yes
deviceCapacityGreaterThan1TB

A value that specifies if the device capacity is larger than 1 TB. AWS Import/Export now supports Amazon EBS imports of 16 TB.

Type: String

Default: None

Valid Values: yes | no

Yes
region

The region to target for the import operation.

Type: String

Default: None

Valid Values: us-east-1 | us-west-1 | us-west-2 | eu-west-1 | ap-southeast-1

Yes
source

The originator of the data. For an import job the origin is the device.

Type: String

Default: None

Valid Values: device

Yes

Example Import to Amazon EBS Manifest

The following example is the manifest file content for an import job to Amazon EBS, including expedited shipping.

Copy
manifestVersion: 3.0 deviceId: ABCDE eraseDevice: yes generator: AWS Import Export Docs logPrefix: logs logBucket: iemanifest-bucket notificationEmail: john.doe@example.com;jane.roe@example.com operations: - destination: ebs-snapshot source: device region: us-east-1 deviceCapacityGreaterThan1TB: no returnAddress: name: Jane Roe company: Example Corp. street1: 123 Any Street city: Anytown stateOrProvince: WA postalCode: 91011-1111 phoneNumber: 206-555-1111 country: USA serviceLevel: expeditedShipping