文档首页/ 对象存储服务 OBS/ 工具指南（obsutil）（阿布扎比区域）/ 桶相关命令/ 创建桶
更新时间：2023-03-16 GMT+08:00
查看PDF
分享

创建桶

功能说明

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

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

命令结构

  • Windows操作系统 
    obsutil mb obs://bucket [-fs] [-acl=xxx] [-sc=xxx] [-location=xxx] [-config=xxx]
  • macOS/Linux操作系统 
    ./obsutil mb obs://bucket [-fs] [-acl=xxx] [-sc=xxx] [-location=xxx] [-config=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

必选

桶名。

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

fs

附加参数，可选

创建并行文件系统。

acl

附加参数，可选

创桶时可指定的预定义访问策略。支持的值：

  • private
  • public-read
  • public-read-write
说明：

以上三个值分别对应：私有读写、公共读、公共读写。

sc

附加参数，可选

创桶时可指定的桶的默认存储类型。支持的值：

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

location

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

桶所在的区域。

config

附加参数，可选

运行当前命令时的自定义配置文件，可支持的配置参数请参考配置参数说明。
父主题： 桶相关命令