# Use S3-Compatible API

The OORT Storage S3 Gateway supports a API that is compatible with the basic data access model of the [Amazon S3 API](http://docs.aws.amazon.com/AmazonS3/latest/API/APIRest.html). 

### **API Endpoint**

The OORT Storage S3-Compatible API endpoint URL is:

Standard：<https://s3-standard.oortech.com>

Archive：[https://s3-archive.oortech.com](https://s3-standard.oortech.com)

### **Authentication**

OORT Storage S3-Compatible API supports AWS v4 signature (AWS4-HMAC-SHA256) for authentication, supports AWS v2 signature, v4 signature is recommended.&#x20;

### **Https Protocol**

OORT Storage 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.

### **Rate Limit**

The OORT Storage S3-Compatible API has an effective rate limit of 100 RPS (requests per second).

### **Supported API Methods**

<table><thead><tr><th width="317">Method Name</th><th>Method Description</th></tr></thead><tbody><tr><td>CreateBucket</td><td>Creates a new bucket.</td></tr><tr><td>ListBuckets</td><td>Returns a list of all buckets owned by the authenticated sender of the request.</td></tr><tr><td>DeleteBucket</td><td>Deletes the bucket. All objects in the bucket must be deleted before the bucket itself can be deleted.</td></tr><tr><td>ListObjects</td><td>Returns some or all (up to 1,000) of the objects in a bucket. We recommend that you use the newer version, ListObjectsV2</td></tr><tr><td>ListObjectsV2</td><td>Returns some or all (up to 1,000) of the objects in a bucket. </td></tr><tr><td>GetObject</td><td>Retrieves objects from OORT Storage. To use <code>GET</code>, you must have <code>READ</code> access to the object. </td></tr><tr><td>HeadObject</td><td>The HEAD action retrieves metadata from an object without returning the object itself.</td></tr><tr><td>PutObject</td><td>Adds an object to a bucket. You must have WRITE permissions on a bucket to add an object to it.</td></tr><tr><td>CopyObject</td><td>Creates a copy of an object that is already stored in OORT Storage.</td></tr><tr><td>DeleteObject</td><td>Delete an object from a bucket. If there isn't a null object, OORT Storage does not remove any objects but will still respond that the command was successful.</td></tr><tr><td>DeleteObjects</td><td>Delete an object from a bucket. If there isn't a null object, OORT Storage does not remove any objects but will still respond that the command was successful.</td></tr><tr><td>AbortMultipartUpload</td><td>This action aborts a multipart upload. After a multipart upload is aborted, no additional parts can be uploaded using that upload ID.</td></tr><tr><td>CreateMultipartUpload</td><td>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.</td></tr><tr><td>CompleteMultipartUpload</td><td>Completes a multipart upload by assembling previously uploaded parts.</td></tr><tr><td>UploadPart</td><td>Uploads a part in a multipart upload.</td></tr><tr><td>UploadPartCopy</td><td>Uploads a part by copying data from an existing object as data source.</td></tr><tr><td>GetSignedUrl</td><td>Supports pre-signed URLs for downloading and uploading objects. </td></tr></tbody></table>

When a response payload is present, all responses are returned using UTF-8 encoded XML.

**Presigned URL**

The OORT Storage 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.oortech.com/oort/oort-storage/developing-with-oort-storage/use-s3-compatible-api.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.