公共HTTP头定义

本文介绍了对象存储OSS的公共请求头和公共响应头的详细说明。

公共请求头(Common Request Headers)

OSSRESTful接口中使用了一些公共请求头,这些请求头可以被所有的OSS请求使用,其详细定义请参见下表。

名称

类型

示例值

描述

Authorization

字符串

OSS4-HMAC-SHA256 Credential=****

在非匿名请求中,用于验证请求合法性的认证信息。关于Authorization计算方法的更多信息,请参见签名版本4(推荐)

默认值:无

Content-Length

字符串

556

RFC 2616中定义的HTTP请求内容长度。

默认值:无

Content-Type

字符串

application/xml

RFC 2616中定义的HTTP请求内容类型。

默认值:无

Date

字符串

Sun, 05 Sep 2021 23:00:00 GMT

HTTP 1.1协议中规定的GMT时间。

默认值:无

Host

字符串

oss-example.oss-cn-hangzhou.aliyuncs.com

访问域名。支持以下三种类型:

  • Bucket域名:格式为BucketName.Endpoint,示例值为oss-example.oss-cn-hangzhou.aliyuncs.com

    关于支持通过Bucket域名发起请求的API列表,请参见API概览

  • 接入点别名域名:格式为AccessPointName-ossalias.Endpoint,示例值为ap-01-9adeed3cfa4c3208ceb8df5ad8f9a2****-ossalias.oss-cn-hangzhou.aliyuncs.com

    关于支持通过接入点别名域名发起请求的API列表,请参见接入点别名域名兼容的操作

  • 云盒域名:云盒域名分为管控域名和数据域名两种。

    • 管控域名:格式为<Cloudbox-Id>.<Region>.oss-cloudbox-control.aliyuncs.com,示例值为cb-f8z7yvzgwfkl9q0h****.cn-hangzhou.oss-cloudbox-control.aliyuncs.com

      更多信息,请参见管控域名支持的API列表

    • 数据域名:格式为<Cloudbox-Id>.<Region>.oss-cloudbox.aliyuncs.com,示例值为cb-f8z7yvzgwfkl9q0h****.cn-hangzhou.oss-cloudbox.aliyuncs.com

      更多信息,请参见数据域名支持的API列表

默认值:无

x-oss-security-token

字符串

CAISowJ1q6Ft5B2yfSjIr5feHsPhtYh3+pONd2uCglI3dvxVt7DB1Tz2IHxMdHJsCeAcs/Q0lGFR5/sflqJIRoReREvCUcZr8sy2SqEGos2T1fau5Jko1be0ewHKeQKZsebWZ+LmNpy/Ht6md1HDkAJq3LL+bk/Mdle5MJqP+/kFC9MMRVuAcCZhDtVbLRcYgq18D3bKMuu3ORPHm3fZCFES2jBxkmRi86+ysIP+phPVlw/90fRH5dazcJW0Zsx0OJo6Wcq+3+FqM6DQlTNM6hwNtoUO1fYUommb54nDXwQIvUjfbtC5qIM/cFVLAYEhALNBofTGkvl1h/fejYyfyWwWYbkFCHiPFNr9kJCUSbr4a4sjF6zyPnPWycyCLYXleLzhxPWd/2kagAF6qLNY5paXF18NyRP0PISqxlWBuSQldMS3avlblTFB7apY8CUiAQcSY3uDYUhuxU+KFBxpGaq8c1SU5ARo+1JBA5nXhFlY2nbDnWONxa0mvNvE3XJ0FZJnDS7WBHyOMjC8nmw2GfaQ4bxQ0D2+20yrDNevWSSqnwh0qXMI3zY5****

仅在使用STS临时授权账号访问OSS时需要配置该选项。关于如何获取Security-Token的具体操作,请参见AssumeRole - 获取扮演角色的临时身份凭证

公共响应头(Common Response Headers)

OSSRESTful接口中使用了一些公共响应头。这些响应头可以被所有的OSS请求所使用,其详细定义请参见下表。

名称

类型

示例值

描述

Content-Length

字符串

556

RFC 2616中定义的HTTP请求内容长度。

默认值:无

Connection

枚举

keep-alive

标明客户端和OSS服务器之间的链接状态。

有效值:keep-aliveclose

默认值:无

Date

字符串

Sun, 05 Sep 2021 23:00:00 GMT

HTTP 1.1协议中规定的GMT时间。

默认值:无

ETag

字符串

5B3C1A2E053D763E1B002CC607C5A0FE1****

ETag (entity tag) 在每个Object生成的时候被创建,用于标识一个Object的内容。对于Put Object请求创建的Object,ETag值是其内容的MD5值;对于其他方式创建的Object,ETag值是基于一定计算规则生成的唯一值,但不是其内容的MD5值。ETag值可以用于检查Object内容是否发生变化。

默认值:无

Server

字符串

AliyunOSS

生成Response的服务器。

默认值:AliyunOSS

x-oss-request-id

字符串

534B371674E88A4D8906****

用于唯一标识该次请求的UUID。您可以凭借此Request ID联系技术支持,排查并解决您遇到的问题。关于获取Request ID的具体操作,请参见获取Request ID

默认值:无