Menu
AWS Import/Export
Developer Guide

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.

Option Description Required
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.

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

Copy
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.

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
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.

Copy
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
vaultName Specifies 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.

Copy
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