Compatibility with AWS S3

Last update:2025-06-30 17:29:30

This document introduces the compatibility and differences between CDNetworks Object Storage and AWS S3 interfaces.

Compatible S3 Interfaces

Service Operations

Interface Function Description
GetService List all buckets owned by the user

Bucket Operations

Interface Function Description
GetBucket (ListObjectV1) List objects in a bucket (V1 version)
GetBucketV2 (ListObjectV2) List objects in a bucket (V2 version)
HeadBucket Verify bucket existence
PutBucketLifecycle Create/replace bucket lifecycle rules
GetBucketLifecycle Query bucket lifecycle rules
DeleteBucketLifecycle Delete bucket lifecycle rules

Object Operations

Interface Function Description
PutObject Upload objects via direct transfer
PostObject Upload objects via form
CopyObject Copy objects to a new location
DeleteObject Delete a single object
DeleteObjects Delete multiple objects in batch
GetObject Retrieve object content

Multipart Upload Operations

Interface Function Description
InitiateMultipartUpload Initiate a multipart upload task
UploadPart Upload a part of the data
CompleteMultipartUpload Complete upload and merge objects
AbortMultipartUpload Abort a multipart upload task
ListParts List all part information of a task

Compatibility Notes

1. Authentication Protocol Compatibility

  • Supports S3 v4 signature protocol
  • Credential replacement required: Use CDNetworks AccessKey and SecretKey

2. Endpoint Compatibility
Supports two styles:

# HostPath style  
http://endpoint/{bucket}/key  

# Virtual Host style (Recommended)  
http://{bucket}.endpoint/key  

3. Data Identifier Differences​​

  • Etag for directly uploaded objects is the same as S3 (MD5 hash of the file)
  • Etag generated for multipart-uploaded objects differs from S3

4. Toolchain Compatibility​​

Compatible with common S3 tools such as:s3cmd, awscli, s3browser, etc.

Is the content of this document helpful to you?
Yes
I have suggestion
Submitted successfully! Thank you very much for your feedback, we will continue to strive to do better!