本文导读
链接复制成功!
创建桶
功能说明
按照用户指定的桶名创建一个新桶。新创建桶的桶名在OBS中必须是唯一的。如果是同一个用户重复创建同一区域的同名桶时返回HTTP状态码200。除此以外的其他场景重复创建同名桶返回HTTP状态码409,表明桶已存在。一个用户可以拥有的桶的数量不能超过100个。
说明:
ObsClient的桶相关操作接口函数均支持首字母大小写,如ObsClient.createBucket和ObsClient.CreateBucket是相同的函数。
方法定义
ObsClient.createBucket
请求参数
字段名 |
类型 |
约束 |
说明 |
---|---|---|---|
Bucket |
String |
必选 |
桶名。
桶命名规则如下:
|
ACL |
String |
可选 |
创桶时可指定的预定义访问策略。 |
StorageClass |
String |
可选 |
创桶时可指定的桶的存储类型。 |
Location |
String |
如果请求的OBS服务地址所在区域为默认区域,则可为空,否则为必选。 |
桶所在的区域。 该参数定义了桶将会被创建在哪个区域,如果使用的终端节点归属于默认区域华北-北京一(cn-north-1),可以不携带此参数;如果使用的终端节点归属于其他区域,则必须携带此参数。当前有效的区域名称可从这里查询。有关OBS区域和终端节点的更多信息,请参考地区和终端节点。 |
AzRedundancy |
String |
可选 |
桶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); } } });
父主题: 桶相关接口