# 创建桶 #### 功能说明 按照用户指定的桶名创建一个新桶。新创建桶的桶名在OBS中必须是唯一的。一个用户可以拥有的桶的数量不能超过100个。 ![](https://support.huaweicloud.com/utiltg-obs/public_sys-resources/note_3.0-zh-cn.png) 如果是同一个用户在同一区域的重复创建同名桶不会报错，返回HTTP状态码200，创建的桶属性以第一次请求为准。除此以外的其他场景重复创建同名桶返回HTTP状态码409，表明桶已存在。 ![](https://support.huaweicloud.com/utiltg-obs/public_sys-resources/notice_3.0-zh-cn.png) 如果您当前配置的endpoint是全局域名（obs.myhuaweicloud.com），创建桶成功后您可能需要等待几分钟才能上传对象；如果您希望创建成功后能够立即上传对象，请参考[初始化配置](https://support.huaweicloud.com/utiltg-obs/obs_11_0005.html)将endpoint配置为区域域名（obs.***RegionID*** .myhuaweicloud.com，其中***RegionID*** 为区域ID，您可以从[这里](https://developer.huaweicloud.com/endpoint?OBS)查看各个区域对应的区域域名。 #### 命令结构 - 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：归档存储，安全、持久且成本极低，适用于很少访问（平均一年访问一次）数据的业务场景。 - deep-archive：深度归档存储，适用于长期不访问（平均几年访问一次）数据的业务场景，其成本相比归档存储更低，但相应的数据恢复时间将更长，一般为数小时。 | | location | 附加参数，如果请求的OBS服务地址所在区域为默认区域，则可为空，否则为必选 | 桶所在的区域。 当前有效的区域名称可从[这里](https://developer.huaweicloud.com/endpoint?OBS)查询。 - **桶创建成功后，不支持变更区域，请谨慎选择。** - 请选择靠近您业务的区域创建桶，以降低网络时延，提高访问速度。 - 如果希望ECS通过内网访问OBS桶，需要确保桶和ECS属于同一个区域，详情请参见[在ECS上通过内网访问OBS](https://support.huaweicloud.com/bestpractice-obs/obs_05_0410.html)。 说明： 该参数定义了桶将会被创建在哪个区域，如果使用的终端节点归属于默认区域华北-北京一（cn-north-1），可以不携带此参数；如果使用的终端节点归属于其他区域，则必须携带此参数。 | | config | 附加参数，可选 | 运行当前命令时的自定义配置文件。可支持的配置参数请参考[配置参数说明](https://support.huaweicloud.com/utiltg-obs/obs_11_0035.html)。 | | e | 附加参数，可选 | 指定终端节点。 | | i | 附加参数，可选 | 指定用户的AK。 | | k | 附加参数，可选 | 指定用户的SK。 | | t | 附加参数，可选 | 指定用户的securitytoken。 |