AWS Import/Export
Developer Guide (API Version 2010-06-03)
« 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.Did this page help you?  Yes | No |  Tell us about it...

Sending a CreateJob Request Using the AWS Import/Export Web Service Tool

The easiest way to send a CreateJob request is by using the AWS Import/Export Tool.

To send a CreateJob request using the AWS Import/Export Web Service Tool

  1. Click the following link to download the AWS Import/Export Web Service Tool:

    Click http://awsimportexport.s3.amazonaws.com/importexport-webservice-tool.zip.

    Extract the zipped content to a directory on your computer.

  2. Open a command prompt (or a terminal application), and change to the directory where you unzipped the AWS Import/Export Web Service Tool.

  3. Enter the CreateJob request on the command line, specifying either Import or Export and the manifest file name.

    For an Import job, enter the following CreateJob request on the command line.

    CmdPrompt>java -jar lib/AWSImportExportWebServiceTool-1.0.jar CreateJob Import MyImportManifest.txt .  

    For an Export job, enter the following CreateJob request on the command line.

    CmdPrompt>java -jar lib/AWSImportExportWebServiceTool-1.0.jar CreateJob Export MyExportManifest.txt .  

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

Note

For export, your Amazon S3 log bucket and your Amazon S3 export bucket must be in the same region. If your buckets are in different regions, your job request will fail.

For an Amazon S3 import or export job, the response includes a job ID, a signature value, and an AWS shipping address. The response also saves a SIGNATURE file to your computer.

For an Amazon EBS or Amazon Glacier import job, the response includes a job ID and shipping instructions. It also places a PDF file on your computer and in the Amazon S3 log bucket you identified in your manifest. The PDF file contains job information, shipping instructions, and a barcode.

The following examples show an import job response and an export job response.

Example import job 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

Example export job response

JOB CREATED 

********************************
* RECEIVED SUCCESSFUL RESPONSE *
********************************
jobId: ETU5V
signature: f7+7Dabe30tqvZkFFjlIOK5KUHg=
jobType: Export

*******************************************************
* signatureFileContents - write this to a file called *
* SIGNATURE in the root of your disk                  *
*******************************************************
version:2.0
signingMethod:HmacSHA1
jobId:ETU5V
signature:f7+7Dabe30tqvZkFFjlIOK5KUHg=


********************************************
* SEND YOUR STORAGE DEVICE TO THIS ADDRESS *
********************************************
AWS Import/Export
JOBID ETU5V
2646 Rainier Ave South Suite 1060
Seattle, WA 98144
United States
206-266-6868

The Getting Started section provides step-by-step examples of creating import and export jobs using the AWS Import/Export Web Services Tool.