Reviewed-by: Sabelnikov, Dmitriy <dmitriy.sabelnikov@t-systems.com> Reviewed-by: Hasko, Vladimir <vladimir.hasko@t-systems.com> Co-authored-by: zhangyue <zhangyue164@huawei.com> Co-committed-by: zhangyue <zhangyue164@huawei.com>
17 KiB
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 parameters.
Request Headers
This request uses common headers. For details, see Table 3.
Table 1 lists the header fields required when obtaining CORS configuration information.
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.
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), WARM (Warm), and COLD (Cold). Type: string |
x-obs-version |
OBS version of the bucket. Type: string |
x-obs-fs-file-interface |
Indicates whether the bucket is a parallel file system. The value can be Enabled (parallel file system). If this header field is not carried, the bucket is not a parallel file system. 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 returned. 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 |