本文介绍了对象存储OSS的公共请求头和公共响应头的详细说明。
公共请求头(Common Request Headers)
OSS的RESTful接口中使用了一些公共请求头,这些请求头可以被所有的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 | 访问域名。格式为 默认值:无 |
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)
OSS的RESTful接口中使用了一些公共响应头。这些响应头可以被所有的OSS请求所使用,其详细定义请参见下表。
名称 | 类型 | 示例值 | 描述 |
Content-Length | 字符串 | 556 | RFC 2616中定义的HTTP请求内容长度。 默认值:无 |
Connection | 枚举 | keep-alive | 标明客户端和OSS服务器之间的链接状态。 有效值:keep-alive、close 默认值:无 |
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。 默认值:无 |