AWS Import/Export
Developer Guide (API Version 2010-06-03)
Print this pageEmail this pageGo to the ForumsView the PDFShare this page on TwitterShare this page on FacebookBookmark this page on DeliciousSubmit this page to RedditSubmit this page to DiggDid this page help you?  Yes  No   Tell us about it...

Create Your First Amazon S3 Import Job

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

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

  2. Create a manifest:

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

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

    3. If you are sending a storage device after creating this job, you must also provide your address.

      [Note]Note

      You can also change many other items in the manifest. For more information, see Manifest File Options.

    4. Save the file as MyManifest.txt in the same folder as your AWSCredentials.properties file.

  3. Send the Request:

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

    2. Enter the following CreateJob request.

      CmdPrompt>java -jar lib/AWSImportExportWebServiceTool-1.0.jar CreateJob Import MyManifest.txt .  
      [Note]Note

      The CreateJob request must provide a directory name for where you want the SIGNATURE file saved. In the above example CreateJob request, the closing period (.) at the end of the command refers to the current directory where you issue the command. Make sure you include the period, as shown above, or replace it with the name of a directory to contain the SIGNATURE file.

      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
  4. 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]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?.

Where Do I Go from Here?