Last update:2022-03-01 18:22:22

Difference between API-V1 and API-V2

CDNetworks Object Storage provides two versions of API: V1 and V2. This chapter introduces the difference and usage between these two versions.

Function API-V1 API-V2
List Bucket Support(only list the bucket created by the account itself) Support
List Resource Support Support
Normal Upload Support Support
Multipart Upload Support Support
Delete Files Support Support
Copy Resource Support Support
Move Resource Support Not Support (need to copy first then delete)
Audio/video operations Support Not Support
Download Files Support (public download, authentication is not required) Support (authentication is required by default, allow to configure not required)
IAM (See detailed explanation as below) Not Support Support

What does IAM support mean
IAM allows parent account(main account) to grant operations of bucket to his sub-accounts. For example, main account allow sub account to upload files of one specific bucket and forbid sub account to download files of one specific bucket by using IAM.

  • API-V2 support IAM, sub account could call API-V2 to upload files of this specific bucket, but couldn’t download files.
  • API-V1 doesn’t support IAM, it means, account’s permission is not controled by IAM. API-V1 has its own rule: Bucket creator could only manage/operate the files of his bucket, not the files of others’ bucket, even main account(parent account) could not manage the files of the bucket created by his sub-accounts.

API version choose suggestion
Customer could choose related api version to use based on your functional needs. You are allowed to call API-V1 to move resource and do audio/video operations, and call API-V2 to list bucket and delete files, but we suggest you use one version api just in case of mixing them.

More differences between API-V1 and API-V2

  • API-V1 use the bucket Manage Domain or Upload Domain as the access domain.
  • API-V2 use bucket Endpoint and RegionName as the access domain.
  • Manage Domain/Upload Domain/Endpoint/RegionName is displayed under the overview page of Object Storage Console.
    [New Feature] WAF Rule Template
Is the content of this document helpful to you?
I have suggestion
Submitted successfully! Thank you very much for your feedback, we will continue to strive to do better!