Amazon Simple Storage service (Version 2006-03-01)

Service Operations

GET Service
Returns a list of all buckets owned by the authenticated request sender.

GET / HTTP/1.1
Host: s3.amazonaws.com
Date: date
zz Authorization: AWS AWSAccessKeyId:signature

Bucket Operations

PUT Bucket
Creates a new bucket belonging to the account of the authenticated request sender. Optionally, you can specify a EU (Ireland) or US-West (N. California) location constraint.

PUT / HTTP/1.1
Host: destinationBucket.s3.amazonaws.com
Date: date
Authorization: AWS AWSAccessKeyId:signature
Content-Length: {0 | length}
[<CreateBucketConfiguration>  <LocationConstraint>EU</LocationConstraint> </CreateBucketConfiguration>]

GET Bucket
Lists information about the objects in a bucket for a user that has read access to the bucket.

GET ?prefix=prefix&marker=marker&max-keys=maxkeys&
delimiter=delimiter HTTP/1.1
Host: destinationBucket.s3.amazonaws.com
Date: date
Authorization: AWS AWSAccessKeyId:signature

GET Bucket location
Lists the location constraint of the bucket for the bucketm owner.

GET /?location HTTP/1.1
Host: destinationBucket.s3.amazonaws.com
Date: date
Authorization: AWS AWSAccessKeyId:signature

DELETE Bucket
Deletes the specified bucket. All objects in the bucket must be deleted before the bucket itself can be deleted.

DELETE / HTTP/1.1
Host: destinationBucket.s3.amazonaws.com
Date: date
Authorization: AWS AWSAccessKeyId:signature

POST Object
For more information about POST, refer to the Amazon Simple Storage Service Developer Guide.

Object Operations

GET Object
Gets an object for a user that has read access to the object.

GET /destinationObject HTTP/1.1
Host: destinationBucket.s3.amazonaws.com
Date: date
Authorization: AWS AWSAccessKeyId:signature
[Range:bytes=byte_range]
[x-amz-metadata-directive: metadata_directive]
[x-amz-if-match: etag]
[x-amz-if-none-match: etag]
[x-amz-if-unmodified-since: time_stamp]
[x-amz-if-modified-since: time_stamp]

PUT Object
Adds an object to a bucket for a user that has write access to the bucket. A success response indicates the object was successfully stored; if the object already exists, it will be overwritten.

PUT /destinationObject HTTP/1.1
Host: destinationBucket.s3.amazonaws.com
Date: date
Authorization: AWS AWSAccessKeyId:signature
Content-Length: length
Content-MD5: md5_digest
Content-Type: type
Content-Disposition: object_information
Content-Encoding: encoding
Cache-Control: caching
Expires: expiration
<request metadata>

COPY Object
Copies an object for a user that has write access to the bucket and read access to the object. All headers prefixed with x-amz- must be signed, including x-amz-copy-source.

PUT /destinationObject HTTP/1.1
Host: destinationBucket.s3.amazonaws.com
Date: date
Authorization: AWS AWSAccessKeyId:signature
x-amz-copy-source: /source_bucket/sourceObject
[x-amz-metadata-directive: metadata_directive]
[x-amz-copy-source-if-match: etag]
[x-amz-copy-source-if-none-match: etag]
[x-amz-copy-source-if-unmodified-since:
time_stamp]
[x-amz-copy-source-if-modified-since: time_stamp]
<request metadata>

HEAD Object
Retrieves information about an object for a user with read access without fetching the object.

HEAD /destinationObject HTTP/1.1
Host: destinationBucket.s3.amazonaws.com
Date: date
Authorization: AWS AWSAccessKeyId:signature

DELETE Object
Deletes the specified object. Once deleted, there is no method to restore or undelete an object.

DELETE / HTTP/1.1
Host: destinationBucket.s3.amazonaws.com
Date: date
Authorization: AWS AWSAccessKeyId:signature

POST Object
Adds an object to a bucket using forms.

POST / HTTP/1.1
Host: destinationBucket.s3.amazonaws.com
User-Agent: browser_data
Accept: file_types
Accept-Language: locales
Accept-Encoding: encoding
Accept-Charset: character_set
Keep-Alive: 300
Connection: keep-alive
Content-Type: multipart/form-data; boundary=----------ID
Content-Length: length
<multiform_data>
Note: For more information about the multiform data, refer to the Amazon Simple Storage Service Developer Guide.