API概览
更新时间：2025-08-18 15:31:31
CDNetworks 对象存储提供了两个 API 版本：V1 和 V2(S3)，二者在功能覆盖、权限规则、兼容性上存在显著差异。本文档将详细解释它们之间的不同之处，并为用户如何使用提供指导。
API-V1 和 API-V2(S3)功能比较
| 功能 | API-V1 | API-V2(S3) |
|---|---|---|
| 列出存储空间 | 支持（仅列出该账户自己创建的存储空间） | 支持 |
| 列举资源 | 支持 | 支持 |
| 普通上传 | 支持 | 支持 |
| 分片上传 | 支持 | 支持 |
| 删除文件 | 支持 | 支持 |
| 复制资源 | 支持 | 支持 |
| 移动资源 | 支持 | 不支持（需要先复制再删除） |
| 获取音视频元数据（avinfo） | 支持 | 支持 |
| 抓取资源（fetch） | 支持 | 暂不支持 |
| 音视频处理（含文件解压缩） | 支持 | 暂不支持 |
| 下载文件 | 支持（公开下载；不需要认证） | 支持（默认需要认证，但可配置为允许公开访问） |
| IAM (了解更多) | 不支持 | 支持 |
API 与 IAM 支持
IAM (身份和访问管理) 让主账户可以为其子账户分配特定的存储空间操作权限。例如：主账户可以允许子账户上传文件到特定的存储空间，但限制其从同一存储空间下载文件。
了解更多IAM操作，您可以参考IAM Overview
API-V2(S3) 和 IAM：
- API-V2 支持 IAM，允许为各个子账户分配存储空间操作权限。这让账户可以根据权限上传、删除和列出其他账户创建的存储空间中的文件。
API-V1 和 IAM：
- API-V1 不支持 IAM。权限遵循固定的规则：
1. 存储空间的创建者只能管理和操作自己存储空间内的文件（例如：上传、删除和列出文件）。在任何情况下，账户都不能访问或管理其他账户创建的存储空间。
2. 即使是主账户（母账户）也不能访问或管理子账户创建的存储空间中的文件。
API选择建议
我们强烈推荐使用与 S3 兼容的 API-V2。然而，如果你需要对存储在对象存储中的视频进行流媒体处理操作，则应使用 API-V1，因为这是唯一提供媒体处理 API 的版本。
此外，你可以使用 S3 API 或任何基于 S3 的工具与 CDNetworks 对象存储进行交互，因为我们完全兼容 S3。
API-V1 和 API-V2(S3) 的访问域名差异
- API-V1：使用存储空间的 管理域名 或 上传域名 作为访问域。
- API-V2(S3)：使用存储空间的 Endpoint 和 RegionName 进行访问。
你可以在 对象存储控制台的概览页面上找到 管理域名、上传域名、Endpoint 和 RegionName 的详细信息。
关于获取此四种域名的具体操作您可以参考查询域名
本篇文档内容对您是否有帮助？
有帮助
我要反馈