Amazon SimpleDB Developer Guide API Version 2009-04-15 Amazon SimpleDB Developer Guide Amazon SimpleDB: Developer Guide Copyright © Amazon Web Services, Inc. and/or its affiliates. All rights reserved. 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. Amazon SimpleDB Developer Guide Table of Contents Welcome to Amazon SimpleDB ............................................................................................................ 1 Introduction to Amazon SimpleDB ....................................................................................................... 2 Features .................................................................................................................................... 2 How Amazon Charges for Amazon SimpleDB ................................................................................. 3 Storage ............................................................................................................................. 3 Data Transfer ..................................................................................................................... 3 Machine Utilization ............................................................................................................. 4 Viewing Your Bill ........................................................................................................................ 4 Amazon SimpleDB Concepts ................................................................................................................ 5 Data Model ............................................................................................................................... 5 Operations ................................................................................................................................ 6 API Summary ............................................................................................................................ 7 Consistency ............................................................................................................................... 7 Concurrent Applications ...................................................................................................... 7 Limits ..................................................................................................................................... 10 Data Set Partitioning ................................................................................................................ 11 AWS Identity and Access Management ........................................................................................ 12 Using Amazon SimpleDB ................................................................................................................... 13 Available Libraries .................................................................................................................... 13 Making API Requests ................................................................................................................ 13 Region Endpoints ............................................................................................................. 14 Making REST Requests ...................................................................................................... 14 Request Authentication ............................................................................................................. 17 What Is Authentication? .................................................................................................... 18 Creating an AWS Account .................................................................................................. 18 Managing Users of Amazon SimpleDB ................................................................................. 20 Using Temporary Security Credentials ................................................................................. 22 HMAC-SHA Signature ........................................................................................................ 23 Working with Domains .............................................................................................................. 29 Creating a Domain ........................................................................................................... 29 Verifying the Domain ........................................................................................................ 30 Deleting a Domain ........................................................................................................... 30 Working with Data ................................................................................................................... 31 Putting Data into a Domain ............................................................................................... 31 Getting Data from a Domain ............................................................................................. 32 Deleting Data from a Domain ............................................................................................ 32 Conditionally Putting and Deleting Data ..................................................................................... 33 Performing a Conditional Put ............................................................................................ 33 Performing a Conditional Delete ........................................................................................ 35 Using Select to Create Amazon SimpleDB Queries ........................................................................ 36 Comparison Operators ...................................................................................................... 37 Sample Query Data Set ..................................................................................................... 39 Simple Queries ................................................................................................................. 40 Range Queries ................................................................................................................. 40 Queries on Attributes with Multiple Values .......................................................................... 41 Multiple Attribute Queries ................................................................................................. 42 Sort ................................................................................................................................ 43 Count .............................................................................................................................. 44 Select Quoting Rules ........................................................................................................ 44 Working with Numerical Data .................................................................................................... 45 Negative Numbers Offsets ................................................................................................. 45 Zero Padding ................................................................................................................... 46 Dates .............................................................................................................................. 46 Tuning Queries ......................................................................................................................... 47 API Version 2009-04-15 iii Amazon SimpleDB Developer Guide Tuning Your Queries Using Composite Attributes .................................................................. 47 Data Set Partitioning ........................................................................................................ 48 Working with XML-Restricted Characters ..................................................................................... 49 API Reference .................................................................................................................................. 50 API Usage ................................................................................................................................ 50 API Conventions ............................................................................................................... 50 WSDL Location and API Version ......................................................................................... 50 API Error Retries ............................................................................................................... 51 Common Parameters ................................................................................................................ 52 Request Parameters .......................................................................................................... 52 Request Parameter Formats ............................................................................................... 53 Common Response Elements ..................................................................................................... 54 Common Error Responses .......................................................................................................... 54 Operations .............................................................................................................................