Docs Ordnary Web Services Ordnary R2
S3 API
The endpoint, path-style addressing, signing, the region to use and what to configure in the AWS CLI and the SDKs.
Endpoint and addressing
Every request goes to https://s3.ordnary.com with the bucket as the first path segment: https://s3.ordnary.com/my-bucket/path/to/object. Virtual-hosted addressing (my-bucket.s3.ordnary.com) is not supported. See Path-style requests if your tool defaults to the hosted style.
Authentication
Requests are signed with AWS Signature Version 4 using the account's access key. Anonymous requests are refused, even for public buckets; public objects are served from the bucket's public domain instead. See Authentication.
Configure your tool
aws configure set aws_access_key_id <access-key-id>
aws configure set aws_secret_access_key <secret-access-key>
aws configure set region auto
aws configure set endpoint_url https://s3.ordnary.com
aws configure set s3.addressing_style pathimport { S3Client } from "@aws-sdk/client-s3";
const r2 = new S3Client({
region: "auto",
endpoint: "https://s3.ordnary.com",
forcePathStyle: true,
credentials: { accessKeyId: "<access-key-id>", secretAccessKey: "<secret-access-key>" },
});import boto3
from botocore.config import Config
r2 = boto3.client(
"s3",
endpoint_url="https://s3.ordnary.com",
region_name="auto",
aws_access_key_id="<access-key-id>",
aws_secret_access_key="<secret-access-key>",
config=Config(s3={"addressing_style": "path"}),
)Supported operations
The bucket and object operations tools use day to day: listing buckets and objects, putting, getting, copying, heading and deleting objects, deleting several at once, and multipart uploads. Bucket configuration such as CORS, lifecycle and lock rules is managed in the console, not over the API.
| Feature | S3 API | Console |
|---|---|---|
| List, read, write, copy, delete objects | ||
| Multipart uploads | Large file uploads (beta) | |
| Create and delete buckets | ||
| Public access, domains, CORS, lifecycle, lock | ||
| Per-object storage class | Bucket default only |
Limits
Request body
Use multipart upload for larger objects; each part may be up to 100 MB.
100 MBper request
Chunked signing
Streaming payload signing (STREAMING-AWS4-HMAC-SHA256-PAYLOAD) is refused; sign the whole payload or send it unsigned over HTTPS, which the AWS CLI and SDKs do by default.
not supportedalways