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.myhuaweicloud.com Date: date Authorization: authorization |
Request Parameters
This request contains no parameters.
Request Headers
This request uses common headers. For details, see Table 3.
If you want to get CORS configuration information, you must use the headers in Table 1.
Header |
Type |
Mandatory (Yes/No) |
Description |
---|---|---|---|
Origin |
String |
Yes |
Explanation: Origin of the cross-domain request specified by the pre-request. Generally, it is a domain name. Restrictions: You can enter multiple origins, with one separated from another using a line break. Each origin can contain at most one wildcard character (*). Value range: An HTTP-compliant header value Default value: None |
Access-Control-Request-Headers |
String |
No |
Explanation: HTTP headers in a request Restrictions: You can enter multiple allowed headers, with one separated from another using a line break. Each header can contain one wildcard character (*) at most. Spaces, ampersands (&), colons (:), and less-than signs (<) are not allowed. Value range: An HTTP-compliant header value Default value: None |
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.
In addition to the common response headers, the headers listed in Table 2 may be used.
Header |
Type |
Description |
---|---|---|
x-obs-bucket-location |
String |
Explanation: The region where the bucket resides. Restrictions: None Value range: None Default value: None |
x-obs-storage-class |
String |
Explanation: Default storage class of the bucket. Restrictions: None Value range:
Default value: None |
x-obs-version |
String |
Explanation: OBS version of the bucket. Restrictions: None Value range:
Default value: None |
x-obs-fs-file-interface |
String |
Explanation: Whether it is a parallel file system Restrictions: If this header field is not carried, the bucket is not a parallel file system. Value range: The value can be Enabled (parallel file system). Default value: None |
x-obs-epid |
String |
Explanation: Enterprise project ID for the current bucket. Users who have enabled the enterprise project function can obtain the ID from the enterprise project service. Restrictions: The value is a UUID. This parameter is not required if you have not enabled an enterprise project. Value range: See How Do I Obtain an Enterprise Project ID? Default value: None |
x-obs-az-redundancy |
String |
Explanation: Specifies an AZ redundancy type. Value 3az indicates that data is stored in multiple AZs in the same region. If this header field is not carried, data is stored in a single AZ. Restrictions: Multi-AZ redundancy is not available for Archive and Deep Archive storage. If the region where the bucket is located does not support multi-AZ storage, single-AZ storage is used by default. Value range: If multi-AZ storage is configured for the bucket, 3az is returned. If single-AZ storage is configured for the bucket, None is returned. Default value: None |
Access-Control-Allow-Origin |
String |
Explanation: 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. Restrictions: None Value range: The value that complies with the CORS Default value: None |
Access-Control-Allow-Headers |
String |
Explanation: 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. Restrictions: None Value range: The value that complies with the CORS Default value: None |
Access-Control-Max-Age |
Integer |
Explanation: Value of MaxAgeSeconds in the CORS configuration of the server when CORS is configured for buckets. Restrictions: None Value range: An integer greater than or equal to 0, in seconds Default value: 3000 |
Access-Control-Allow-Methods |
String |
Explanation: 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. Restrictions: None Value range:
Default value: None |
Access-Control-Expose-Headers |
String |
Explanation: ExposeHeader in the CORS rules of the bucket. It specifies additional headers allowed in the response by a CORS rule, which are used to provide extra information to clients. By default, a browser can access only headers Content-Length and Content-Type. If the browser needs to access other headers, you need to configure them in this parameter. Restrictions: Spaces, wildcard characters (*), ampersands (&), colons (:), less-than signs (<), and full-width characters are not allowed. Value range: None Default value: None |
Response Elements
This response contains no elements.
Error Responses
No special error responses are returned. For details about error responses, see Table 2.
Sample Request: Getting CORS Configuration (with No Headers Specified)
1 2 3 4 5 6 |
HEAD / HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.region.myhuaweicloud.com Accept: */* Date: WED, 01 Jul 2015 02:30:25 GMT Authorization: OBS H4IPJX0TQTHTHEBQQCEC:niCQCuGIZpETKIyx1datxHZyYlk= |
Sample Response: Getting CORS Configuration (with No Headers Specified)
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: Getting Bucket Metadata and CORS Configuration
1 2 3 4 5 6 7 8 |
HEAD / HTTP/1.1 User-Agent: curl/7.29.0 Host: examplebucket.obs.region.myhuaweicloud.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: Getting Bucket Metadata and CORS Configuration
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 |
Feedback
Was this page helpful?
Provide feedbackThank you very much for your feedback. We will continue working to improve the documentation.See the reply and handling status in My Cloud VOC.
For any further questions, feel free to contact us through the chatbot.
Chatbot