doc-exports/docs/obs/api-ref/obs_04_0023.html

Obtaining Bucket Metadata

Functions

This operation queries the metadata of a bucket. To use this operation, you must have the permission to read the bucket.

Request Syntax

1 2 3 4

HEAD / HTTP/1.1 Host: bucketname.obs.region.example.com Date: date Authorization: authorization

Request Parameters

This request contains no parameter.

Request Headers

This request uses common headers. For details, see Table 3.

Table 1 lists the header fields required when obtaining CORS configuration information.

Table 1 Request headers for obtaining CORS configuration

Header	Description	Mandatory
Origin	Origin of the cross-domain request specified by the pre-request. Generally, it is a domain name. Type: string	Yes
Access-Control-Request-Headers	HTTP headers of a request. The request can use multiple HTTP headers. Type: string	No

Request Elements

This request contains no elements.

Response Syntax

1 2 3

HTTP/1.1 status_code x-obs-bucket-location: region Date: date

Response Headers

The response to the request uses common headers. For details, see Table 1.

Table 2 lists additional response header parameters that are used except for the common response header parameters.

Table 2 Additional response header parameters

Header	Description
x-obs-bucket-location	The region where the bucket resides. Type: string
x-obs-storage-class	Default storage class of the bucket. The options are as follows: STANDARD (Standard storage class), WARM (Warm storage class), and COLD (Cold storage class). Type: string
x-obs-version	OBS version of the bucket. Type: string
x-obs-epid	Enterprise project ID of the current bucket. Type: string
Access-Control-Allow-Origin	Indicates that the origin is included in the response if the origin in the request meets the CORS configuration requirements when CORS is configured for buckets. Type: string
Access-Control-Allow-Headers	Indicates that the headers are included in the response if headers in the request meet the CORS configuration requirements when CORS is configured for buckets. Type: string
Access-Control-Max-Age	Value of MaxAgeSeconds in the CORS configuration of the server when CORS is configured for buckets. Type: integer
Access-Control-Allow-Methods	Indicates that methods in the rule are included in the response if Access-Control-Request-Method in the request meets the CORS configuration requirements when CORS is configured for buckets. Type: string Valid values: GET, PUT, HEAD, POST, and DELETE.
Access-Control-Expose-Headers	Value of ExposeHeader in the CORS configuration of a server when CORS is configured for buckets. Type: string

Response Elements

This response involves no elements.

Error Responses

No special error responses are involved. For details about error responses, see Table 2.

Sample Request 1

No header field for obtaining CORS configuration is carried.

1 2 3 4 5 6

HEAD / HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.region.example.com Accept: */* Date: WED, 01 Jul 2015 02:30:25 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:niCQCuGIZpETKIyx1datxHZyYlk=

Sample Response 1

1 2 3 4 5 6 7 8 9 10

HTTP/1.1 200 OK Server: OBS x-obs-request-id: BF260000016439C734E0788404623FA8 Content-Type: application/xml x-obs-storage-class: STANDARD x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSxwLpq9Hzf3OnaXr+pI/OPLKdrtiQAF Date: WED, 01 Jul 2015 02:30:25 GMT x-obs-bucket-location: region x-obs-version: 3.0 Content-Length: 0

Sample Request 2

Obtain bucket metadata and CORS configuration information after CORS is configured for the bucket.

1 2 3 4 5 6 7 8

HEAD / HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.region.example.com Accept: */* Date: WED, 01 Jul 2015 02:30:25 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:niCQCuGIZpETKIyx1datxHZyYlk= Origin:www.example.com Access-Control-Request-Headers:AllowedHeader_1

Sample Response 2

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15

HTTP/1.1 200 OK Server: OBS x-obs-request-id: BF260000016439C734E0788404623FA8 Content-Type: application/xml x-obs-storage-class: STANDARD x-obs-id-2: 32AAAQAAEAABAAAQAAEAABAAAQAAEAABCSxwLpq9Hzf3OnaXr+pI/OPLKdrtiQAF Date: WED, 01 Jul 2015 02:30:25 GMT x-obs-bucket-location: region Access-Control-Allow-Origin: www.example.com Access-Control-Allow-Methods: POST,GET,HEAD,PUT Access-Control-Allow-Headers: AllowedHeader_1 Access-Control-Max-Age: 100 Access-Control-Expose-Headers: ExposeHeader_1 x-obs-version: 3.0 Content-Length: 0

Parent topic: Operations on Buckets