更新时间：2024-09-03 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 Create bucket [bucket-test] successfully, request id [0000016979E1D2EA860BB5E80A6B8FCC]
- 以Windows操作系统为例，运行obsutil mb obs://bucket001，创建已存在的桶失败。
obsutil mb obs://bucket001 Create bucket [bucket001] failed, http 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 [04030000016757F31A0333281A6B1E92]
参数说明
|
参数 |
约束 |
描述 |
|---|---|---|
|
bucket |
必选 |
桶名。
说明：
桶命名规则如下：
|
|
fs |
附加参数，可选 |
创建并行文件系统。 |
|
az |
附加参数，可选 |
指定桶的数据冗余存储策略。支持的值：
说明：
multi-az代表创建数据冗余存储策略为多AZ存储的桶；不携带此参数代表创建数据冗余存储策略为单AZ存储的桶。 |
|
acl |
附加参数，可选 |
创桶时可指定的预定义访问策略。支持的值：
说明：
以上三个值分别对应：私有读写、公共读、公共读写。 |
|
sc |
附加参数，可选 |
创桶时可指定的桶的默认存储类型。支持的值：
|
|
location |
附加参数，如果请求的OBS服务地址所在区域为默认区域，则可为空，否则为必选 |
桶所在的区域。
说明：
该参数定义了桶将会被创建在哪个区域，如果使用的终端节点归属于默认区域华北-北京一（cn-north-1），可以不携带此参数；如果使用的终端节点归属于其他区域，则必须携带此参数。当前有效的区域名称可从这里查询。 |
|
config |
附加参数，可选 |
运行当前命令时的自定义配置文件，可支持的配置参数请参考配置参数说明。 |
|
e |
附加参数，可选 |
指定终端节点。 |
|
i |
附加参数，可选 |
指定用户的AK。 |
|
k |
附加参数，可选 |
指定用户的SK。 |
|
t |
附加参数，可选 |
指定用户的securitytoken。 |
父主题： 桶相关命令
