简介

最近更新时间:2024-10-12 16:41:22

我的收藏
便宜云主机对象存储 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

http://www.vxiaotou.com