4EVERLAND Documents
HomeTwitterDiscordBlogs
  • Welcome to 4EVERLAND
  • Get started
    • Our Features
    • Quick Start Guide
      • Registration
      • Login options
        • MetaMask
        • OKX Wallet
        • Binance Web3 Wallet
        • Bitget Wallet
        • Phantom
        • Petra
        • Lilico
      • Usage Introduction
      • Dashboard stats
      • Account
        • Linking Your EVM Wallet to 4EVERLAND Account
        • Balance Alert
    • Billing and Pricing
      • What is LAND?
      • How to Obtain LAND?
      • Pricing Model
      • Q&As
    • Tokenomics
  • HOSITNG
    • What is Hosting?
      • IPFS Hosting
      • Arweave Hosting
        • Auto-Generation of Manifest
      • Internet Computer Hosting
      • Greenfield Hosting
    • Guides
      • Creating a Deployment
        • With Git
        • With IPFS Hash
        • With a Template
      • Site Deployment
      • Domain Management
        • DNS Setup Guide
        • ENS Setup Guide
        • SNS Setup Guide
          • The gateway: 4sol.xyz
        • SPACE ID Setup Guide
      • Project Setting
        • Git
      • Troubleshooting
      • Common Frameworks
    • Hosting Templates Centre
      • Templates Configuration File
    • Quick Addition
      • Implement Github 4EVER Pin
      • Github Deployment Button
    • Hosting API
      • Create Project API
      • Deploy Project API
      • Get Task Info API
      • IPNS Deployment Update API
    • Hosting CLI
  • Storage
    • Bucket
      • IPFS Bucket
        • Get Root CID - Snapshots
      • Arweave Bucket
        • Path Manifests
          • Instructions for Building Manifest
          • Auto-Generation of Manifest
        • Arweave Tags
        • Unleash Arweave
      • Guides
      • Bucket API - S3 Compatible
        • Coding Examples
          • AWS SDK - Go (Golang)
          • AWS SDK - Java
          • AWS SDK - JavaScript
          • AWS SDK - .NET
          • AWS SDK - PHP
          • AWS SDK - Python
          • AWS SDK - Ruby
        • S3 Tags Instructions
      • 4EVER Security Token Service API
      • Bucket Tools
      • Bucket Gateway Optimizer
    • 4EVER Pin
      • Guides
      • Pinning Services API
      • IPFS Migrator
    • Storage SDK
  • Gateways
    • IPFS Gateway
    • IC Gateway
    • Arweave Gateway
    • Dedicated Gateways
      • Gateway Access Controls
      • Video Streaming
      • IPFS Image Optimizer
    • IPNS Manager
      • IPNS Manager API
  • RPC
    • Guides
    • API Keys
    • JSON Web Token (JWT)
    • What's CUs/CUPS
    • WebSockets
    • Archive Node
    • Debug API
    • Chains RPC
      • BSC / opBNB
      • Ethereum
      • Optimism
      • Polygon
      • Taiko
  • AI
    • AI RPC
      • Quick Start
      • Models
      • API Keys
      • Requests & Responses
      • Parameters
    • 4EVER Chat
  • RaaS - Beta
    • What's Rollups?
    • 4EVER Rollup Stack
  • DePIN
    • 4EVER Network
    • Storage Nodes
  • More
    • Use Cases
      • Livepeer
      • Lens Protocol
      • Optopia.ai
      • Linear Finance
      • Snapshot
      • Tape
      • Taiko
      • Hey.xyz
      • SyncSwap
    • Community
    • Tutorials
    • Security
    • 4EVERLAND FAQ
Powered by GitBook
On this page
  • Methods for obtaining Hash
  • Access Keys
  • Endpoint
  • HTTPS Protocol
  • Supported Feature Calls
  • Supported Bucket Calls
  • Supported Object Calls
  • Supported Multipart Calls
  • Supported Policy Calls
  • Limits of S3 API
  1. Storage
  2. Bucket

Bucket API - S3 Compatible

Last updated 1 year ago

4EVERLAND Bucket's S3-compatible API is fully compatible with the Amazon S3 Cloud Storage service, which means that it can be used by a wide range of standardized S3-compatible frameworks, tools, clients and SDKs to manage data stored via Bucket.

This compatibility makes it easy to integrate the 4EVERLAND Bucket with existing workflows and applications, without the need for significant changes to existing code or infrastructure. It also means that developers can use familiar tools and frameworks to manage their data on the 4EVERLAND Bucket, which can help to streamline development and reduce the learning curve associated with new technologies.

In addition to its S3 compatibility, the 4EVERLAND Bucket also offers high performance, reliability, and security, making it an excellent choice for developers and businesses looking for a powerful and flexible cloud storage solution.

Overall, the 4EVERLAND Bucket's S3-compatible API provides a powerful and flexible cloud storage solution that is easy to integrate with existing workflows and applications. With support for a wide range of tools and frameworks, it is a convenient and efficient way to manage your data in the cloud.

You can refer to the official to implement the interface to the Bucket API.

If you need to upload content to Arweave, make sure that the corresponding bucket has the 'sync to ar' button enabled before using this 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'
  }
}

Access Keys

To use the 4EVERLAND S3-compatible API, you will need to have your 4EVERLAND API Key and API Secret to submit API requests.

Click on Bucket and select 'Access Keys', then click on 'Generate' on the right side to generate an API Key.

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

Please also check the 4EVER Security Token Service API for details.

Limits of S3 API

Item
Specification

Maximum number of buckets

200

Maximum number of objects per bucket

no-limit

Maximum object size

about 96 GiB

Minimum object size

0 B

Maximum object size per PUT operation

100 MiB

Maximum number of parts per upload

1000

Part size range

5 MiB to 100

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

More information about supported .

If you have any questions, please join our , or send us an email at .

AWS S3 STS
Discord server
contact@4everland.org
Amazon S3 documentation
Amazon S3 REST API Introduction - Amazon Simple Storage ServiceAmazon Simple Storage Service
Logo