更新时间：2021-03-18 GMT+08:00

获取桶元数据

功能说明

对桶发送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());              
}