公共请求头部

最近更新时间:2024-07-18 15:54:12

我的收藏

描述

此篇文档将为您介绍在使用 API 时候会使用到的公共请求头部(Request Header),下文提到的头部在之后的具体 API 文档中不再赘述。

请求头部列表

Header 名称
描述
类型
是否必选
Authorization
携带鉴权信息,用以验证请求合法性的签名信息。针对公有读的对象可不携带此头部,如通过请求参数传递鉴权信息也无需携带此头部,详情请参见 请求签名 文档。
string
是。
Content-Length
RFC 2616 中定义的 HTTP 请求内容长度(字节)。
integer
否。针对 PUT 和 POST 请求,此头部是必选项。
Content-Type
RFC 2616 中定义的 HTTP 请求内容类型(MIME),例如 application/xml
string
否。针对有请求体的 PUT 和 POST 请求,此头部是必选项。
Content-MD5
RFC 1864 中定义的经过 Base64 编码的请求体内容 MD5 哈希值,例如 ZzD3iDJdrMAAb00lgLLeig==。此头部用于完整性检查,验证请求体在传输过程中是否发生变化。
string
否。
Date
RFC 1123 中定义的 GMT 格式当前时间,例如 Wed, 29 May 2019 04:10:12 GMT
string
否。
Host
请求的主机,形式为 <BucketName-APPID>.ci.<Region>.myqcloud.com
string
是。
x-ci-security-token
使用临时安全凭证时需要传入的安全令牌字段,数据万象可复用对象存储 临时安全凭证方法,详情请参见 临时安全凭证 相关说明。
string
否。当使用临时密钥并通过 Authorization 携带鉴权信息时,此头部为必选项。