Overview

Differences Between API-V1 and API-V2

CDNetworks Object Storage offers two API versions: V1 and V2. This document explains their differences and provides guidance on their usage.

Feature Comparison

What Does IAM Support Mean?

IAM (Identity and Access Management) enables the main account to assign specific permissions for bucket operations to its sub-accounts. For example: The main account can allow a sub-account to upload files to a specific bucket while restricting it from downloading files from the same bucket.

API-V2 and IAM:

• API-V2 supports IAM, allowing bucket operation permissions to be assigned to individual accounts. This enables accounts to upload, delete, and list files in buckets created by other accounts, as permitted.

API-V1 and IAM:

• API-V1 does not support IAM. Permissions follow a fixed rule:
  • The creator of a bucket can exclusively manage and operate files within their own bucket (e.g., uploading, deleting, and listing files). Under no circumstances can an account access or manage buckets created by other accounts.
  • Even the main account (parent account) cannot access or manage files in buckets created by sub-accounts.

Choosing Between API-V1 and API-V2

We highly recommend using API-V2 due to its compatibility with S3. However, if you need to perform media processing operations on videos stored in Object Storage, you should use API-V1, as it is the only version that provides media processing APIs.

Additionally, you can use S3 APIs or any S3-based tools with CDNetworks Object Storage, as we are fully compatible with S3.

Additional Differences Between API-V1 and API-V2

• API-V1: Uses the bucket’s Manage Domain or Upload Domain as the access domain.
• API-V2: Uses the bucket’s Endpoint and RegionName for access.

You can find the Manage Domain, Upload Domain, Endpoint, and RegionName details on the Object Storage Console overview page.