注意:您目前查阅的是历史版本 API 文档,已不再更新和维护,我们建议您查阅新版 API 文档。
描述
腾讯云对象存储(COS)服务的 RESTful API 是一种轻量级的,无连接状态的,可以直接通过 HTTP/HTTPS 的请求和响应来和腾讯云对象存储(COS)后台进行交互操作的 Web 服务。
JSON API 是腾讯云 COS 服务在推出 XML API 前为用户提供接入使用 COS 的 API 接口,上传域名为 [Region].file.myqcloud.com。JSON API 接口与标准 XML 的 API 底层架构相同,数据互通,可以交叉使用,但是接口不兼容,域名不一致。
腾讯云 COS 的 XML API 服务推出后,推荐您使用 XML API 接口, JSON API 接口日后将保持维护状态,可以正常使用但是不发展新特性。
注意:目前 COS 的可用地域(Region)根据 XML API和 JSON API 有不同的取值,在使用不同的 API 和对应的 SDK 时要求使用对应的地域字段,详细信息请参见 历史版本地域列表 文档。
为了能更高效的使用腾讯云对象存储服务的 JSON API ,请在查阅其他的 API 文档之前,先详细阅读 签名算法 。
术语信息
文中会出现的一些主要概念和术语:
名称 | 描述 |
---|---|
AppID | 开发者访问 COS 服务时拥有的用户维度唯一资源标识,用以标识资源 |
SecretID | 开发者拥有的项目身份识别 ID,用以身份认证 |
SecretKey | 开发者拥有的项目身份密钥 |
Bucket | COS 中用于存储数据的容器 |
Object | COS 中存储的具体文件,是存储的基本实体 |
快速入门
要使用对象存储 API,需要先执行以下步骤: