创建协同存储的Bucket存储空间。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
ens:PutBucket |
create |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| BucketName |
string |
是 |
Bucket 名称。 3~50 个字符，只允许小写字母、数字、短横线（-），且不能以短横线开头或结尾。 |
my-bucket |
| LogicalBucketType |
string |
否 |
逻辑 bucket 类型，取值范围： sink: 下沉（指定节点） standard：标准(全局)（默认值） |
sink |
| Comment |
string |
否 |
备注。长度为 0-128 个字符、汉字或表情符等。 |
this is comment |
| BucketAcl |
string |
否 |
Bucket 权限类型： private：私有（默认值） public-read-write：公共读写 public-read：公共读 |
private |
| EnsRegionId |
string |
否 |
节点区域 id，不指定时为全局默认节点 |
xx-xx-xx |
| DispatchScope |
string |
否 |
调度范围，取值范围：
说明
当创建全局 bucket 时该参数必须指定。 |
sink |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
Schema of Response |
||
| RequestId |
string |
请求 ID。 |
85123E71-7710-4620-8AAB-133CCE49EC83 |
示例
正常返回示例
JSON格式
{
"RequestId": "85123E71-7710-4620-8AAB-133CCE49EC83"
}错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | TooManyBuckets | The number of buckets created exceeds the limit. | |
| 400 | Invalid%s | Specified parameter %s is not valid. | |
| 400 | UnSupportedCity | The city is not supported. | |
| 400 | BucketAlreadyExists | The bucket already exists or is occupied by other users. | |
| 400 | InvalidEngineId | The engineId does not belong to the city. | |
| 400 | InvalidBucketName | Specified parameter BucketName is not valid. | 指定的BucketName参数无效。 |
| 400 | InvalidComment | Specified parameter Comment is not valid. | |
| 400 | InvalidDataRedundancyType | Specified parameter DataRedundancyType is not valid. | |
| 400 | NoPermission | Permission denied. | |
| 400 | InvalidParameter.%s | The specified field %s invalid. Please check it again. | |
| 400 | EnsRegionIdIsMandatory | The parameter EnsRegionId is mandatory while creating a single node bucket. | 当创建单节点bucket时EnsRegionId是必填参数。 |
| 500 | InternalError | The request processing has failed due to some unknown error. | |
| 403 | AccessDenied | auth is not valid | |
| 403 | OperationDenied | The current ens region has not been purchased | |
| 403 | UserDisable | The user has been disabled due to arrears. | 该用户因欠费被禁用。 |
| 404 | NoSuchEnsRegion | The ens region does not exist | |
| 404 | NoSuchStorageDomain | The specified storageDomain does not exist. |
访问错误中心查看更多错误码。
变更历史
更多信息，参考变更详情。