|« PreviousNext »|
|Did this page help you? Yes | No | Tell us about it...|
An Amazon S3 export transfers individual objects from Amazon S3 buckets to your device, creating one file for each object. You can export from more than one bucket and you can specify which files to export using manifest file options.
To ensure the speed and accuracy of S3 Export jobs, AWS Import/Export formats your device before beginning the data load. Any data that is stored on the device when you sent the device to AWS will be lost.
You must submit a separate job request for each device.
You can send multiple devices in the same shipment. If you do, however, there are specific guidelines and limitations that govern what devices you can ship and how your devices must be packaged. If your shipment is not prepared and packed correctly, AWS Import/Export cannot process your jobs. Regardless of how many devices you ship at one time, you must submit a separate job request for each device. For complete details about packaging requirements when shipping multiple devices, see Shipping Multiple Devices.
For more information, see Guidelines and Limitations
Export from Amazon EBS or Amazon Glacier to a storage device is not currently supported.
You can create a bucket using the AWS Management Console. For more information, go to Creating a Bucket.
To create an Amazon S3 export job
Create a manifest file.
Prepare your device for shipping.
AWS Import/Export sends a response with a
file and job information.
SIGNATURE file to your device.
Ship your device.
These steps assume that you have signed up for an AWS account and created your
AWScredentials.properties file as described in the earlier
The manifest file is a YAML-formatted text file that instructs AWS about how to handle your job. It consists of a set of name-value pairs that supply required information such as your device ID, your Secret Access Key, return address, and so on. For more information about YAML, go to http://yaml.org.
The AWS Import/Export Web Service Tool provides three examples of manifest files that you can modify for your import and export jobs.
Go to the
Examples folder in the folder where you
installed the AWS Import/Export Web Service Tool.
S3-export-manifest.txt file in a text
manifestVersion:2.0 generator:text editor accessKeyId:
[Enter 20 character id]deviceId:
[Enter device serial number]fileSystem:
[NTFS|EXT2|EXT3|EXT4|FAT32]serviceLevel:expeditedShipping targetDirectory:/ recoveryDirectory:EXPORT-RECOVERY logBucket:
[Your log bucket]operations: - exportBucket:
[Your bucket]returnAddress: name:
[Optional - your company]street1:
[Optional - additional street info]street3:
[Optional - additional street info]city:
[Your state or province]postalCode:
[Your postal code]country:
When shipping devices internationally except within the European Union you must include the customs option in the manifest. For more information about the customs-related manifest options, see Customs Manifest File Option.
In the file, replace all text in brackets with the appropriate values. Delete any unused optional lines.
Provide your Access Key ID, the name of the your existing Amazon S3
bucket name containing the data to export, and a bucket name to save
your log data. For the
exportBucket options provide only the name of
the bucket, for example
For more information about manifest file options, see Creating Export Manifests .
Save the file as
MyS3ExportManifest.txt in the same
folder as your
If your device is not properly prepared before shipping, AWS might need to return the device without processing the request. For more information, see Shipping Your Storage Device
Now that you have your credentials file and manifest file in place, you send a
CreateJob request to AWS Import/Export. You send a
CreateJob request for each device.
Open a command prompt (or, on a Mac, use the Terminal application), and change to the directory where you unzipped the AWS Import/Export tool.
Enter the following
CreateJob request on the
cmdPrompt>java -jar lib/AWSImportExportWebServiceTool-1.0.jar CreateJob Export MyS3ExportManifest.txt .
CreateJob request includes a directory name
for where you want the
SIGNATURE file saved. In
this example, the closing period (.) at the end of the command refers to
the current directory. Either include the period, as shown above, or
replace it with a directory name.
If there is an error, AWS Import/Export returns an error message.
If there are no errors in the request, AWS Import/Export returns a JOB CREATED response.The following is a sample response.
JOB CREATED JobId: TC44P JobType: Export **************************************** * AwsShippingAddress * **************************************** AWS Import/Export C/O AnyCompany JOBID TC44P 123 Any Street Anytown, VA 22153 **************************************** * SignatureFileContents * **************************************** version:2.0 signingMethod:HmacSHA1 jobId:TC44P signature:BBAqQ/E+R7bdXRVR1s9vTi5t7Aps= Writing SignatureFileContents to C:\ImportExportWebServiceTool\.\SIGNATURE
Your job expires after 30 days. If you do not send a device, there is no charge.
In response to your
CreateJob request, AWS writes a file
SIGNATURE to your computer. The
SIGNATURE file contains a signature, which is an
encrypted string that allows us to authenticate your device and match it to your
SIGNATURE file in the directory that you
specified in your job request and copy it to the root directory of your storage
device. The file name must be named
SIGNATURE and it must
be in the device's root directory.
Each device you send must include the unique
file for that device and that JOBID. AWS Import/Export validates the
SIGNATURE file on your storage device before starting
the data load. If the
SIGNATURE file is missing or invalid
(for example, if it is associated with a different job request), AWS
Import/Export will not perform the data load and we will return your storage
It is essential that you prepare your device properly before shipping.
Pack the power supply, power cable, and interface cables with your storage device. Without these, we can't transfer your data and will return your device.
Fill out the packing slip and include the packing slip with your device and cables.
Download the packing slip from http://s3.amazonaws.com/awsimportexport/AWS_Import_Export_Packing_Slip.pdf.
Send your package to the address provided in the
For detailed instructions for preparing and shipping your device, see Shipping Your Storage Device.
Your job expires after 30 days. If you do not send a device, there is no charge. You are billed only after AWS Import/Export receives your device. If we receive your package after your job expires, we will return your device. You will only be charged for the shipping fees, if any.
Now, you have explored the getting started steps of AWS Import/Export. To learn more about the product, see Where Do I Go from Here?.