获取桶元数据
功能介绍
对桶拥有读权限的用户可以执行查询桶元数据是否存在的操作。
请求消息样式
1 2 3 4 |
HEAD / HTTP/1.1 Host: bucketname.obs.region.example.com Date: date Authorization: authorization |
请求消息参数
该请求消息中不带消息参数。
请求消息元素
该请求消息中不带消息元素。
响应消息样式
1 2 3 |
HTTP/1.1 status_code x-obs-bucket-location: region Date: date |
响应消息头
该请求的响应消息使用公共消息头，具体请参考表1。
除公共响应消息头之外，还可能使用如下表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 |
