对象存储简介-API 中心-腾讯云

腾讯云对象存储 COS 使用 XML API，这是一种轻量级的、无连接状态的接口，调用此接口您可以直接通过 HTTP/HTTPS 发出请求和接受响应，实现与腾讯云对象存储后台的交互操作。
由于使用了不同的数据传输框架，对象存储 COS 提供了独立于云 API 的接口和独立的 SDK，您可直接前往 COS 的 API 操作列表 了解详情，或前往 COS 的 SDK 列表 下载您需要的 SDK。云 API 的指南和对应的 SDK 不包含对象存储 COS 的操作功能。
注意
如您已开始使用腾讯云 COS API，即代表您已阅读并同意 《腾讯云服务协议》 和 《腾讯云对象存储服务等级协议》。
COS 的可用地域（Region）的详细信息请查阅 地域和访问域名 文档。 
在使用 API 或 SDK 发起请求前，建议您阅读 创建请求概述 文档了解发起访问的域名、安全鉴权概念以及内外网访问检查等信息。
COS 存在 XML 和 JSON 两个不同版本的 API，两个版本的接口协议并不相同，但访问的数据互通，需要注意的是历史版本的 JSON API 将不再提供继2018年之后推出的新功能。
如果您需要获得 JSON 格式的响应，推荐您使用 COS SDK，在 SDK 中可以设置响应体为 JSON 格式的响应。
其他腾讯云产品的 API 格式，请参见 API 中心介绍。
您也可以通过以下视频了解对象存储 API：
﻿
API 概览
COS 支持的 API 接口请参见 操作列表。
﻿
术语信息
使用 API 接口时会出现一些主要概念和术语，请见下表：
名称
描述
APPID
开发者访问 COS 服务时拥有的用户维度唯一资源标识，用以标识资源，可在 API 密钥管理 页面获取。
SecretId
开发者拥有的项目身份识别 ID，用于身份认证，可在 API 密钥管理 页面获取。
SecretKey
开发者拥有的项目身份密钥，可在 API 密钥管理 页面获取。
Bucket
存储桶，COS 中用于存储数据的容器。有关存储桶的进一步说明，请参见 存储桶概述 文档。
BucketName-APPID
存储桶名称格式，用户在使用 API、SDK 时，需要按照此格式填写存储桶名称。例如 examplebucket-1250000000，含义为该存储桶 examplebucket 归属于 APPID 为1250000000的用户。
Object
对象，COS 中存储的具体文件，是存储的基本实体。
ObjectKey
对象键，对象（Object）在存储桶（Bucket）中的唯一标识。有关对象与对象键的进一步说明，请参见 对象概述 文档。
Region
地域信息，枚举值可参见 可用地域 文档，例如：ap-beijing、ap-hongkong、eu-frankfurt 等。
ACL
访问控制列表（Access Control List），是指特定 Bucket 或 Object 的访问控制信息列表。
CORS
跨域资源共享（Cross-Origin Resource Sharing）指发起请求的资源所在域不同于该请求所指向资源所在的域的 HTTP 请求。
Multipart Uploads
分块上传，腾讯云 COS 服务为上传文件提供的一种分块上传模式。
Object Content
Object Content 是上传文件的二进制内容。
快速入门
要使用腾讯云对象存储 API，需要先执行以下步骤：
1. 在腾讯云 对象存储控制台 开通腾讯云对象存储（COS）服务。
2. 在腾讯云 对象存储控制台 创建一个 Bucket。
3. 在访问管理控制台中的 API 密钥管理 页面里获取 APPID，并创建 SecretId、SecretKey。
4. 编写一个请求签名算法程序（或使用任何一种服务端 SDK），详情请参见 请求签名 文档。
5. 计算签名，调用 API 执行操作。
历史版本 API
请查看 历史版本 API 简介。

名称	描述
APPID	开发者访问 COS 服务时拥有的用户维度唯一资源标识，用以标识资源，可在 API 密钥管理页面获取。
SecretId	开发者拥有的项目身份识别 ID，用于身份认证，可在 API 密钥管理页面获取。
SecretKey	开发者拥有的项目身份密钥，可在 API 密钥管理页面获取。
Bucket	存储桶，COS 中用于存储数据的容器。有关存储桶的进一步说明，请参见存储桶概述文档。
BucketName-APPID	存储桶名称格式，用户在使用 API、SDK 时，需要按照此格式填写存储桶名称。例如 examplebucket-1250000000，含义为该存储桶 examplebucket 归属于 APPID 为1250000000的用户。
Object	对象，COS 中存储的具体文件，是存储的基本实体。
ObjectKey	对象键，对象（Object）在存储桶（Bucket）中的唯一标识。有关对象与对象键的进一步说明，请参见对象概述文档。
Region	地域信息，枚举值可参见可用地域文档，例如：ap-beijing、ap-hongkong、eu-frankfurt 等。
ACL	访问控制列表（Access Control List），是指特定 Bucket 或 Object 的访问控制信息列表。
CORS	跨域资源共享（Cross-Origin Resource Sharing）指发起请求的资源所在域不同于该请求所指向资源所在的域的 HTTP 请求。
Multipart Uploads	分块上传，腾讯云 COS 服务为上传文件提供的一种分块上传模式。
Object Content	Object Content 是上传文件的二进制内容。

简介

本页目录：

API 概览

术语信息

快速入门

历史版本 API