> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hivenet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Hivenet Object Storage S3 compatibility

> Review the implemented S3 operations covered by these guides and the Hivenet-specific connection requirements.

Hivenet Object Storage implements a subset of Amazon S3 operations. This page lists the operations covered by these guides.

Use the [AWS S3 API reference](https://docs.aws.amazon.com/AmazonS3/latest/API/API_Operations_Amazon_Simple_Storage_Service.html) for request and response formats. Configure the Hivenet endpoint and path-style addressing before using AWS examples.

## Connection requirements

* Endpoint: `https://eu.s3.hivenet.com`.
* Signing region: `Europe`.
* Authentication: AWS Signature Version 4 with a Hivenet access key ID and secret.
* Addressing: path style, explicitly enabled.

These settings target EU storage. See [Connection settings](https://docs.hivenet.com/documentation/object-storage/connection-settings.md) for client-specific options, the deprecated endpoint, and the planned US rollout.

## Organization access modes

Operation support does not override an organization's access mode. When a self-service organization's shared credit balance reaches zero or becomes negative, storage changes to **Read only** or **Disabled**, depending on the organization's configured access mode.

| Operation | Full access | Read only | Disabled |
| - | - | - | - |
| List bucket names | Yes | Yes | Yes |
| List objects and read or download data | Yes | Yes | No |
| Upload or modify objects | Yes | No | No |
| Delete objects or create buckets | Yes | No | No |

Changing modes does not itself delete objects or keys. Stored data continues to accrue charges while access is restricted. Existing presigned share links remain valid until expiry regardless of mode, provided the object still exists.

See [Usage and billing](https://docs.hivenet.com/documentation/object-storage/usage-and-billing.md#when-credits-run-out) for restoring access and deletion eligibility after seven days without funds.

## Documented operations

| Area | Operations |
| - | - |
| Buckets | `ListBuckets`, `CreateBucket`, `HeadBucket`, `DeleteBucket`, `GetBucketLocation` |
| Objects | `PutObject`, `GetObject`, `HeadObject`, `DeleteObject`, `DeleteObjects`, `CopyObject` |
| Listing | `ListObjects` (V1), `ListObjectsV2` |
| Multipart uploads | `CreateMultipartUpload`, `UploadPart`, `CompleteMultipartUpload`, `AbortMultipartUpload`, `ListMultipartUploads` |
| Presigned requests | GET and PUT URLs |

Presigned URLs are signed requests, not separate S3 operation names.

Support for an operation does not establish support for every optional header, feature, or client workflow built around it. An operation absent from this table is not a documented compatibility guarantee.

## Listing and pagination

Use `ListObjectsV2` for new integrations. Follow continuation tokens or use your SDK's paginator to retrieve more than one response.

For clients using V1, use its marker-based pagination. The two pagination formats are different.

## Upload limits

* A single `PutObject` request supports objects up to **5 GB**.
* Use multipart uploads for larger objects, up to Hivenet's **5 TB** per-object limit.

These are API limits. The console handles multipart uploads automatically for larger files. See [File size and large transfers](https://docs.hivenet.com/documentation/object-storage/objects.md#file-size-and-large-transfers) for console guidance.

Use a managed transfer function when you want the client to handle multipart uploads. A raw `PutObject` call does not automatically split a file.

If you manage multipart uploads directly, complete successful uploads and abort abandoned ones.

## Deletion behavior

A bucket must be empty before `DeleteBucket` succeeds. Otherwise, the service returns `BucketNotEmpty`.

The console performs the emptying steps for you. API clients need to list objects, delete them, and then delete the empty bucket.

For portable client code, send no more than **1,000 keys** per `DeleteObjects` request, as described by the [AWS request specification](https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjects.html). Check per-object results and refresh the object list after partial failures or interrupted requests.

Do not assume an HTTP success alone means every requested object was deleted.

## Client guides

Use these guides to configure clients for the documented operations:

* [AWS CLI](https://docs.hivenet.com/documentation/object-storage/aws-cli.md)
* [Python with boto3 and JavaScript SDK v3](https://docs.hivenet.com/documentation/object-storage/sdks.md)
* [rclone](https://docs.hivenet.com/documentation/object-storage/rclone.md)

Client defaults can differ. Keep Hivenet's endpoint, signing region, and path-style setting explicit, and use [Troubleshooting](https://docs.hivenet.com/documentation/object-storage/troubleshooting.md) if a request fails.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.