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 | Network connection status between the client and the server. Enumerated values: keep-alive and close. |
Enum |
| Date | Server response time in GMT format as defined in RFC 1123. | String |
| Etag | An entity tag (ETag) identifies the object content upon creation. The value of ETag is not necessarily the MD5 checksum of the object according to different request situations. The value of ETag can be used to check whether the object content is changed. | String |
| 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. | String |
Server-Side Encryption Dedicated Header
For APIs that support Server Side Encryption (SSE) and use SSE in requests, response headers described in the following are returned based on the specific encryption type. For details, see Server-side Encryption Overview.
SSE-COS
| Header Name | Description | Type |
| x-cos-server-side-encryption | When SSE-COS is used during object upload or objects encrypted with SSE-COS are downloaded, responses to the request carry this header, indicating that the SSE algorithm is used during object upload. | string |
SSE-KMS
| Header Name | Description | Type |
|---|---|---|
| x-cos-server-side-encryption | When SSE-KMS is used during object upload or objects encrypted with SSE-KMS are downloaded, responses to the request carry this header, indicating that the SSE algorithm is used during object upload. | string |
| x-cos-server-side-encryption-cos-kms-key-id | The customer master key (CMK) of the Key Management Service (KMS) is returned. If it is not specified, the CMK created by COS by default is returned. | string |
SSE-C
| Header Name | Description | Type |
|---|---|---|
| x-cos-server-side-encryption-customer-algorithm | When SSE-C is used during object upload or objects encrypted with SSE-C are downloaded, responses to the request carry this header, indicating that the SSE algorithm is used during object upload. | string |
| x-cos-server-side-encryption-customer-key-MD5 | Base64-encoded MD5 hash value of the SSE key used during object upload. For example, U5L61r7jcwdNvT7frmUG8g==. |
string |