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.

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
	Please use GetShippingLabel API endpoint to print your shipping label.

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=

Please use GetShippingLabel API endpoint to print your shipping label.

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