文档首页/ OBS Node.js SDK/ API参考/ 桶相关接口/ 创建桶
更新时间：2023-11-08 GMT+08:00
查看PDF
分享

创建桶

功能说明

按照用户指定的桶名创建一个新桶。新创建桶的桶名在OBS中必须是唯一的。如果是同一个用户重复创建同一区域的同名桶时返回HTTP状态码200。除此以外的其他场景重复创建同名桶返回HTTP状态码409，表明桶已存在。一个用户可以拥有的桶的数量不能超过100个。

ObsClient的桶相关操作接口函数均支持首字母大小写，如ObsClient.createBucket和ObsClient.CreateBucket是相同的函数。

方法定义

ObsClient.createBucket

请求参数

字段名

类型

约束

说明

Bucket

String

必选

桶名。

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

ACL

String

可选

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

StorageClass

String

可选

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

Location

String

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

桶所在的区域。

该参数定义了桶将会被创建在哪个区域，如果使用的终端节点归属于默认区域华北-北京一（cn-north-1），可以不携带此参数；如果使用的终端节点归属于其他区域，则必须携带此参数。当前有效的区域名称可从这里查询。有关OBS区域和终端节点的更多信息，请参考地区和终端节点。

AzRedundancy

String

可选

桶AZ存储类型。

  • 如果不携带该值，则默认为单AZ存储。
  • 如果设置为多AZ存储，值为"3az"。
  • 如果Location不支持多AZ，则该桶的存储类型仍为单AZ。

返回结果（InterfaceResult）

字段名

类型

说明

RequestId

String

OBS服务端返回的请求ID。

代码样例

obsClient.createBucket({
       Bucket : 'bucketname',
       ACL : obsClient.enums.AclPrivate,
       StorageClass : obsClient.enums.StorageClassStandard
}, (err, result) => {
       if(err){
              console.error('Error-->' + err);
       }else{
              if(result.CommonMsg.Status < 300){
                     console.log('RequestId-->' + result.InterfaceResult.RequestId);
              }else{
                     console.log('Code-->' + result.CommonMsg.Code);
                     console.log('Message-->' + result.CommonMsg.Message);
              }
       }
});
父主题： 桶相关接口

相关文档