更新时间:2025-08-22 GMT+08:00

创建桶

功能说明

按照用户指定的桶名创建一个新桶。新创建桶的桶名在OBS中必须是唯一的。一个用户可以拥有的桶的数量不能超过100个。

如果是同一个用户在同一区域的重复创建同名桶不会报错,返回HTTP状态码200,创建的桶属性以第一次请求为准。除此以外的其他场景重复创建同名桶返回HTTP状态码409,表明桶已存在。

如果您当前配置的endpoint是全局域名,创建桶成功后您可能需要等待几分钟才能上传对象;如果您希望创建成功后能够立即上传对象,请参考初始化配置将endpoint配置为区域域名。

命令结构

  • Windows操作系统
    obsutil mb obs://bucket [-fs] [-az=xxx] [-acl=xxx] [-sc=xxx] [-location=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]
  • macOS/Linux操作系统
    ./obsutil mb obs://bucket [-fs] [-az=xxx] [-acl=xxx] [-sc=xxx] [-location=xxx] [-config=xxx] [-e=xxx] [-i=xxx] [-k=xxx] [-t=xxx]

运行示例

  • 以Windows操作系统为例,运行obsutil mb obs://bucket-test,创建新桶成功。
    obsutil mb obs://bucket-test
    Start at 2024-09-29 07:52:11.3769487 +0000 UTC
    
    Create bucket [bucket-test] successfully, request id [000001923CC401864018BA75753D2D5F]
    
  • 以Windows操作系统为例,运行obsutil mb obs://bucket001,创建其他账户下已存在的桶失败。
    obsutil mb obs://bucket001
    Start at 2024-09-30 07:03:50.1378331 +0000 UTC
    
    Create bucket [bucket001] failed, status [409], error code [BucketAlreadyExists], error message [The requested bucket name is not available. The bucket namespace is shared by all users of the system. Please select a different name and try again.], request id [0000019241BE18DB4019EDD66E135C56]

参数说明

参数

约束

描述

bucket

必选

桶名称。

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

fs

附加参数,可选

创建并行文件系统。

az

附加参数,可选

指定桶的数据冗余存储策略,让桶中的数据在同区域的多个可用区(AZ)或单个可用区中存储。

支持的值:multi-az

“multi-az”代表创建数据冗余存储策略为多AZ存储的桶;不携带此参数代表创建数据冗余存储策略为单AZ存储的桶。

acl

附加参数,可选

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

支持的值:

  • private:私有读写,除桶ACL授权外的其他用户无桶的访问权限。
  • public-read:公共读,何用户都可以对桶内对象进行读操作。
  • public-read-write:公共读写,任何用户都可以对桶内对象进行读/写/删除操作。

sc

附加参数,可选

桶的存储类别。

不同的存储类别可以满足客户业务对存储性能、成本的不同诉求。

支持的值:

  • standard:标准存储,访问时延低、吞吐量高,适用于有大量热点文件(平均一个月多次)或小文件(小于1MB)。
  • warm:低频访问存储,可用性略低于standard,适用于不频繁访问(平均一年少于12次)但在需要时也要求快速访问数据的业务场景。
  • cold:归档存储,安全、持久且成本极低,适用于很少访问(平均一年访问一次)数据的业务场景。

location

附加参数,如果请求的OBS服务地址所在区域为默认区域,则可为空,否则为必选

桶所在的区域。

当前有效的区域名称可从这里查询。

  • 桶创建成功后,不支持变更区域,请谨慎选择。
  • 请选择靠近您业务的区域创建桶,以降低网络时延,提高访问速度。
  • OBS大部分特性在所有区域发布,某些特性仅在部分区域发布。如果您创建的桶需要使用某些特性,建议根据功能总览中特性发布区域选择桶所属区域。
  • 如果希望ECS通过内网访问OBS桶,需要确保桶和ECS属于同一个区域,详情请参见在ECS上通过内网访问OBS
说明:

该参数定义了桶将会被创建在哪个区域,如果使用的终端节点归属于默认区域华北-北京一(cn-north-1),可以不携带此参数;如果使用的终端节点归属于其他区域,则必须携带此参数。

config

附加参数,可选

运行当前命令时的自定义配置文件。

可支持的配置参数请参考配置参数说明

e

附加参数,可选

指定终端节点。

i

附加参数,可选

指定用户的AK。

k

附加参数,可选

指定用户的SK。

t

附加参数,可选

指定用户的securitytoken。