创建桶
更新时间 2025-10-30 11:35:43
最近更新时间: 2025-10-30 11:35:43
接口功能介绍
在指定账号下创建一个新桶。
接口约束
支持所有一类节点资源池。
URI
POST /v4/oss/create-bucket
路径参数 无
Query参数 无
请求参数
请求头header参数 无
请求体body参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 区域 ID | 332232eb-63aa-465e-9028-52e5123866f0 | |
| ACL | 否 | String | 桶权限，可选值为 private、public-read，分别表示私有、公共读，默认为 private | private | |
| bucket | 是 | String | 桶名称，不可为空。长度 3-63 个字符内（含）字符只能有大小写字母、数字以及英文句号 （.） 和中划线 （-）。禁止两个英文句号（.）或英文句号（.）中划线（-）相邻。禁止英文句号（.）和中划线（-）作为开头或结尾。禁止使用 ip 地址作为桶名 | bucket1 | |
| projectID | 否 | String | 企业项目ID，默认将使用 default 企业项目，其 ID 为 "0" | 437367233 | |
| cmkUUID | 否 | String | 密钥管理服务中创建的密钥 ID，使用此参数时，isEncrypted 必须为 true。当 isEncrypted 为 true 但未指定此参数时，会自动创建密钥 | wasgdfeb-63aa-465e-9028-52e5123866f0 | |
| isEncrypted | 否 | Boolean | 加密状态 | false | |
| storageType | 否 | String | 存储类型，可选的值为 STANDARD、STANDARD_IA、GLACIER，分别表示标准、低频、归档，默认为 STANDARD | STANDARD | |
| AZPolicy | 否 | String | az 策略，可选值为 single-az、multi-az，分别表示单 az、多 az，默认为 single-az | single-az | |
| labels | 否 | Array of Objects | 桶的资源标签 | labels | |
| otherBucketInfo | 否 | Object | 其他创建桶信息，如启用对象锁定 {"ObjectLockEnabledForBucket": true} | otherBucketInfo | |
| 表 labels |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| key | 是 | String | 标签名 | format | |
| value | 是 | String | 值 | aac | |
| 表 otherBucketInfo |
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| ObjectLockEnabledForBucket | 否 | Boolean | 是否开启对象锁定 | true |
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Long | 返回状态码(800为成功，900为处理中/失败) | 800 | |
| message | String | 状态描述 | SUCCESS | |
| description | String | 状态描述，一般为中文 | 成功 | |
| errorCode | String | 业务细分码（仅失败时具有此参数），为 product.module.code 三段式码 | openapi.userPermission.accessFailed | |
| error | String | 业务细分码（大驼峰形式，仅失败时具有此参数），为 Product.Module.Code 三段式码 | Openapi.UserPermission.AccessFailed |
枚举参数
无
请求示例
请求url
无
请求头header
无
请求体body
{
"bucket": "bucket1",
"regionID": "332232eb-63aa-465e-9028-52e5123866f0",
"ACL": "private"
}
响应示例
{
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
请参考 状态码
错误码
请参考 错误码
