对象存储公共请求头部

本文档将为您介绍在使用 API 时使用到的公共请求头部（Request Header），下文提到的头部在之后的具体 API 文档中不再赘述。
请求头部列表
Header 名称
描述
类型
是否必选
Authorization
携带鉴权信息，签名格式详见 请求签名 文档
string
否
Content-Length
RFC 2616 中定义的 HTTP 请求内容长度（字节）
integer
针对 PUT 和 POST 请求（指定 Transfer-Encoding 请求头部的 PUT Object 请求除外），强烈建议携带；针对 GET、HEAD、DELETE 和 OPTIONS 请求，不能指定此头部
Content-Type
RFC 2616 中定义的 HTTP 请求内容类型（MIME），例如 application/xml 或 image/jpeg。对于 PutObject、PutObjectCopy、InitiateMultipartUpload 等对象写入接口，该头部值会被作为对象元数据持久化保存，并在后续 GetObject、HeadObject 响应中原样返回
string
针对有请求体的 PUT 和 POST 请求，此头部为必选项；针对 GET、HEAD、DELETE 和 OPTIONS 请求，不能指定此头部
Content-MD5
RFC 1864 中定义的请求体内容的 16 字节（128 位）二进制 MD5 哈希值的 Base64 编码形式，用于完整性检查，最终取值长度应为 24 个字符，例如 ZzD3iDJdrMAAb00lgLLeig==。客户端可选携带；当请求中携带该头部时，服务端会比对请求体实际 MD5，不一致时返回 BadDigest
string
否；针对 GET、HEAD、DELETE 和 OPTIONS 请求，不能指定此头部
Date
RFC 1123 中定义的 GMT 格式当前时间，例如 Wed, 29 May 2019 04:10:12 GMT
string
否
Host
请求的主机，形式为 <BucketName-APPID>.cosrapid.<Region>.myqcloud.com；GetService 接口固定为 service.cosrapid.<Region>.myqcloud.com
string
是

Header 名称	描述	类型	是否必选
Authorization	携带鉴权信息，签名格式详见请求签名文档	string	否
Content-Length	RFC 2616 中定义的 HTTP 请求内容长度（字节）	integer	针对 PUT 和 POST 请求（指定 `Transfer-Encoding` 请求头部的 PUT Object 请求除外），强烈建议携带；针对 GET、HEAD、DELETE 和 OPTIONS 请求，不能指定此头部
Content-Type	RFC 2616 中定义的 HTTP 请求内容类型（MIME），例如 `application/xml` 或 `image/jpeg`。对于 PutObject、PutObjectCopy、InitiateMultipartUpload 等对象写入接口，该头部值会被作为对象元数据持久化保存，并在后续 GetObject、HeadObject 响应中原样返回	string	针对有请求体的 PUT 和 POST 请求，此头部为必选项；针对 GET、HEAD、DELETE 和 OPTIONS 请求，不能指定此头部
Content-MD5	RFC 1864 中定义的请求体内容的 16 字节（128 位）二进制 MD5 哈希值的 Base64 编码形式，用于完整性检查，最终取值长度应为 24 个字符，例如 `ZzD3iDJdrMAAb00lgLLeig==`。客户端可选携带；当请求中携带该头部时，服务端会比对请求体实际 MD5，不一致时返回 `BadDigest`	string	否；针对 GET、HEAD、DELETE 和 OPTIONS 请求，不能指定此头部
Date	RFC 1123 中定义的 GMT 格式当前时间，例如 `Wed, 29 May 2019 04:10:12 GMT`	string	否
Host	请求的主机，形式为 `<BucketName-APPID>.cosrapid.<Region>.myqcloud.com`；GetService 接口固定为 `service.cosrapid.<Region>.myqcloud.com`	string	是

公共请求头部

本页目录：

请求头部列表