创建桶(go sdk)-九游平台

input

*createbucketinput

是

参数解释：

创建桶接口入参，详见createbucketinput。

extensions

否

参数解释：

桶相关扩展信息。通过调用拓展配置项为对应请求配置额外的拓展请求头，详见。

bucket

string

必选

参数解释：

桶名。

约束限制：

• 桶的名字需全局唯一，不能与已有的任何桶名称重复，包括其他用户创建的桶。
• 桶命名规则如下：
  • 3～63个字符，数字或字母开头，支持小写字母、数字、“-”、“.”。
  • 禁止使用ip地址。
  • 禁止以“-”或“.”开头及结尾。
  • 禁止两个“.”相邻（如：“my..bucket”）。
  • 禁止“.”和“-”相邻（如：“my-.bucket”和“my.-bucket”）。
• 同一用户在同一个区域多次创建同名桶不会报错，创建的桶属性以第一次请求为准。

默认取值：

无

location

string

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

参数解释：

桶所在的区域。

约束限制：

该参数定义了桶将会被创建在哪个区域，如果使用的终端节点是obs.myhuaweicloud.com，可以不携带此参数；如果使用的终端节点不是obs.myhuaweicloud.com，则必须携带此参数。

取值范围：

当前有效的obs区域和终端节点的更多信息，请参考。终端节点即调用api的请求地址，不同服务不同区域的终端节点不同，您可以向企业管理员获取区域和终端节点信息。

默认取值：

终端节点为obs.myhuaweicloud.com且用户未设定区域时，默认为华北-北京一（cn-north-1）。

acl

acltype

可选

参数解释：

创桶时可指定的预定义访问策略，有关访问控制列表（access control list，acl）功能的详细信息可参见acl功能介绍。

取值范围：

可选择的访问策略选项参见acltype。

默认取值：

私有权限

storageclass

storageclasstype

可选

参数解释：

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

取值范围：

可选择的访问策略选项参见storageclasstype。

默认取值：

标准存储类型

grantreadid

string

可选

参数解释：

被授予read权限的账号的账号id，即domain_id。账号被授予read权限后，针对当前正在创建的桶，允许列举桶内对象、列举桶中多段任务、列举桶中多版本对象、获取桶元数据。

取值范围：

如何获取账号id请参见

默认取值：

无

grantwriteid

string

可选

参数解释：

被授予write权限的账号的账号id，即domain_id。账号被授予write权限后，针对当前正在创建的桶，允许创建、删除、覆盖桶内所有对象，允许初始化段、上传段、拷贝段、合并段、取消多段上传任务。

取值范围：

如何获取账号id请参见

默认取值：

无

grantreadacpid

string

可选

参数解释：

被授予read_acp权限的账号的账号id，即domain_id。账号被授予read_acp权限后，针对当前正在创建的桶，允许读桶的acl信息。

取值范围：

如何获取账号id请参见

默认取值：

无

grantwriteacpid

string

可选

参数解释：

被授予write_acp权限的账号的账号id，即domain_id。账号被授予write_acp权限后，针对当前正在创建的桶，允许修改桶的acl信息。

取值范围：

如何获取账号id请参见

默认取值：

无

grantfullcontrolid

string

可选

参数解释：

被授予full_control权限的账号的账号id，即domain_id。账号被授予full_control权限后，针对当前正在创建的桶，允许进行任何操作。

取值范围：

如何获取账号id请参见

默认取值：

无

grantreaddeliveredid

string

可选

参数解释：

被授予read权限的账号的账号id，即domain_id。授权指定账号有read权限，并且在默认情况下，该read权限将传递给桶内所有对象。

取值范围：

如何获取账号id请参见

默认取值：

无

grantfullcontroldeliveredid

string

可选

参数解释：

被授予full_control权限的账号的账号id，即domain_id。授权指定账号有当前桶的全部控制权限，并且在默认情况下，该full_control权限将传递给桶内所有对象。

取值范围：

如何获取账号id请参见

默认取值：

无

epid

string

可选

参数解释：

创桶时可指定的企业项目id，开通企业项目的用户可以从企业项目服务获取。

约束限制：

epid格式为uuid，未开通企业项目的用户可以不带该头域。

示例：9892d768-2d13-450f-aac7-ed0e44c2585f

默认取值：

无

availablezone

string

可选

参数解释：

创桶时可指定的数据冗余类型，即az类型。

约束限制：

归档和深度归档存储不支持多az。如果桶所在区域如果不支持多az存储，则该桶的存储类型默认为单az。

取值范围：

如果将桶配置为多az，则取值为3az。如果将桶配置为单az，则无需选择此选项，系统默认赋值。

默认取值：

单az

isfsfileinterface

bool

可选

参数解释：

是否创建并行文件系统。

取值范围：

• true：创建并行文件系统
• false：创建桶

默认取值：

false，即创建桶

aclprivate

private

私有读写。

桶或对象的所有者拥有完全控制的权限，其他任何人都没有访问权限。

aclpublicread

public-read

公共读私有写。

设在桶上，所有人可以获取该桶内对象列表、桶内多段任务、桶的元数据、桶的多版本。

设在对象上，所有人可以获取该对象内容和元数据。

aclpublicreadwrite

public-read-write

公共读写。

设在桶上，所有人可以获取该桶内对象列表、桶内多段任务、桶的元数据、桶的多版本、上传对象、删除对象、初始化段任务、上传段、合并段、拷贝段、取消多段上传任务。

设在对象上，所有人可以获取该对象内容和元数据。

aclpublicreaddelivered

public-read-delivered

桶公共读，桶内对象公共读。

设在桶上，所有人可以获取该桶内对象列表、桶内多段任务、桶的元数据、桶的多版本，可以获取该桶内对象的内容和元数据。

aclpublicreadwritedelivered

public-read-write-delivered

桶公共读写，桶内对象公共读写。

设在桶上，所有人可以获取该桶内对象列表、桶内多段任务、桶的元数据、桶的多版本、上传对象、删除对象、初始化段任务、上传段、合并段、拷贝段、取消多段上传任务，可以获取该桶内对象的内容和元数据。

aclbucketownerfullcontrol

bucket-owner-full-control

设在对象上，桶和对象的所有者拥有对象的完全控制权限，其他任何人都没有访问权限。

默认情况下，上传对象至其他用户的桶中，桶拥有者没有对象的控制权限。对象拥有者为桶拥有者添加此权限控制策略后，桶所有者可以完全控制对象。例如，用户a上传对象x至用户b的桶中，系统默认用户b没有对象x的控制权。当用户a为对象x设置bucket-owner-full-control策略后，用户b就拥有了对象x的控制权。

storageclassstandard

standard

标准存储。

标准存储拥有低访问时延和较高的吞吐量，适用于有大量热点对象（平均一个月多次）或小对象（<1mb），且需要频繁访问数据的业务场景。

storageclasswarm

warm

低频访问存储。

低频访问存储适用于不频繁访问（平均一年少于12次）但在需要时也要求能够快速访问数据的业务场景。

storageclasscold

cold

归档存储。

归档存储适用于很少访问（平均一年访问一次）数据的业务场景。

storageclassdeeparchive

deep_archive

深度归档存储（受限公测）

适用于长期不访问（平均几年访问一次）数据的业务场景。

output

*basemodel

参数解释：

接口返回信息，详见basemodel。

err

error

参数解释：

接口返回错误信息。

statuscode

int

参数解释：

http状态码。

取值范围：

状态码是一组从2xx（成功）到4xx或5xx（错误）的数字代码，状态码表示了请求响应的状态。完整的状态码列表请参见。

默认取值：

无

requestid

string

参数解释：

obs服务端返回的请求id。

默认取值：

无

responseheaders

map[string][]string

参数解释：

http响应头信息。

默认取值：

无