文档首页/ 对象存储服务 OBS/ API参考 (PHP SDK)（联盟区域）/ 桶相关接口/ 获取桶元数据
更新时间：2026-01-15 GMT+08:00
查看PDF
分享

获取桶元数据

功能说明

对桶发送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());              
}
父主题： 桶相关接口