更新时间:2024-04-15 GMT+08:00

获取桶元数据

功能介绍

对桶拥有读权限的用户可以执行查询桶元数据是否存在的操作。

请求消息样式

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

请求消息参数

该请求消息中不带消息参数。

请求消息头

该请求使用公共消息头,具体参见表3

如果想要获取CORS配置信息,则需要使用的消息头如下表1 获取CORS配置的请求消息头所示。

表1 获取CORS配置的请求消息头

消息头名称

描述

是否必选

Origin

预请求指定的跨域请求Origin(通常为域名)。

类型:String

Access-Control-Request-Headers

实际请求可以带的HTTP头域,可以带多个头域。

类型:String

请求消息元素

该请求消息中不带消息元素。

响应消息样式

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

响应消息头

该请求的响应消息使用公共消息头,具体请参考表1

除公共响应消息头之外,还可能使用如下表2 附加响应消息头中的消息头。

表2 附加响应消息头

消息头名称

描述

x-obs-bucket-location

桶的区域位置信息。

类型:String

x-obs-version

桶所在的OBS服务版本号。

类型:String

x-obs-fs-file-interface

是否为并行文件系统。取值包含Enabled(并行文件系统)。

不携带此头域表示不属于并行文件系统。

类型:String

x-obs-az-redundancy

桶的数据冗余存储策略属性,决定数据是单AZ存储还是多AZ存储。

取值为3az,表示数据冗余存储在同一区域的多个可用区。

不携带此头域表示为单az存储,仅使用1个可用区存储。

类型:String

x-obs-location-clustergroup-id

桶所在的集群组ID。

类型:String

Access-Control-Allow-Origin

当桶设置了CORS配置,如果请求的Origin满足服务端的CORS配置,则在响应中包含这个Origin。

类型:String

Access-Control-Allow-Headers

当桶设置了CORS配置,如果请求的headers满足服务端的CORS配置,则在响应中包含这个headers。

类型:String

Access-Control-Max-Age

当桶设置了CORS配置,服务端CORS配置中的MaxAgeSeconds。

类型:Integer

Access-Control-Allow-Methods

当桶设置了CORS配置,如果请求的Access-Control-Request-Method满足服务端的CORS配置,则在响应中包含这条rule中的Methods。

类型:String

有效值:GET、PUT、HEAD、POST 、DELETE

Access-Control-Expose-Headers

当桶设置了CORS配置,服务端CORS配置中的ExposeHeader。

类型:String

响应消息元素

该请求的响应中不带有响应元素。

错误响应消息

无特殊错误,所有错误已经包含在表2中。

请求示例:未携带获取CORS配置

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=

响应示例:未携带获取CORS配置

1
2
3
4
5
6
7
8
9
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016439C734E0788404623FA8
Content-Type: application/xml
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

请求示例:桶设置了CORS后,获取桶元数据和CORS配置

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

响应示例:桶设置了CORS后,获取桶元数据和CORS配置

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
HTTP/1.1 200 OK
Server: OBS
x-obs-request-id: BF260000016439C734E0788404623FA8
Content-Type: application/xml
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