便宜云主机对象存储 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 概览
?
术语信息
使用 API 接口时会出现一些主要概念和术语,请见下表:
名称 | 描述 |
APPID | |
SecretId | |
SecretKey | |
Bucket | |
BucketName-APPID | 存储桶名称格式,用户在使用 API、SDK 时,需要按照此格式填写存储桶名称。例如 examplebucket-1250000000,含义为该存储桶 examplebucket 归属于 APPID 为1250000000的用户。 |
Object | 对象,COS 中存储的具体文件,是存储的基本实体。 |
ObjectKey | |
Region | |
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 执行操作。