Common HTTP headers - API Reference| Alibaba Cloud Documentation Center

Common HTTP headers

Edit in GitHub

Last Updated: May 07, 2020 Edit in GitHub

This topic describes common HTTP request and response headers.

Common request headers

In OSS, common HTTP request headers are used for RESTful APIs. These request headers can be used in all OSS requests. The following table lists the specific definitions of the request headers.


Header	Type	Description
Authorization	String	The verification information used to verify the validity of a request. Default value: null. Scenario: non-anonymous requests.
Content-Length	String	The content length of an HTTP request defined in RFC 2616. Default value: null. Scenario: requests that need to submit data to OSS.
Content-Type	String	The content type of an HTTP request defined in RFC 2616. Default value: null. Scenario: requests that need to submit data to OSS.
Date	String	The time in GMT stipulated in HTTP/ 1.1. Example: Wed, 05 Sep. 2012 23:00:00 GMT. Default value: null.
Host	String	The value of the host to access. Format: `<bucketname>.oss-cn-hangzhou.aliyuncs.com`. Default value: null.

Common response headers

In OSS, common HTTP response headers are used for RESTful APIs. These response headers can be used by all the OSS requests. The following table lists the specific definitions of the response headers.


Parameter	Type	Description
Content-Length	String	The content length of an HTTP request defined in RFC2616. Default value: null. Scenario: requests that need to submit data to OSS.
Connection	Filter by value	The connection status between the client and the OSS server. Valid values: open and close. Default value: null.
Date	String	The time in GMT stipulated in HTTP/ 1.1. Example: Wed, 05 Sep. 2012 23:00:00 GMT. Default value: null.
ETag	String	The ETag that is created to identify the content of the object when the object is created. If an object is created by using the PutObject request, the ETag value of the object is the MD5 hash of the object content. If an object is created by using another method, the ETag value of the content is the universally unique identifier (UUID) of the object content. The ETag value of the object can be used to check whether the object content is modified. Default value: null.
Server	String	The server that generates a response. Default value: AliyunOSS.
x-oss-request-id	String	The UUID that is created by the OSS server to identify the response. If you encounter any problems when you use OSS, you can contact OSS support personnel and provide this field to help them locate the problem. Default value: null.