| Did this page help you? Yes No Tell us about it... |
You can send a CreateJob request to create an
import job to upload your data to an Amazon S3 bucket. In
response, we send you the information you need to send your storage device to AWS.
In your request, you must identify your existing Amazon S3 bucket and you must have
write permissions on the bucket to upload the data. By default, the log file is also
saved in this bucket.
![]() | Tip |
|---|---|
| You can create a bucket using Amazon Management Console. For more information, go to http://docs.amazonwebservices.com/AmazonS3/latest/UG/CreatingaBucket.html. |
An Import to Amazon S3 job requires file names to be written using UTF-8 character encoding. Any file with a name that is not a valid UTF-8 string is not imported.
To create an Amazon S3 import job
You can now send your storage device to AWS to upload your data to Amazon S3. The final response has the information, the Job ID, the shipping address and the SIGNATURE file you need to include when you send your storage device to AWS to import your data.
Verify that your valid AWS credentials are in the correct location.
For more information, refer to the previous procedure: To save your access credentials to a file.
Create a manifest:
Open a new file in any text editor and copy the following manifest text as a new file.
The manifest options shown are the minimum required set of options.
manifestVersion: 2.0 bucket: ***Your Existing Amazon S3 Bucket Name *** accessKeyId: ***Enter Your Access Key ID*** deviceId: SomeDeviceSerialNumber eraseDevice: no generator: AWS Import Export Docs returnAddress: name: ***Your Name*** street1: ***Your Street*** city: ***Your City*** stateOrProvince: ***Your State*** postalCode: ***Your Postal/Zip Code*** phoneNumber: ***Your Number*** country: ***Your Country***
Update the manifest by providing your Access Key Id, your
existing Amazon S3 bucket name, and where you
want to upload your data. For the bucket
option provide only the name of your bucket, for example
s3examplebucket.
If you are sending a storage device after creating this job, you must also provide your address.
![]() | Note |
|---|---|
You can also change many other items in the manifest. For more information, see Manifest File Options. |
Save the file as MyManifest.txt in the same folder as your
AWSCredentials.properties file.
Send the Request:
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.
CmdPrompt>java -jar lib/AWSImportExportWebServiceTool-1.0.jar CreateJob Import MyManifest.txt .
![]() | Note |
|---|---|
The |
If there are no errors in the request, AWS Import/Export returns a job created response. Following is a sample response.
JOB CREATED JobId: ABCDE JobType: Import **************************************** * AwsShippingAddress * **************************************** AWS Import/Export C/O AnyCompany JOBID ABCDE 123 Any Street Anytown, VA 22153 **************************************** * SignatureFileContents * **************************************** version:2.0 signingMethod:HmacSHA1 jobId:ABCDE-VALIDATE-ONLY signature:cbfdUuhhmauYS+ABCl5R9heDK/V= Writing SignatureFileContents to cmdPrompt\.\SIGNATURE
Copy the SIGNATURE file (included in the AWS response to your job request) to the root directory of your storage device before sending your device. For shipping information, see Shipping Your Storage Device.
![]() | Important |
|---|---|
If you do not send a device, your job expires after 30 days. There is no charge involved. You are billed only after AWS receives your device. |
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?.
