Supported S3 API Operations

vCloud Director Object Storage Extension runs on top of a Cloudian HyperStore storage cluster. Both vCloud Director Object Storage Extension and Cloudian HyperStore support most AWS S3 REST API operations.

Table 1. Supported S3 API Bucket Operations
Method URL Description
HEAD https://object-storage-IP-address:443/api/v1/s3/bucket-name Verifies if a bucket exists and if you have permissions to access it.
GET https://object-storage-IP-address:443/api/v1/s3/bucket-name Returns an XML representation of the objects in a bucket.
PUT https://object-storage-IP-address:443/api/v1/s3/bucket-name Creates a bucket.
DELETE https://object-storage-IP-address:443/api/v1/s3/bucket-name Deletes a bucket.
GET https://object-storage-IP-address:443/api/v1/s3/bucket-name?tagging Returns the tag set associated with the bucket.
PUT https://object-storage-IP-address:443/api/v1/s3/bucket-name?tagging Adds tags to a bucket.
DELETE https://object-storage-IP-address:443/api/v1/s3/bucket-name?tagging Deletes the tag set associated with the bucket.
GET https://object-storage-IP-address:443/api/v1/s3/bucket-name?acl Returns the access control list (ACL) configuration of the bucket.
PUT https://object-storage-IP-address:443/api/v1/s3/bucket-name?acl Sets the ACL permissions for the bucket.
GET https://object-storage-IP-address:443/api/v1/s3/bucket-name?encryption Returns the encryption configuration for a bucket.
PUT https://object-storage-IP-address:443/api/v1/s3/bucket-name?encryption Defines an encryption method for a bucket.
DELETE https://object-storage-IP-address:443/api/v1/s3/bucket-name?encryption Removes the encryption configuration from a bucket.
GET https://object-storage-IP-address:443/api/v1/s3/bucket-name?policy Returns the policy of a bucket.
PUT https://object-storage-IP-address:443/api/v1/s3/bucket-name?policy Defines a policy for a bucket.
DELETE https://object-storage-IP-address:443/api/v1/s3/bucket-name?policy Removes a policy from a bucket.
GET https://object-storage-IP-address:443/api/v1/s3/bucket-name?uploads Returns a list of in-progress multipart uploads.
Table 2. Supported S3 API Object Operations
Method URL Description
HEAD https://object-storage-IP-address:443/api/v1/s3/bucket-name/object-name Verifies if an object exists and if you have permissions to access it.
GET https://object-storage-IP-address:443/api/v1/s3/bucket-name/object-name Retrieves an object.
PUT https://object-storage-IP-address:443/api/v1/s3/bucket-name/object-name Uploads an object to a bucket.
POST https://object-storage-IP-address:443/api/v1/s3/bucket-name/object-name Adds an object to a bucket using HTML forms.
PUT https://object-storage-IP-address:443/api/v1/s3/destination-bucket-name/destination-object-name Copies an object from one bucket to another.
DELLETE https://object-storage-IP-address:443/api/v1/s3/bucket-name/object-name Deletes an object.
DELETE https://object-storage-IP-address:443/api/v1/s3/bucket-name?delete Deletes multiple objects.
POST https://object-storage-IP-address:443/api/v1/s3/bucket-name/object-name?uploads Initiates a multipart upload.
GET https://object-storage-IP-address:443/api/v1/s3/bucket-name/object-name?MaxParts=MaxParts&PartNumberMarker=PartNumberMarker&UploadId=UploadId Lists parts that are uploaded for a specific multipart upload.
PUT https://object-storage-IP-address:443/api/v1/s3/bucket-name/object-name?PartNumber=PartNumber&UploadId=UploadId Uploads a part in a multipart upload.
PUT https://object-storage-IP-address:443/api/v1/s3/bucket-name/object-name?PartNumber=PartNumber&UploadId=UploadId Uploads a part in a multipart upload by copying data from an existing object as a data source.
POST https://object-storage-IP-address:443/api/v1/s3/bucket-name/object-name?UploadId=UploadId Completes a multipart upload by assembling previously uploaded parts.
DELETE https://object-storage-IP-address:443/api/v1/s3/bucket-name/object-name?UploadId=UploadId Aborts a multipart upload.
GET https://object-storage-IP-address:443/api/v1/s3/bucket-name/object-name?tagging Returns the tags associated with an object.
PUT https://object-storage-IP-address:443/api/v1/s3/bucket-name/object-name?tagging Adds tag or set of tags to an object.
DELETE https://object-storage-IP-address:443/api/v1/s3/bucket-name/object-name?tagging Removes the tag set from an object.
GET https://object-storage-IP-address:443/api/v1/s3/bucket-name/object-name?acl Returns the ACL configuration for the object.
PUT https://object-storage-IP-address:443/api/v1/s3/bucket-name/object-name?acl Sets an ACL for the object.