简介

最近更新时间:2018-01-15 11:28:12

描述

腾讯云对象存储(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 执行操作