控制台指南

最佳实践

开发者指南

数据湖存储

API 文档

SDK 文档

数据库文档捉虫大赛邀您参加,好礼多多> HOT
注意:

您目前查阅的是历史版本 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,需要先执行以下步骤:

  1. 购买腾讯云对象存储(COS)服务。
  2. 在腾讯云 对象存储控制台 里创建一个 Bucket。
  3. 在控制台 个人 API 密钥 页面里获取 APPID、SecretID、SecretKey 内容。
  4. 编写一个请求签名算法程序(或使用任何一种服务端 SDK)。
  5. 计算签名,调用 API 执行操作。
目录