# 获取桶元数据
#### 功能说明
对桶发送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());              
}
```