Common Request Headers

Table 1 describes headers common to OBS REST requests.

Table 1 Common request headers

Header

Description

Remarks

Authorization

Indicates the authentication information carried in a request.

Type: String

Default: None

Conditional: optional for anonymous requests and mandatory for other requests

Content-Length

Indicates the length of request content (excluding headers) defined by RFC 2616.

Type: String

Default: None

Conditional: mandatory for PUT requests and requests that load XML content

Content-Type

Indicates the content type of a requested resource, for example, text/plain.

Type: String

Default: None

Optional

Date

Indicates the date and time at which a request is initiated.

Type: String

Default: None

Conditional: optional for anonymous requests or requests containing optional header x-amz-date

Host

Indicates a host address. For example, bucketname.obs.example.com.

Type: String

Default: None

Mandatory

x-amz-security-token

Header field used to identify the request of a federated user. When the federal authentication function is enabled, users sending such requests are identified as federated users.

Type: string

Optional. This parameter must be carried in the request sent by federated users.