获取桶元数据
功能介绍
对桶拥有读权限的用户可以执行查询桶元数据是否存在的操作。
请求消息样式
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-storage-class |
桶的默认存储类型。包含：STANDARD（标准存储）、WARM（温存储）、COLD（冷存储） 类型：String |
|
x-obs-version |
桶所在的OBS服务版本号。 类型：String |
|
x-obs-fs-file-interface |
是否为并行文件系统。取值包含Enabled（并行文件系统）。 不携带此头域表示不属于并行文件系统。 类型：String |
|
x-obs-epid |
当前桶的企业项目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 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
|
请求示例：桶设置了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 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
|
