AWS Import/Export
Developer Guide (API Version 2010-06-03)
Did this page help you?  Yes | No |  Tell us about it...
« PreviousNext »
View the PDF for this guide.Go to the AWS Discussion Forum for this product.Go to the Kindle Store to download this guide in Kindle format.

Import to Amazon Glacier Manifest File Options

The Amazon Glacier import manifest file includes information related to importing your data into Amazon Glacier and returning your storage device. This section explains options that are unique to Amazon Glacier import manifest files. AWS Import/Export does not support exporting from Amazon EBS or Amazon Glacier. For information about options that are common to import and export manifest files, see Common Manifest File Options.

Note

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

OptionDescriptionRequired
eraseDevice

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.

The following is an example entry.

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 operations with the required Amazon Glacier subfields.

operations:
  - destination: glacier
    source: device
    region: us-east-1
    vaultName: 2012-07_archive
    archiveComment: daily_2012-07-24

For more information about each subfield, see Operations Subfields.

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.

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 SubfieldsDescriptionRequired
archiveComment

A description for the archive. Amazon Glacier creates an archive on the specified vault using this text as the archive description.

The following is an example entry.

archiveComment: daily archive 2012-07-2

Constraints: Maximum length is 997 characters.

Type: String

Default: None

Yes
destination

The destination of the data.

For an Amazon Glacier import operation the destination is glacier.

Type: String

Default: None

Valid Values: glacier

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

For more information about regions go to the AWS Import/Export Calculator.

Yes
source

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

Type: String

Default: None

Valid Values: device

Yes
vaultNameSpecifies the Amazon Glacier vault where AWS Import/Export loads your data. You must create a vault before we can load data into it; we do not create the vault for you. The account doing the load must have write permissions on this vault.

Type: String

Default: None

Constraints: Must be an existing Amazon Glacier vault name

Yes

Example Import to Amazon Glacier Manifest

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

manifestVersion: 3.0

deviceId: 49382 
eraseDevice: yes
logBucket: myBucket
logPrefix: logs
generator: AWS Import/Export Command Line Tool
notificationEmail: john.doe@example.com;jane.roe@example.com
returnAddress:
   name: Jane Roe 
   company: Example Corp.   
   street1: 123 Any Street
   city: Anytown
   stateOrProvince: WA
   postalCode: 91011-1111
   phoneNumber: 206-555-1111
   country: USA
operations:
    - destination: glacier
      source: device
      region: us-east-1
      vaultName: MyGlacierVault
      archiveComment: July 24, 2012 daily archive
serviceLevel: expeditedShipping