Common Response Headers

Last updated: 2020-07-24 16:49:05

    Description

    This document describes common response headers that may be used in API requests. The headers mentioned below will not be addressed again in related API documents.

    Response Headers

    Header Name Description Type
    Content-Length HTTP response length in bytes as defined in RFC 2616 string
    Content-Type HTTP response type (MIME) as defined in RFC 2616. string
    Connection Indicates whether the network connection will be turned off after the response is complete, defined in RFC 2616. Enumerated values: `keep-alive`, `close`. Enum
    Date Server response time in GMT format as defined in RFC 1123, such as Wed, 29 May 2019 04:10:12 GMT. string
    ETag An entity tag (ETag) is an information tag that identifies the content of an object when it is created. The tag can be used to check whether the content of the object has changed. For instance, the header "8e0b617ca298a564c3331da28dcb50df"does not necessarily return the MD5 value of the object, but varies depending on how the object is uploaded and encrypted. string
    Last-Modified The time the object was last uploaded, e.g. Fri, 10 Apr 2020 18:17:25 GMT. string
    Server Name of the server that accepts the request and returns the response. Default value: tencent-cos. string
    Transfer-Encoding Transfer encoding format as defined in RFC 2616. string
    x-cos-hash-crc64ecma CRC64 value of the object. For more information, see [CRC64 Check] (https://intl.cloud.tencent.com/document/product/436/34078) integer
    x-cos-request-id An ID automatically generated by the server for each request when it is sent. string
    x-cos-trace-id An ID automatically generated by the server for each error when a request fails. This header will be included in the response only if the request has failed. string

    Server-side encryption headers

    For APIs that support server-side encryption (SSE) and use SSE in the request, the following response headers will be returned according to the specific encryption method. For more information, see Server-side Encryption Overview.

    SSE-COS

    Header Name Description Type
    x-cos-server-side-encryption If an object is uploaded with SSE-COS or an object encrypted with SSE-COS is downloaded, the request response will return this header, indicating the server-side encryption algorithm used during object upload. string

    SSE-KMS

    Header Name Description Type
    x-cos-server-side-encryption-customer-algorithm If an object is uploaded with SSE-C or an object encrypted with SSE-C is downloaded, the request response will return this header, indicating the server-side encryption algorithm used during object upload string
    x-cos-server-side-encryption-cos-kms-key-id Returns the customer master key (CMK) of the Key Management Service (KMS), if not specified, the default CMK created by COS will be returned. string

    SSE-C

    Header Name Description Type
    x-cos-server-side-encryption-customer-algorithm If an object is uploaded with SSE-C or an object encrypted with SSE-C is downloaded, the request response will return this header, indicating the server-side encryption algorithm used during object upload string
    x-cos-server-side-encryption-customer-key-MD5 Base64-encoded MD5 hash of the server-side encryption key used during object upload, e.g., U5L61r7jcwdNvT7frmUG8g== string

    Was this page helpful?

    Was this page helpful?

    • Not at all
    • Not very helpful
    • Somewhat helpful
    • Very helpful
    • Extremely helpful
    Send Feedback
    Help