接入地址
对象存储网络接入地址为:oos-cn.ctyunapi.cn。对象存储网络2接入地址为:oos-cn2.ctyunapi.cn。香港精品网接入地址为:oos-cnhk-hqnet.ctyunapi.cn。香港普通网接入地址为:oos-cnhk-nqnet.ctyunapi.cn。
注意对于对象存储网络、对象存储网络2中的OOS API,如果您的数据存储在某个资源池,建议您直接使用该资源池的Endpoint,详见域名(Endpoint)列表。
通信协议
为了保证通信的安全性,同时支持HTTP和HTTPS。
请求方法
OOS API支持GET、POST、PUT、HEAD、DELETE和OPTION请求方法发送请求。
请求参数
每个请求都需要指定如下信息:
- 每个操作接口都需要包含的公共请求参数。
- 操作接口所特有的请求参数。
本节主要描述公共请求参数和请求结果。
说明在后续提到具体API时,举例中都会有 公共请求头、 公共响应头 ,但是不对其进行描述和解释。
公共请求头
以下是OOS API的公共请求头。
名称 描述 是否必须 BucketName Bucket名称。
除GET Service (List Bucket)、GET Regions外,其他Bucket、Object操作都需要该参数。
是 Authorization 用于身份验证的请求头。Authorization的构造方式请参考安全策略部分,请先确定使用V2还是V4版本的签名方式,再按照对应的计算方式生成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 请求的域名。
对象存储网络的请求域名为:oos-cn.ctyunapi.cn。
对象存储网络2的请求域名为:oos-cn2.ctyunapi.cn。
香港精品网的请求域名为:oos-cnhk-hqnet.ctyunapi.cn。
香港普通网的请求域名为:oos-cnhk-nqnet.ctyunapi.cn。
是 Connection 客户端与OOS服务器之间的连接状态。
取值:
keep-alive:长连接,请求结束后继续保持连接。
close:短连接,请求结束后关闭连接。
默认值为:keep-alive。
否
公共响应头
每个OOS API响应结果中都包含公共响应头。
名称 描述 Content-Length 响应体的长度。 Content-Type 响应内容的MIME类型。 Date OOS返回响应的日期和时间。 ETag 文件的哈希值。ETag只反映了文件的内容,而不是其元数据。此响应头可以用作数据完整性检查,以验证数据是否与客户端发送的数据相同。 Server 服务端名称,默认值是CTYUN。 x-amz-request-id 用于唯一标示请求的ID。 Connection 客户端与OOS服务器之间的连接状态。
如果请求时Connection值为keep-alive,请求结束后继续保持连接,不返回此响应头。
如果请求时Connection值为close,请求结束后关闭连接,返回此响应头Connection: close。