AWS Import/Export Developer Guide API Version 2010-06-03 AWS Import/Export Developer Guide AWS Import/Export: Developer Guide Copyright © 2014 Amazon Web Services, Inc. and/or its affiliates. All rights reserved. The following are trademarks of Amazon Web Services, Inc.: Amazon, Amazon Web Services Design, AWS, Amazon CloudFront, Cloudfront, Amazon DevPay, DynamoDB, ElastiCache, Amazon EC2, Amazon Elastic Compute Cloud, Amazon Glacier, Kindle, Kindle Fire, AWS Marketplace Design, Mechanical Turk, Amazon Redshift, Amazon Route 53, Amazon S3, Amazon VPC. In addition, Amazon.com graphics, logos, page headers, button icons, scripts, and service names are trademarks, or trade dress of Amazon in the U.S. and/or other countries. Amazon©s trademarks and trade dress may not be used in connection with any product or service that is not Amazon©s, in any manner that is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon. All other trademarks not owned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored by Amazon. AWS Import/Export Developer Guide Table of Contents Welcome ..................................................................................................................................... 1 What Is AWS Import/Export? ................................................................................................... 1 Overview of AWS Import/Export ....................................................................................... 1 Advantages to AWS Import/Export ................................................................................... 2 Available Tools, Libraries, and Interfaces ............................................................................ 2 AWS Import/Export Jobs ........................................................................................................ 2 Job ............................................................................................................................. 2 Job Type ...................................................................................................................... 3 Related Concepts .......................................................................................................... 4 Pricing ................................................................................................................................. 4 Return Shipping ............................................................................................................ 5 Next Step ............................................................................................................................. 5 Getting Started ............................................................................................................................. 6 Before You Use AWS Import/Export .......................................................................................... 6 Sign Up for AWS ................................................................................................................... 7 Download the AWS Import/Export Web Service Tool .................................................................... 7 Save Your Credentials to a File ................................................................................................ 8 Create an Import Job ............................................................................................................. 9 Create Your First Amazon S3 Import Job ........................................................................... 9 Create Your First Amazon EBS Import Job ....................................................................... 13 Create Your First Amazon Glacier Import Job .................................................................... 17 Create an Export Job ........................................................................................................... 21 Create Your First Amazon S3 Export Job ......................................................................... 21 Where Do I Go from Here? .................................................................................................... 25 Working with Import Jobs .............................................................................................. 25 Working with Export Jobs .............................................................................................. 25 Managing Your Jobs ..................................................................................................... 25 Pricing Information ....................................................................................................... 25 Using IAM with AWS Import/Export ................................................................................................. 26 Controlling Access to Jobs .................................................................................................... 26 Example IAM User Policies for AWS Import/Export ............................................................ 27 Granting Access to AWS Resources ....................................................................................... 28 Working with Import Jobs .............................................................................................................. 30 Creating Amazon S3 Import Jobs ........................................................................................... 30 Import to Amazon S3 Process ........................................................................................ 30 Creating Amazon EBS Import Jobs ......................................................................................... 32 Import to Amazon EBS Process ..................................................................................... 33 Creating Amazon Glacier Import Jobs ..................................................................................... 36 Import to Amazon Glacier Process .................................................................................. 36 Creating Import Manifests ..................................................................................................... 37 Import Manifest Examples ............................................................................................. 38 Configuring Common Import Manifest Options .................................................................. 39 Working with Amazon S3 Import Manifests ....................................................................... 40 Sending CreateJob Requests ................................................................................................ 46 Sending a CreateJob Request Using the AWS Import/Export Web Service Tool ...................... 46 Sending a CreateJob Request Using the AWS SDK for Java ............................................... 48 Sending a CreateJob Request Using the REST API ........................................................... 51 Viewing Import Logs ............................................................................................................ 52 Log Files .................................................................................................................... 52 Amazon S3 and Amazon EBS Log File Fields ................................................................... 53 Amazon Glacier Log File ............................................................................................... 54 Status Codes .............................................................................................................. 54 Working with Export Jobs .............................................................................................................. 55 Creating Amazon S3 Export Jobs ........................................................................................... 55 Amazon S3 Export Process ........................................................................................... 56 API Version 2010-06-03 iii AWS Import/Export Developer Guide Creating Export Manifests .................................................................................................... 57 Export Manifest Example .............................................................................................. 57 Working with Amazon S3 Export Manifests ....................................................................... 58 Managing File Exports .................................................................................................. 59 Collecting Files That Have Naming Errors ........................................................................ 61 Viewing Import/Export Logs ................................................................................................... 61 Sample Log File .......................................................................................................... 62 Shipping Your Storage Device ........................................................................................................ 63 Storage Device Requirements ................................................................................................ 63 Preparing Your Storage Device for Amazon S3 Import and Export Jobs ......................................... 64 Copying the Signature Value .......................................................................................... 64 Filling Out the Packing Slip ............................................................................................ 65