download free 30 days trial version buy bucket explorer
Documentation  Download  Purchase  Support  FAQs   Forum   ScreenShots & Demos

Amazon S3 Operations (REST Requests) on Buckets and Objects


REST Interface
Amazon S3 provides simple, standard-based REST web services interfaces that can work with any Internet toolkit. These operations are made simple so one can add new distribution protocols and functional layers easier.

REST Request
  1. Operations on Buckets - These are operations that you can perform on Amazon S3 Buckets.
    • DELETE Bucket : This operation deletes the bucket named in the URI. When deleting the bucket, you need to first delete all the objects in it including all version objects and Delete Markers.
    • DELETE Bucket cors : This operation deletes the cors configuration information set for the bucket.
    • DELETE Bucket lifecycle : This operation deletes the lifecycle configuration from the specified bucket.
    • DELETE Bucket policy : This operation uses the policy subresource to delete the policy set on a specified bucket.
    • DELETE Bucket tagging : This operation removes a tag set from the specified bucket using tagging subresource.
    • DELETE Bucket website : You use this operation to remove the website configuration for a bucket.
    • GET Bucket (List Objects) : This operation list some or all (up to 1000) the objects in the bucket.
    • GET Bucket acl : This operation returns the access control list (ACL) of a bucket using acl subresource. To get Bucket ACL, you must have READ_ACP access to the Bucket.
    • GET Bucket cors : This operation returns the cors configuration information set for the bucket.
    • GET Bucket lifecycle : This operation returns the lifecycle configuration set on the bucket.
    • GET Bucket policy : This operation returns the policy set on the specified bucket using the policy subresource.
    • GET Bucket location : This operation returns the bucket's Region using location subresource.
    • GET Bucket logging : This operation returns the logging status of a bucket and the permissions that users have to be able to view and modify that status using logging subresource.
    • GET Bucket notification : This operation returns the notification configuration set on a bucket using notification subresource.
    • GET Bucket tagging : This operation returns the tag set associated with the bucket using tagging subresource.
    • GET Bucket Object versions : This operation lists the metadata of all the versions of the objects in the bucket using versions subresource.
    • GET Bucket requestPayment : This operation returns the request payment configuration of a bucket using requestPayment subresource.
    • GET Bucket versioning : This operation returns the versioning state of a bucket using versioning subresource.
    • GET Bucket website : This operation returns the website configuration associated with a bucket using website subresource.
    • HEAD Bucket : This operation is used to determine if a bucket exists and if you have permission to access it.
    • List Multipart Uploads : This operation lists multipart upload that has been initiated but not yet completed or aborted using the Initiate Multipart Upload request.
    • PUT Bucket : This operation creates a new bucket in which you need to register first with Amazon S3 and have a valid AWS Access Key ID to authenticate the request.
    • PUT Bucket acl : This operation uses the acl subresource to set the permissions on an existing bucket using access control list (ACL).
    • PUT Bucket cors : This operation sets the cors configuration for your bucket in which if the configuration already exists, Amazon S3 replaces it.
    • PUT Bucket lifecycle : This operation creates a new lifecycle configuration for a bucket or replaces the existing lifecycle configuration.
    • PUT Bucket policy : This operation adds or replace a policy on the bucket using policy subresource.
    • PUT Bucket logging : This operation sets the logging parameters for a bucket using logging subresource and specify permissions for who can view and modify the logging parameters.
    • PUT Bucket notification : This operation enables notifications of specified events for a bucket using notification subresource.
    • PUT Bucket tagging : This operation adds a set of tags to an existing bucket using tagging subresource.
    • PUT Bucket requestPayment : This operation sets the request payment configuration of a bucket using requestPayment subresource.
    • PUT Bucket versioning : This operation sets the versioning state of a bucket as Enabled or Suspended using versioning subresource.
    • PUT Bucket website : This operation sets the configuration of the website specified in the website subresource.
  2. Operations on Objects - These are operations that you can perform on Amazon S3 Objects
    • DELETE Object : This operation removes the null version of an object, if there is one. If there is no null version, Amazon S3 will not remove any object. This operation also inserts a delete marker which will eventually become the latest version of the object.

      For Versioning, you need to be the owner of the bucket and must use the versionId subresource to remove a specific version.
      Amazon S3 also sets the response header x-amz-delete-marker to true if the object deleted is a delete marker.
      To delete an object in a bucket where bucket versioning configuration is MFA Delete enabled, x-amz-mfa request header in the DELETE versionId request must be included.

    • Delete Multiple Objects : This operation allows you to delete multiple objects from a bucket using a single HTTP request.
    • GET Object : This operation lists the objects from Amazon S3. To use this request, you must have READ permission on the object.
    • GET Object ACL : This operation returns the access control list (ACL) of an object using acl subresource.
    • GET Object torrent : This operation returns torrent files from a bucket using torrent subresource.
    • HEAD Object : Without returning the object itself, this operation retrieves the metadata from an object.
    • OPTIONS Object : This operation determines if it can send an actual request with the specific origin, HTTP method, and headers.
    • POST Object : Using HTML forms, this operation adds an object to a specific bucket.
    • POST Object restore : This operation restores a temporary copy of an archived object in which you will specify the number of days that you want the restored copy to exist.
    • PUT Object : This operation adds an object to a bucket.
    • PUT Object acl : This operation sets the access control list (ACL) permissions of an object that already exists in the bucket using acl subresource.
    • PUT Object - Copy : This operation creates a copy of an object stored in Amazon S3.
    • Initiate Multipart Upload : This operation initiates a multipart upload. It also returns an upload ID that is used to associate all the parts in the specific multipart upload.
    • Upload Part : If you want to upload a part in a multipart upload, use this operation.
    • Upload Part - Copy : By copying data from an existing object as data source, you can upload a part using this operation.
    • Complete Multipart Upload : By assembling previously uploaded parts, you can complete a multipart upload using this operation.
    • Abort Multipart Upload : This operation aborts a multipart upload in which no additional parts can be uploaded using the same upload ID.
    • List Parts : Use this operation to lists the parts that have been uploaded for a specific multipart upload.

SOAP Interface
The SOAP API provides a SOAP 1.1 interface using literal encoding document. To use SOAP, you need to download the WSDL and use SOAP toolkit like Microsoft .NET to create bindings, and then you can write a code that uses the bindings to call Amazon S3.