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

创建桶

功能说明

按照用户指定的桶名创建一个新桶。新创建桶的桶名在OBS中必须是唯一的。除同一个用户重复创建同一区域的同名桶外，其他场景重复创建同名桶均会失败。一个用户可以拥有的桶的数量不能超过100个。

方法定义

1. ObsClient->createBucket(array $parameter)
2. ObsClient->createBucketAsync(array $parameter, callable $callback)

请求参数

字段名

类型

约束

说明

Bucket

string

必选

桶名。

桶命名规则如下：
  • 3～63个字符，数字或字母开头，支持小写字母、数字、“-”、“.”。
  • 禁止使用类IP地址。
  • 禁止以“-”或“.”开头及结尾。
  • 禁止两个“.”相邻（如：“my..bucket”）。
  • 禁止“.”和“-”相邻（如：“my-.bucket”和“my.-bucket”）。

ACL

string

可选

创桶时可指定的预定义访问策略。

StorageClass

string

可选

创桶时可指定的桶的存储类型。

LocationConstraint

string

如果请求的OBS服务地址所在区域为默认区域，则可为空，否则为必选。

桶所在的区域。

返回结果

字段名

类型

说明

HttpStatusCode

integer

HTTP状态码。

Reason

string

HTTP文本描述。

RequestId

string

OBS服务端返回的请求ID。

代码样例

try{
       $resp = $obsClient -> createBucket([
              'Bucket' => 'bucketname',
              'ACL' => 'private',
              'StorageClass' => ObsClient::StorageClassStandard
       ]);
       printf("RequestId:%s\n", $resp['RequestId']);
}catch (Obs\Common\ObsException $obsException){
       printf("ExceptionCode:%s\n", $obsException->getExceptionCode());              
       printf("ExceptionMessage:%s\n", $obsException->getExceptionMessage());
}
父主题： 桶相关接口