Overview
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.
