Use S3-Compatible API
The Oortech S3 Gateway supports a API that is compatible with the basic data access model of the Amazon S3 API.
The Oortech S3-Compatible API endpoint URL is:
Oortech S3-Compatible API supports AWS v4 signature (AWS4-HMAC-SHA256) for authentication, supports AWS v2 signature, v4 signature is recommended.
Oortech maintains strict https-only standards. This means that objects and API calls are only served over https. The port for this connection is the https standard port 443 . There is currently no way to disable this feature. Requests sent over the http protocol will be redirected to https.
The Oortech DSS S3-Compatible API has an effective rate limit of 100 RPS (requests per second).
Method Name | Method Description |
---|---|
CreateBucket | Creates a new bucket. |
ListBuckets | Returns a list of all buckets owned by the authenticated sender of the request. |
DeleteBucket | Deletes the bucket. All objects in the bucket must be deleted before the bucket itself can be deleted. |
ListObjects | Returns some or all (up to 1,000) of the objects in a bucket. We recommend that you use the newer version, ListObjectsV2 |
ListObjectsV2 | Returns some or all (up to 1,000) of the objects in a bucket. |
GetObject | Retrieves objects froo'rortech. To use GET , you must have READ access to the object. |
HeadObject | The HEAD action retrieves metadata from an object without returning the object itself. |
PutObject | Adds an object to a bucket. You must have WRITE permissions on a bucket to add an object to it. |
CopyObject | Creates a copy of an object that is already stored in Oortech. |
DeleteObject | Delete an object from a bucket. If there isn't a null object, Oortech does not remove any objects but will still respond that the command was successful. |
DeleteObjects | Delete an object from a bucket. If there isn't a null object, Oortech does not remove any objects but will still respond that the command was successful. |
AbortMultipartUpload | This action aborts a multipart upload. After a multipart upload is aborted, no additional parts can be uploaded using that upload ID. |
CreateMultipartUpload | This action initiates a multipart upload and returns an upload ID. This upload ID is used to associate all of the parts in the specific multipart upload. |
CompleteMultipartUpload | Completes a multipart upload by assembling previously uploaded parts. |
UploadPart | Uploads a part in a multipart upload. |
UploadPartCopy | Uploads a part by copying data from an existing object as data source. |
GetSignedUrl | Supports pre-signed URLs for downloading and uploading objects. |
When a response payload is present, all responses are returned using UTF-8 encoded XML.
Presigned URL
The Oortech S3-Compatible API supports pre-signed URLs for downloading and uploading objects. Presigned URLs can be generated in several ways, including the AWS CLI and AWS SDKs.
Access Control Lists (ACLs)
The Oortech S3-Compatible API has limited support for Access Control Lists (ACLs). Object-level ACLs are currently not supported. The
GetObjectAcl
and GetBucketAcl
methods will work as expected, but the response GetObjectAcl
will return the ACL of the bucket containing the object. This design eliminates the possibility of users accidentally exposing objects in private buckets. If your workflow requires a mix of private and public objects, you can simply create two different buckets.