Amazon Simple Stora ge Ser vice - Amazon Web Services

1 Amazon Simple storage ServiceAPI ReferenceAPI Version 2006-03-01 Amazon Simple storage Service: API ReferenceCopyright 2014 Amazon Web Services , Inc. and/or its affiliates. All rights 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, KindleFire, AWS Marketplace Design, Mechanical Turk, Amazon Redshift, Amazon Route 53, Amazon S3, Amazon VPC. In addition, graphics, logos, page headers, button icons, scripts, and service names are trademarks, or trade dress of Amazon inthe and/or other countries. Amazon 's trademarks and trade dress may not be used in connection with any product or service thatis not Amazon 's, in any manner that is likely to cause confusion among customers, or in any manner that disparages or other trademarks not owned by Amazon are the property of their respective owners, who may or may not be affiliated with, connectedto, or sponsored by Simple storage Service API ReferenceTable of ContentsWelcome to Amazon 1 How Do 2 Error 3 List of Error 3 REST Error 9 REST 11 Common Request 12 Common Response 14 Authenticating Requests (AWS Signature Version 4).

2 15 Authentication 16 Introduction to Signing 16 Using an Authorization 17 Using Query 38 Examples: Signature 43 Authenticating HTTP POST 45 Amazon S3 Signature Version 4 Authentication Specific Policy 47 Browser-Based Uploads Using 51 Calculating a Signature .. 52 Creating HTML Forms .. 52 Creating a POST 56 Upload 61 Additional 64 Operations on the 65 GET 65 Operations on 68 DELETE 69 DELETE Bucket 71 DELETE Bucket 73 DELETE Bucket 75 DELETE Bucket 77 DELETE Bucket 79 GET Bucket (List Objects).. 81 GET Bucket 89 GET Bucket 92 GET Bucket 95 GET Bucket 101 GET Bucket 103 GET Bucket 105 GET Bucket 108 GET Bucket 111 GET Bucket Object 114 GET Bucket 126 GET Bucket 128 GET Bucket 131 HEAD 133 List Multipart 135 PUT 144 PUT Bucket 150 PUT Bucket 157 PUT Bucket 162 PUT Bucket 171 PUT Bucket 173 PUT Bucket 178 PUT Bucket 182 API Version 2006-03-01iiiAmazon Simple storage Service API ReferencePUT Bucket 185 PUT Bucket 187 PUT Bucket 191 Operations on 198 DELETE 200 Delete Multiple 203 GET 212 GET Object 222 GET Object 226 HEAD 228 OPTIONS 235 POST 238 POST Object 247 PUT 250 PUT Object 262 PUT Object - Copy.

3 269 Initiate Multipart 282 Upload Part .. 290 Upload Part - Copy .. 295 Complete Multipart 302 Abort Multipart 308 List Parts .. 315 Document History .. 323 Operations on the 323 Operations on 333 Operations on 349 SOAP Error 350 Glossary .. 352 API Version 2006-03-01ivAmazon Simple storage Service API ReferenceWelcome to Amazon S3 This is the Amazon Simple storage Service API Reference. It explains the Amazon Simple storage Service( Amazon S3) application programming interface. It describes various API operations, related request andresponse structures, and error S3 is a web service that enables you to store data in the can then download the dataor use the data with other AWS Services , such as Amazon Elastic Compute Cloud ( Amazon EC2). Forinformation about Amazon EC2, see Amazon EC2).How Do SectionsInformationAmazon Simple storage Service ( Amazon S3)General product overview and pricingREST API (p. 11)List of REST operationsAppendix: SOAP API (p.

4 323)List of SOAP operationsList of Error Codes (p. 3) Amazon S3 error codes and descriptionsAPI Version 2006-03-011 Amazon Simple storage Service API ReferenceHow Do S3 API ReferenceIntroductionThis application programming interface reference explains Amazon S3 operations, their parameters, re-sponses, and errors. There are separate sections for the REST and SOAP APIs, which include examplerequests and location of the latest Amazon S3 WSDL is support over HTTP is deprecated, but it is still available over HTTPS. New Amazon S3features will not be supported for SOAP. We recommend that you use either the REST API orthe AWS SDKsAPI Version 2006-03-012 Amazon Simple storage Service API ReferenceError ResponsesThis section provides reference information about Amazon S3 support over HTTP is deprecated, but it is still available over HTTPS. New Amazon S3features will not be supported for SOAP. We recommend that you use either the REST API orthe AWS List of Error Codes (p.

5 3) REST Error Responses (p. 9)List of Error CodesThe following table lists Amazon S3 error CodeClient403 ForbiddenAccess DeniedAccessDeniedClient403 ForbiddenThere is a problem with your AWSaccount that prevents the operationfrom completing successfully. Pleaseuse Contact BadRequestThe email address you provided isassociated with more than BadRequestThe Content-MD5 you specified didnot match what we Version 2006-03-013 Amazon Simple storage Service API ReferenceList of Error CodesSOAPF aultCodePrefixHTTPS tatusCodeDescriptionError CodeClient409 ConflictThe requested bucket name is notavailable. The bucket namespace isshared by all users of the select a different name and (inall regionsexcept USStandard).Your previous request to create thenamed bucket succeeded and youalready own get this error in allAWS regions except US Standard,us-east-1. In us-east-1 region, you willget 200 OK, but it is no-op (if bucketexists it Amazon S3 will not doanything).

6 BucketAlreadyOwnedByYouClient409 ConflictThe bucket you tried to delete is BadRequestThis request does not logging not in one geographic locationcannot log information to a bucket inanother BadRequestYour proposed upload is smaller thanthe minimum allowed object BadRequestYour proposed upload exceeds themaximum allowed object BadRequestThe provided token has BadRequestIndicates that the versioningconfiguration specified in the requestis BadRequestYou did not provide the number ofbytes specified by the Content-LengthHTTP headerIncompleteBodyClient400 BadRequestPOST requires exactly one file uploadper BadRequestInline data exceeds the maximumallowed encountered an internal try Version 2006-03-014 Amazon Simple storage Service API ReferenceList of Error CodesSOAPF aultCodePrefixHTTPS tatusCodeDescriptionError CodeClient403 ForbiddenThe AWS access key Id you provideddoes not exist in our must specify the Anonymous BadRequestInvalid ArgumentInvalidArgumentClient400 BadRequestThe specified bucket is not request is not valid with thecurrent state of the BadRequestThe Content-MD5 you specified is BadRequestThe encryption request you specifiedis not valid value is BadRequestThe specified location constraint is notvalid.

7 For more information aboutRegions, see How to Select a Regionfor Your operation is not valid for thecurrent state of the BadRequestOne or more of the specified partscould not be part might nothave been uploaded, or the specifiedentity tag might not have matched thepart's entity BadRequestThe list of parts was not in list must specified in orderby part access to this object has BadRequestThe content of the form does not meetthe conditions specified in the NotSatisfiableThe requested range cannot BadRequestSOAP requests must be made overan HTTPS provided security credentials arenot Version 2006-03-015 Amazon Simple storage Service API ReferenceList of Error CodesSOAPF aultCodePrefixHTTPS tatusCodeDescriptionError CodeClient400 BadRequestThe SOAP request body is BadRequestThe storage class you specified is BadRequestThe target bucket for logging does notexist, is not owned by you, or does nothave the appropriate grants for thelog-delivery BadRequestThe provided token is malformed orotherwise BadRequestCouldn't parse the specified BadRequestYour key is too BadRequestThe XML you provided was notwell-formed or did not validate againstour published BadRequestThe body of your POST request is notwell-formed BadRequestThis happens when the user sendsmalformed xml (xml that doesn'tconform to the published xsd) for error message is,"The XML you provided was notwell-formed or did not validate againstour published schema.

8 "MalformedXMLC lient400 BadRequestYour request was too BadRequestYour POST request fields precedingthe upload file were too BadRequestYour metadata headers exceed themaximum allowed metadata specified method is not allowedagainst this SOAP attachment was expected,but none were must provide the Content-LengthHTTP Version 2006-03-016 Amazon Simple storage Service API ReferenceList of Error CodesSOAPF aultCodePrefixHTTPS tatusCodeDescriptionError CodeClient400 BadRequestThis happens when the user sends anempty xml document as a error message is, "Request bodyis empty."MissingRequestBodyErrorClient400 BadRequestThe SOAP request is missing asecurity BadRequestYour request is missing a BadRequestThere is no such thing as a loggingstatus subresource for a NotFoundThe specified bucket does not NotFoundThe specified key does not NotFoundThe lifecycle configuration does NotFoundThe specified multipart upload doesnot upload ID might beinvalid, or the multipart upload mighthave been aborted or NotFoundIndicates that the version ID specifiedin the request does not match anexisting NotImplementedA header you provided impliesfunctionality that is not account is not signed up for theAmazon S3 service.

9 You must sign upbefore you can use Amazon sign up at the following URL: NotFoundThe specified bucket does not have abucket conflicting conditional operation iscurrently in progress against thisresource. Try bucket you are attempting toaccess must be addressed using thespecified endpoint. Send all futurerequests to this least one of the preconditions youspecified did not Version 2006-03-017 Amazon Simple storage Service API ReferenceList of Error CodesSOAPF aultCodePrefixHTTPS tatusCodeDescriptionError CodeClient307 MovedTemporarilyTemporary restore is already in BadRequestBucket POST must be of theenclosure-type BadRequestYour socket connection to the serverwas not read from or written to withinthe timeout difference between the requesttime and the server's time is too BadRequestRequesting the torrent file of a bucketis not request signature we calculateddoes not match the signature youprovided. Check your AWS secretaccess key and signing method.

10 Formore information, see RESTA uthentication and SOAPA uthentication for your request SlowDownReduce your request are being redirected to the bucketwhile DNS BadRequestThe provided token must be BadRequestYou have attempted to create morebuckets than BadRequestThis request does not support BadRequestThe email address you provided doesnot match any account on BadRequestThe bucket POST must contain thespecified field name. If it is specified,check the order of the Version 2006-03-018 Amazon Simple storage Service API ReferenceList of Error CodesREST Error ResponsesWhen there is an error, the header information contains: Content-Type: application/xml An appropriate 3xx, 4xx, or 5xx HTTP status codeThe body or the response also contains information about the error. The following sample error responseshows the structure of response elements common to all REST error responses.<?xml version=" " encoding="UTF-8"?> <Error> <Code>NoSuchKey</Code> <Message>The resource you requested does not exist</Message> <Resource>/ </Resource> <RequestId>4442587FB7D0A2F9</RequestId> </Error>The following table explains the REST error response elementsDescriptionNameThe error code is a string that uniquely identifies an error condition.