HEAD Bucket

After being granted the READ permission for a bucket, you can use this operation to query whether bucket metadata exists.

Request Syntax

HEAD / HTTP/1.1
Host: bucketname.obs.cn-north-1.myhwclouds.com
Date: date
Authorization: authorization

Request Parameters

This request contains no parameter.

Request Headers

This request uses common headers. For details, see Common Request Headers.

Request Elements

This request contains no element.

Response Syntax

HTTP/1.1 status_code
x-amz-bucket-region: region
Date: date

Response Headers

This response uses common headers. For details, see Common Response Headers.

In addition to common headers, you may use the response headers in Table 1.

Table 1 Additional response headers

Header

Description

x-amz-bucket-region

Indicates the region where the bucket resides.

Type: string

x-default-storage-class

Indicates the default storage class of the current bucket. There are three storage classes: STANDARD (OBS Standard), STANDARD_IA (OBS Infrequent Access), and GLACIER (OBS Archive).

Type: string

Response Elements

This response contains no element.

Error Responses

No special error responses are returned. For details about error responses, see Table 1.

Registration