描述
此篇文档将为您介绍在使用API时候会出现的公共返回头部(Response Header),下文提到的头部会在之后的具体API文档中不再赘述。
响应头部列表
| Header名称 | 描述 | 类型 |
|---|---|---|
| Content-Length | RFC 2616 中定义的 HTTP 请求内容长度(字节)。 | String |
| Content-Type | RFC 2616 中定义的 HTTP 请求内容类型(MIME)。 | String |
| Connection | 声明客户端与服务端之间的通信状态。 枚举值:keep-alive,close。 |
Enum |
| Date | 服务器端的响应时间,根据 RFC 1123 中定义的 GMT 时间。 | String |
| Etag | ETag 全称 Entity Tag 是 Object 被创建时用于标识 Object 内容的信息标签。此参数并不一定返回 MD5 值,请根据不同请求的情况参考。ETag 的值可以用于检查 Object 的内容是否发生变化。 | String |
| x-cos-request-id | 每次请求发送时,服务端将会自动为请求生成一个ID。 | String |
| x-cos-trace-id | 每次请求出错时,服务端将会自动为这个错误生成一个ID。 | String |
服务端加密专用头部
对于支持服务端加密(Server Side Encryption,SSE)且在请求中使用了服务端加密的接口,将根据具体的加密类型返回以下响应头,详情请参见 服务端加密概述。
SSE-COS
| Header 名称 | 描述 | 类型 |
| x-cos-server-side-encryption | 当上传对象时使用了 SSE-COS,或者下载经过 SSE-COS 加密的对象时,请求的响应均会返回此头部,用于表明对象上传时使用的服务端加密算法。 | string |
SSE-KMS
| Header 名称 | 描述 | 类型 |
|---|---|---|
| x-cos-server-side-encryption | 当上传对象时使用了 SSE-KMS,或者下载经过 SSE-KMS 加密的对象时,请求的响应均会返回此头部,用于表明对象上传时使用的服务端加密算法。 | string |
| x-cos-server-side-encryption-cos-kms-key-id | 返回 KMS(密钥管理系统)的用户主密钥 CMK。如未指定,则返回 COS 默认创建的 CMK。 | string |
SSE-C
| Header 名称 | 描述 | 类型 |
|---|---|---|
| x-cos-server-side-encryption-customer-algorithm | 当上传对象时使用了 SSE-C,或者下载经过 SSE-C 加密的对象时,请求的响应均会返回此头部,用于表明对象上传时使用的服务端加密算法。 | string |
| x-cos-server-side-encryption-customer-key-MD5 | 对象上传时使用的服务端加密密钥的 MD5 哈希值,使用 Base64 编码 例如 U5L61r7jcwdNvT7frmUG8g==。 |
string |