AWS Import/Export
Developer Guide (API Version 2010-06-03)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

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. AWS Import/Export does not support exporting from Amazon EBS. For information on Amazon S3 import manifest file options, see Import to Amazon S3 Manifest File Options. For information about options that are common to import and export manifest files, see Common Manifest File Options.

[Note]Note

The Amazon EBS import manifest file options can only be used when the manifestVersion is set to 3.0.

[Note]Note

If your storage device is less than or equal to the maximum volume size of 1TB, its contents are loaded directly into an Amazon EBS snapshot. If your storage device’s capacity exceeds 1TB, a device image is stored within your specified Amazon S3 log bucket. You can then create a RAID of Amazon EBS volumes using software such as Logical Volume Manager, and copy the image from Amazon S3 to this new volume.

OptionDescriptionRequired
eraseDevice

Specifies whether (Yes) or not (No) to erase the contents of your storage device after importing the data. If you elect to have us erase your storage device after importing its 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. For information about the prices charged for this service, go to the AWS Import/Export detail page.

The following is an example entry.

eraseDevice: no

Type: String

Default: None

Valid Values: yes | no

Yes
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

Ancestor: operations

Yes
deviceCapacityGreaterThan1TB

Specifies if the device capacity is larger than the maximum Amazon EBS volume size of 1TB.

[Note]Note
If your storage device is less than or equal to the maximum volume size of 1TB, its contents are loaded directly into an Amazon EBS snapshot. If your storage device’s capacity exceeds 1TB, a device image is stored within your specified Amazon S3 log bucket. You can then create a RAID of Amazon EBS volumes using software such as Logical Volume Manager, and copy the image from Amazon S3 to this new volume.

Type: String

Default: None

Valid Values: yes | no

Ancestor: operations

Yes
operations

operations  is a container for one or more maps, each of which represents a single operation. You specify each operation by a dash followed by a set of key-value pairs.  For import to Amazon EBS each operation contains a destination, region, source, and deviceCapacityGreaterThan1TB option. Currently for import to Amazon EBS you can specify only one operation. The following example shows operations with its subfields which are all required.

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

Type: String

Default: None

Subfields: destination, region, source, deviceCapacityGreaterThan1TB

Yes
region

The region to target for the Amazon EBS import operation.

Type: String

Default: None

Valid Values: us-east-1 | us-west-1

Ancestor: operations

Yes
source

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

Type: String

Default: None

Valid Values: device

Ancestor: operations

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.

manifestVersion: 3.0
accessKeyId: AKIAIOSFODNN7EXAMPLE
deviceId: ABCDE
eraseDevice: no
generator: AWS Import Export Docs
logPrefix: logs
logBucket: iemanifest-bucket
notificationEmail: john.doe@example.com;jane.doe@example.com
operations:
  - destination: ebs-snapshot
    source: device
    region: us-east-1
    deviceCapacityGreaterThan1TB: no
returnAddress:
    name: Joe Random 
    company: Amazon
    street1: 123 Any Street    
    city: Anytown
    stateOrProvince: WA
    postalCode: 91111
    phoneNumber: 555-555-0100
    country: USA
serviceLevel: expeditedShipping