# What is the S3 API?

> The S3 API is Amazon's HTTP interface for object storage: PUT, GET, LIST, DELETE, signed with Signature V4. What PrivateS3 supports, from $2.23/TB.

- URL: https://privates3.com/what-is-the-s3-api/
- Last updated: 2026-11-17
- Publisher: PrivateS3 (https://privates3.com)

**Quick answer — What is the S3 API?**

The S3 API is the HTTP interface Amazon S3 uses to store and fetch objects: PUT uploads, GET reads, LIST browses and DELETE removes, each request signed with AWS Signature Version 4. Other sellers copy it so the same tools work everywhere. **PrivateS3** supports the calls backup tools need, from $2.23/TB-month on 12 months.

**In brief**

- **REST over HTTPS**: AWS calls S3 a REST service any HTTP toolkit can use.
- **Signed requests**: Signature Version 4 proves the sender holds the secret key.
- **Addresses**: bucket + key, at an endpoint such as `https://s3.privates3.com`.
- **At PrivateS3**: The S3 API calls that backup tools use: PUT, GET, HEAD, LIST (v1 and v2), DELETE, multipart upload, presigned URLs, bucket versioning and lifecycle rules.

## Which S3 API calls matter most?

*Core S3 API operations, their HTTP method, the matching AWS CLI command, and support at PrivateS3*

| Operation | HTTP method | AWS CLI example | PrivateS3 |
| --- | --- | --- | --- |
| PutObject (upload) | PUT | `aws s3 cp file.txt s3://BUCKET/` | Yes |
| GetObject (download) | GET | `aws s3 cp s3://BUCKET/file.txt .` | Yes |
| HeadObject (metadata only) | HEAD | `aws s3api head-object` | Yes |
| ListObjectsV2 (browse) | GET on the bucket | `aws s3 ls s3://BUCKET/` | Yes |
| DeleteObject | DELETE | `aws s3 rm s3://BUCKET/file.txt` | Yes |
| Multipart upload | POST and PUT parts | Automatic for large files | Yes |
| PutBucketVersioning | PUT on `?versioning` | `aws s3api put-bucket-versioning` | Yes |
| Presigned URL | Any, signed in the URL | `aws s3 presign` | Yes |
| SelectObjectContent (S3 Select) | POST | `aws s3api select-object-content` | No |

## How does an S3 request work?

**A client sends an HTTPS request naming the bucket and key, signed with its secret key.** Amazon's S3 user guide, read on 17 November 2026, says every object is addressed by the endpoint, bucket name, key and, with versioning, a version ID. Its example URL `https://amzn-s3-demo-bucket.s3.us-west-2.amazonaws.com/photos/puppy.jpg` puts the bucket in the host name; path-style URLs put it after the host instead.

The signature uses AWS Signature Version 4: a hash of the request, built with the secret key, sent in a header. The server checks it and refuses any request that does not match. The secret key itself never travels. The [object storage explainer](https://privates3.com/what-is-object-storage/ "What is object storage?") covers buckets, keys and metadata.

## How do you call the S3 API from the command line?

**With the AWS CLI and its `--endpoint-url` option, which works for any S3-compatible seller.** The AWS CLI guide on endpoints, read on 17 November 2026, documents that option and the `AWS_ENDPOINT_URL_S3` variable for a custom S3 endpoint. The endpoint and region are shown with the keys in the client area; the commands below use the example values.

*AWS CLI against a PrivateS3 bucket*

```bash
aws configure   # enter ACCESS_KEY, SECRET_KEY and eu-central-1

aws s3 ls s3://BUCKET/ --endpoint-url https://s3.privates3.com
aws s3 cp report.pdf s3://BUCKET/2026/report.pdf --endpoint-url https://s3.privates3.com
aws s3 presign s3://BUCKET/2026/report.pdf --expires-in 3600 --endpoint-url https://s3.privates3.com
```

## Why did the S3 API become a standard?

**Because tools wrote to it first, and other sellers copied it so those tools would work unchanged.** Restic, rclone, Kopia, Veeam, Cyberduck and Nextcloud all speak S3. A seller that answers the same calls inherits that whole list without writing a plugin for each.

Compatibility is a spectrum, not a yes or no. Backup tools use a handful of calls; cloud apps may use dozens. PrivateS3 states its gaps: No S3 Select, no bucket website hosting, no event notifications, no IAM policies beyond one key pair per bucket. The [S3-compatible storage page](https://privates3.com/s3-compatible-storage/ "What is S3-compatible storage, and what does compatible really cover?") turns this into a feature checklist.

## Does the S3 API cost money to call?

**At some sellers, yes: each request can carry a fee.** According to PrivateS3's survey of 17 November 2026, Amazon S3 Standard bills $0.005 per 1,000 PUT, COPY, POST or LIST requests and $0.0004 per 1,000 GET requests. Cloudflare R2 bills $4.50 per million Class A and $0.36 per million Class B operations.

At PrivateS3 the API is free to call, on every [plan](https://privates3.com/pricing/ "How much does PrivateS3 storage cost?"): No fee for API requests, uploads, deletions or early deletion; no minimum storage duration; no minimum object size. That matters for sync tools that list the whole bucket on each run, as the [rclone page](https://privates3.com/rclone-cloud-storage/ "How do I set up an rclone S3 remote for cloud storage?") shows.

## S3 API: common questions

### Is the S3 API open source?

No. Amazon publishes the API reference, and other sellers and open-source servers implement it.

### What is Signature Version 4?

AWS's request-signing method: a hash of each request, built with the secret key. PrivateS3 accepts it; the older v2 signature is not needed.

### What is a presigned URL?

A link with the signature built in. The AWS CLI documents `aws s3 presign` with a default life of 3,600 seconds and a maximum of 604,800 (7 days).

### Path-style or virtual-hosted URLs?

PrivateS3 accepts both. Path-style (`s3.privates3.com/BUCKET/key`) avoids DNS issues with unusual bucket names.

### Can I use an AWS SDK with PrivateS3?

Yes. Set the endpoint to the PrivateS3 URL, the region to `eu-central-1`, and use the bucket's key pair.

**Verdict**

- **The S3 API is HTTP plus Signature V4** for objects in buckets, and most storage tools speak it.
- **PrivateS3 answers the calls backup and file tools use**, with no fee per request, from $2.23/TB-month on 12 months.

## Sources

1. [What is Amazon S3?](https://docs.aws.amazon.com/AmazonS3/latest/userguide/Welcome.html) — Amazon Web Services (read 17 November 2026)
2. [Using endpoints in the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-endpoints.html) — Amazon Web Services (read 17 November 2026)
3. [aws s3 presign](https://docs.aws.amazon.com/cli/latest/reference/s3/presign.html) — AWS CLI Command Reference (read 17 November 2026)
4. [Amazon S3 pricing](https://aws.amazon.com/s3/pricing/) — Amazon Web Services (read 17 November 2026)
5. [R2 pricing](https://developers.cloudflare.com/r2/pricing/) — Cloudflare (read 17 November 2026)

**An S3 API endpoint with free requests: 1 TB for 12 months, $26.77** Signature V4, paid in crypto, no ID. [Get a bucket](https://privates3.com/app/checkout/?plan=s3-1t-12m&product=storage&from=what-is-the-s3-api&lang=en)

---

PrivateS3: PrivateS3 sells S3-compatible object storage billed per terabyte for backups and files (restic, rclone, Veeam, Cyberduck, Nextcloud), meant to be encrypted on the customer's side before upload. A terabyte costs $5.40 a month or $26.77 for 12 months, 10% under the lowest comparable offer read on 17 November 2026, with no API or egress fees up to 3 times the stored size, paid in crypto with no ID document.
