Links

S3-Campatiable API

4EVERLAND Bucket's S3-compatible API is fully compatible with the Amazon S3 Cloud Storage service and can be used by several standardized S3-compatible frameworks, tools, clients and SDKs to manage data stored via Bucket.
You can refer to the official Amazon S3 documentation to implement the interface to the Bucket API.

Methods for obtaining Hash

You can Get ipfs hash and arweave hash from object metadata.
Object metadata key:
{
Metadata: {
'arweave-hash': 'arweave hash',
'ipfs-hash': 'ipfs cid'
}
}

Endpoint

The Bucket S3-compatible API endpoint is:
https://endpoint.4everland.co
This endpoint can be used with S3-compatible tools, SDKs, or frameworks to communicate with the 4EVERLAND Bucket.
Location can be configured freely: Since 4EVERLAND storage nodes are globally distributed, endpoint will automatically match the nearest node according to the upload location for data upload, so you can configure the location parameter freely.

HTTPS Protocol

4EVERLAND maintains a strict HTTPS-only standard. This means objects and API calls are served only via HTTPS. The port for this connection is the HTTPS standard port 443.
Requests sent via the HTTP protocol will be redirected to HTTPS.

Supported Feature Calls

Currently, the API supports Bucket Calls, Object Calls, and also supports Multipart Calls and Privacy Calls.

Supported Bucket Calls

Name
Supported
MakeBucketWithLocation
Yes (partial, ingore Location)
GetBucketInfo
Yes (fully)
ListBuckets
Yes (fully)
DeleteBucket
Yes (fully)

Supported Object Calls

Name
Supported
ListObjects
Yes (fully)
ListObjectsV2
Yes (fully)
GetObjectNInfo
Yes (fully)
GetObject
Yes (fully)
GetObjectInfo
Yes (fully)
PutObject
Yes (fully)
CopyObject
Yes (fully)
DeleteObject
Yes (fully)
DeleteObjects
Yes (fully)
GetObjectTagging
Yes (fully)
PutObjectTagging
Yes (fully)
DeleteObjectTagging
Yes (fully)

Supported Multipart Calls

Name
Supported
ListMultipartUploads
Yes (fully)
NewMultipartUpload
Yes (fully)
PutObjectPart
Yes (fully)
CopyObjectPart
Yes (fully)
ListObjectParts
Yes (fully)
AbortMultipartUpload
Yes (fully)
CompleteMultipartUpload
Yes (fully)

Supported Policy Calls

Name
Supported
SetBucketPolicy
No
GetBucketPolicy
Yes
DeleteBucketPolicy
No
Supported S3 STS

Limits of S3 API

Item
Specification
Maximum number of buckets
200
Maximum number of objects per bucket
no-limit
Maximum object size
5 TiB
Minimum object size
0 B
Maximum object size per PUT operation
5 GiB
Maximum number of parts per upload
1000
Part size range
5 MiB to 5 GiB. Last part can be 0 B to 5 GiB
Maximum number of parts returned per list parts request
1000
Maximum number of objects returned per list objects request
1000
Maximum number of multipart uploads returned per list multipart uploads request
1000
Maximum length for bucket names
48
Maximum length for object names
1024
Maximum length for '/' separated object name segment
19
If you have any questions, please join our Discord server, or send us an email at [email protected].