获取桶元数据
功能说明
对桶发送HEAD请求,获取桶的存储类型,CORS规则(若已设置)等信息。
方法定义
1. ObsClient->getBucketMetadata(array $parameter) 2. ObsClient->getBucketMetadata(array $parameter, callable $callback)
请求参数
字段名 |
类型 |
约束 |
说明 |
---|---|---|---|
Bucket |
string |
必选 |
桶名。 |
Origin |
string |
可选 |
预请求指定的跨域请求Origin(通常为域名)。 |
RequestHeader |
string |
可选 |
跨域请求可以使用的HTTP头域。 |
返回结果
字段名 |
类型 |
说明 |
---|---|---|
HttpStatusCode |
integer |
HTTP状态码。 |
Reason |
string |
HTTP文本描述。 |
RequestId |
string |
OBS服务端返回的请求ID。 |
Location |
string |
桶的区域位置。 |
StorageClass |
string |
桶的存储类型,当桶存储类型是标准存储时,该值为空。 |
AllowOrigin |
string |
如果请求中的Origin满足服务端的CORS规则,则返回服务端CORS配置中的AllowedOrigin。 |
AllowHeader |
string |
如果请求的RequestHeader满足服务端的CORS规则,则返回服务端CORS配置中的AllowedHeader。 |
AllowMethod |
string |
服务端CORS规则中的AllowedMethod。 |
ExposeHeader |
string |
服务端CORS规则中的ExposeHeader。 |
MaxAgeSeconds |
integer |
服务端CORS规则中的MaxAgeSeconds。 |
代码样例
try{ $resp = $obsClient -> getBucketMetadata([ 'Bucket' => 'bucketname', 'Origin' => 'http://www.a.com', 'RequestHeader' => 'x-obs-header' ]); printf("RequestId:%s\n", $resp['RequestId']); printf("StorageClass:%s\n", $resp['StorageClass']); printf("AllowOrigin:%s\n", $resp['AllowOrigin']); printf("AllowHeader:%s\n", $resp['AllowHeader']); printf("AllowMethod:%s\n", $resp['AllowMethod']); printf("ExposeHeader:%s\n", $resp['ExposeHeader']); printf("MaxAgeSeconds:%s\n", $resp['MaxAgeSeconds']); }catch (Obs\Common\ObsException $obsException){ printf("StatusCode:%s\n", $obsException->getStatusCode()); }