Amazon Simple Storage Service - AWS Documentation

1 Amazon Simple Storage ServiceAPI ReferenceAPI Version 2006-03-01 Amazon Simple Storage Service API ReferenceAmazon Simple Storage Service : API ReferenceCopyright 2018 Amazon Web services , Inc. and/or its affiliates. All rights 's trademarks and trade dress may not be used in connection with any product or Service that is not Amazon 's, in any mannerthat is likely to cause confusion among customers, or in any manner that disparages or discredits Amazon . All other trademarks notowned by Amazon are the property of their respective owners, who may or may not be affiliated with, connected to, or sponsored Simple Storage Service API ReferenceTable of ContentsAmazon S3 REST API Introduction .. 1 Common Request Headers .. 2 Common Response Headers .. 4 Error Responses .. 6 REST Error Responses .. 6 List of Error Codes .. 7 Authenticating Requests (AWS Signature Version 4).

2 14 Authentication 15 Introduction to Signing Requests .. 15 Using an Authorization 16 Overview .. 16 Signature Calculation: Transfer Payload in a Single Chunk .. 18 Signature Calculation: Transfer Payload in Multiple Chunks .. 29 Using Query Parameters .. 36 Calculating a Signature .. 38An 40 Examples: Signature Calculations .. 41 Signature Calculation Examples Using Java .. 41 Signature Calculation Examples Using C# .. 42 Authenticating HTTP POST Requests .. 43 Calculating a Signature .. 44 Amazon S3 Signature Version 4 Authentication Specific Policy Keys .. 45 Bucket Policy Examples Using Signature Version 4 Related Condition Keys .. 47 Browser-Based Uploads Using POST .. 49 Browser-Based Uploads Using HTTP POST .. 49 Calculating a Signature .. 50 Creating HTML Forms .. 51 HTML Form Declaration .. 52 HTML Form Fields .. 52 Creating a POST Policy.

3 56 Condition 57 Character Escaping .. 59 POST Upload Example .. 61 Uploading a File to Amazon S3 Using HTTP POST .. 61 Using POST with Adobe Flash .. 63 Using POST with Adobe Flash .. 63 Browser-Based Uploads Using AWS Amplify .. 63 Using the AWS Amplify JavaScript library to Upload Files to Amazon S3 .. 64 More Info .. 64 Operations on the Service .. 65 GET Service .. 65 Requests .. 65 Responses .. 67 Related Resources .. 67 Operations on Buckets .. 68 DELETE Bucket .. 70 Requests .. 70 Responses .. 70 API Version 2006-03-01iiiAmazon Simple Storage Service API ReferenceRelated Resources .. 71 DELETE Bucket analytics .. 72 Requests .. 72 Responses .. 73 Related Resources .. 73 DELETE Bucket cors .. 74 Requests .. 74 Responses .. 74 Related Resources .. 75 DELETE Bucket encryption .. 76 Requests .. 76 Responses .. 76 Related Resources.

4 77 DELETE Bucket inventory .. 78 Requests .. 78 Responses .. 79 Related Resources .. 79 DELETE Bucket lifecycle .. 80 Requests .. 80 Responses .. 81 Related Resources .. 81 DELETE Bucket metrics .. 81 Requests .. 81 DELETE Bucket policy .. 84 Requests .. 84 Responses .. 85 Related Resources .. 85 DELETE Bucket replication .. 86 Requests .. 86 Responses .. 86 Related Resources .. 87 DELETE Bucket tagging .. 88 Requests .. 88 Responses .. 88 Related Resources .. 89 DELETE Bucket website .. 90 Requests .. 90 Responses .. 91 API Version 2006-03-01ivAmazon Simple Storage Service API ReferenceRelated Resources .. 91 GET Bucket (List Objects) Version 2 .. 92 Requests .. 92 Responses .. 97 More Info .. 101 GET Bucket (List Objects) Version 1 .. 102 GET Bucket accelerate .. 111 Requests .. 111 Responses .. 112 Related Resources.

5 113 GET Bucket acl .. 114 Requests .. 114 Responses .. 116 Related Resources .. 116 GET Bucket analytics .. 117 Requests .. 117 Responses .. 120 Related Resources .. 121 GET Bucket cors .. 122 Requests .. 122 Responses .. 122 Special Errors .. 124 Related Resources .. 125 GET Bucket encryption .. 126 Requests .. 126 Responses .. 128 Related Resources .. 129 GET Bucket Inventory .. 130 Requests .. 130 Responses .. 134 Related Resources .. 135 GET Bucket lifecycle .. 136 Requests .. 136 Responses .. 136 Special Errors .. 141 Related Resources .. 142 GET Bucket location .. 143 Requests .. 143 GET Bucket logging .. 145 API Version 2006-03-01vAmazon Simple Storage Service API ReferenceRequests .. 145 Responses .. 147 Related Resources .. 147 GET Bucket metrics .. 148 Requests .. 148 Responses .. 150 Related Resources.

6 151 GET Bucket notification .. 152 Requests .. 152 Responses .. 155 Related Resources .. 156 GET Bucket Object versions .. 157 Requests .. 157 Responses .. 162 Related Resources .. 168 GET Bucket policy .. 169 Requests .. 169 Responses .. 170 Related Resources .. 170 GET Bucket replication .. 171 Requests .. 171 Responses .. 171 Special Errors .. 175 Related Resources .. 175 GET Bucket requestPayment .. 176 Requests .. 176 Responses .. 177 Related Resources .. 177 GET Bucket tagging .. 178 Requests .. 178 Responses .. 179 Related Resources .. 180 GET Bucket versioning .. 181 Requests .. 181 Responses .. 182 Related Resources .. 183 GET Bucket website .. 184 Requests .. 184 Responses .. 184 API Version 2006-03-01viAmazon Simple Storage Service API 185 Related Resources .. 185 HEAD Bucket .. 186 Requests.

7 186 Responses .. 187 List Bucket Analytics Configurations .. 188 Requests .. 188 Responses .. 190 Related Resources .. 191 List Bucket Inventory Configurations .. 192 Requests .. 192 Responses .. 194 Related Resources .. 196 List Bucket Metrics Configurations .. 197 Requests .. 197 Responses .. 198 Related Resources .. 199 List Multipart Uploads .. 200 Requests .. 200 Responses .. 205 Related Actions .. 208 PUT Bucket .. 209 Requests .. 212 Related Resources .. 213 PUT Bucket accelerate .. 214 Requests .. 214 Responses .. 215 Related Resources .. 216 PUT Bucket acl .. 217 Requests .. 217 Responses .. 221 Related Resources .. 223 PUT Bucket analytics .. 224 Requests .. 224 Responses .. 228 Related Resources .. 229 PUT Bucket cors .. 230 Requests .. 231 API Version 2006-03-01viiAmazon Simple Storage Service API ReferenceResponses.

8 234 Related Resources .. 234 PUT Bucket encryption .. 236 Requests .. 236 Responses .. 238 Related Resources .. 239 PUT Bucket inventory .. 240 Requests .. 240 Responses .. 245 Related Resources .. 246 PUT Bucket lifecycle .. 247 Requests .. 247 Responses .. 256 Related Resources .. 258 PUT Bucket logging .. 259 Requests .. 259 Responses .. 262 Related Resources .. 263 PUT Bucket metrics .. 263 Requests .. 263 Responses .. 266 Related Resources .. 267 PUT Bucket notification .. 268 Requests .. 268 Responses .. 273 Related Resources .. 275 PUT Bucket policy .. 276 Requests .. 276 Responses .. 277 Related Resources .. 277 PUT Bucket replication .. 278 Requests .. 278 Responses .. 284 Related Resources .. 285 PUT Bucket requestPayment .. 287 Requests .. 287 Responses .. 288 Related Resources .. 288 API Version 2006-03-01viiiAmazon Simple Storage Service API ReferencePUT Bucket tagging.

9 289 Requests .. 289 Responses .. 290 Related Resources .. 291 PUT Bucket versioning .. 292 Requests .. 292 Responses .. 294 Related Resources .. 295 PUT Bucket website .. 296 Requests .. 296 Responses .. 301 Operations on Objects .. 305 Delete Multiple Objects .. 305 Requests .. 306 Responses .. 310 Related Actions .. 313 DELETE Object .. 315 Requests .. 315 Responses .. 316 Related Resources .. 318 DELETE Object tagging .. 319 Requests .. 319 Responses .. 319 Related Resources .. 320 GET Object .. 321 Versioning .. 322 Requests .. 322 Responses .. 328 Related Resources .. 332 GET Object ACL .. 333 Versioning .. 333 Requests .. 333 Responses .. 335 Related Resources .. 336 GET Object tagging .. 337 Requests .. 337 Responses .. 338 Related Resources .. 339 GET Object torrent .. 340 API Version 2006-03-01ixAmazon Simple Storage Service API 340 Requests.

10 340 Responses .. 341 Related Resources .. 341 HEAD Object .. 342 Versioning .. 342 Requests .. 342 Responses .. 348 Sample Request for an Amazon Glacier Object .. 349 Sample Response - Glacier Object .. 349 Related Resources .. 350 OPTIONS object .. 351 Requests .. 351 Responses .. 353 Related Resources .. 353 POST Object .. 354 Versioning .. 354 Requests .. 364 Related Resources .. 364 POST Object restore .. 366 Querying Archives with Select Requests .. 366 Restoring Archives .. 367 Requests .. 368 Responses .. 378 More Info .. 380 PUT Object .. 381 Versioning .. 381 Storage Class 381 Access Permissions .. 381 Requests .. 382 Responses .. 390 Related Resources .. 394 PUT Object - Copy .. 395 Versioning .. 396 Access Permissions .. 396 Requests .. 396 Responses .. 408 Related Resources .. 410 PUT Object acl .. 411 Versioning.