我们已经准备好了,你呢?

2023我们与您携手共赢,为您的企业形象保驾护航!


喜讯:国内、香港、海外云服务器租用特惠活动,2核/4G/10M仅需31元每月,点击抢购>>>

点击这里注册天翼云特邀VIP帐号,立即体验天翼云对象存储>>>


天翼云对象存储(经典版)I型API参考-OOS API请求结构


接入地址

对象存储网络接入地址为:oos-cn.ctyunapi.cn;香港精品网接入地址为:oos-cnhk-hqnet.ctyunapi.cn;香港普通网接入地址为:oos-cnhk-nqnet.ctyunapi.cn。

注意:对于对象存储网络中的OOS API,如果您的数据存储在某个资源池,建议您直接使用该资源池的Endpoint,详见域名(Endpoint列表)

通信协议

为了保证通信的安全性,统计支持HTTP和HTTPS。

请求方法

OOS API支持GET、POST、PUT、HEAD、DELETE和OPTION请求方法发送请求。

请求参数

每个请求都需要指定如下信息:

  • 每个操作接口都需要包含的公共请求参数。

  • 操作接口所特有的请求参数。

本节主要描述公共请求参数和请求结果。

说明:在后续提到具体API时,举例中都会有公共请求头公共响应头,但是不对其进行描述和解释。

公共请求头 

以下是OOS API的公共请求头。

名称

描述

是否必须

Authorization

用于身份验证的请求头。

Content-Length

请求体的长度。

Content-MD5

按照RFC 1864,使用base64编码格式生成信息的128位MD5值。此请求头可以用作数据完整性检查,以验证数据是否与客户端发送的数据相同。

x-amz-content-sha256

当使用V4签名对请求进行身份验证时,此请求头提供请求有效负载的哈希。

V4签名必须。

Content-Type

描述请求内容的标准MIME类型。

Date

请求的日期和时间,GMT时间。

V2签名可以填写x-Amz-Date或Date

x-amz-date

请求的日期和时间。日期和时间格式必须遵循ISO 8601标准,并且必须使用“yyyyMMddT HHmmssZ”格式进行格式化。例如,如果日期和时间是“08/01/2018 15:32:41.982-700”,则必须首先将其转换为UTC(协调世界时),然后提交为“20180801T083241Z”。

V4签名必填。

Host

请求的域名。

l  对象存储网络的请求域名为:oos-cn.ctyunapi.cn;

l  香港精品网的请求域名为:oos-cnhk-hqnet.ctyunapi.cn;

l  香港普通网的请求域名为:oos-cnhk-nqnet.ctyunapi.cn。

Connection

客户端与OOS服务器之间的连接状态。

取值:

l  keep-alive:长连接,请求结束后继续保持连接;

l  close:短连接,请求结束后关闭连接。

默认值为keep-alive。


公共响应头

每个OOS API响应结果中都包含公共响应头。

名称

描述

Content-Length  

响应体的长度。

Content-Type

响应内容的MIME类型。

Date

OOS返回响应的日期和时间。

ETag

对象的哈希值。ETag只反映了对象的内容,而不是其元数据。此响应头可以用作数据完整性检查,以验证数据是否与客户端发送的数据相同。

Server

服务端名称,默认值是CTYUN。

x-amz-request-id

用于唯一标示请求的ID。

Connection

客户端与OOS服务器之间的连接状态。

l  如果请求时Connection值为keep-alive,请求结束后继续保持连接,不返回此响应头。

l  如果请求时Connection值为close,请求结束后关闭连接,返回此响应头Connection: close。



推荐:TOP云智能建站优惠活动,仅880元即可搭建一个后台管理五端合一的智能网站(PC网站、手机网站、百度智能小程序、微信小程序、支付宝小程序),独享百度搜索SEO优势资源,让你的网站不仅有颜值有排面,更有排名,可以实实在在为您带来效益,请点击进入TOP云智能建站>>>,或咨询在线客服了解详情。


我们已经准备好了,你呢?

2023我们与您携手共赢,为您的企业形象保驾护航!

在线客服
联系方式

热线电话

131-3501-0006

上班时间

周一到周五

公司电话

130-0743-9476

二维码
线