公共响应头部

最后更新时间:2020-08-31 17:13:40

    描述

    此篇文档将为您介绍在使用 API 时会出现的公共响应头部(Response Header),下文提到的头部在后续的具体 API 文档中不再赘述。

    响应头部列表

    Header 名称 描述 类型
    Content-Length RFC 2616 中定义的 HTTP 响应内容长度(字节)。 string
    Content-Type RFC 2616 中定义的 HTTP 响应内容类型(MIME)。 string
    Connection RFC 2616 中定义,表明响应完成后是否会关闭网络连接。枚举值:keep-alive,close。 enum
    Date RFC 1123 中定义的 GMT 格式服务端响应时间,例如Wed, 29 May 2019 04:10:12 GMT string
    ETag ETag 全称为 Entity Tag,是对象被创建时标识对象内容的信息标签,可用于检查对象的内容是否发生变化,例如"8e0b617ca298a564c3331da28dcb50df"。此头部并不一定返回对象的 MD5 值,而是根据对象上传和加密方式而有所不同。 string
    Last-Modified 对象的最近一次上传的时间,例如Fri, 10 Apr 2020 18:17:25 GMT string
    Server 接收请求并返回响应的服务器的名称,默认值:tencent-cos string
    Transfer-Encoding RFC 2616 中定义的传输编码格式。 string
    x-cos-hash-crc64ecma 对象的 CRC64 值,详情请参见 CRC64 校验 文档。 integer
    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

    Was this page helpful?

    本页内容是否解决了您的问题?

    • 完全没帮助
    • 文档较差
    • 文档一般
    • 文档不错
    • 文档很好
    反馈
    帮助