接口介绍
在指定账号下创建一个新的Bucket。
接口约束
- 支持的线上资源池 ：上海7、南京3、南京5、杭州2、合肥2、九江、广州6、武汉4、福州25、厦门3、郴州2、海口2、北京5、雄安2、石家庄20、内蒙6、晋中、辽阳1、西安5、乌鲁木齐4、乌鲁木齐27、中卫5、兰州2、西宁2、拉萨3、昆明2、重庆2、成都4、贵州3、上海33、宁波边缘云、华东1、上海36、南昌5、青岛20、武汉41、长沙42、长沙37、南宁23、北京行业云20、华北2、西南1、上海32。
- 自2024年5月17日后，本接口会受到IAM权限管控，当子账号或委托调用该接口时，需具备“zos:zos:CreateBucket”权限。
URI
POST /v4/oss/create-bucket
请求参数
请求体 JSON Body 参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 |
|---|---|---|---|---|
| regionID | 是 | String | 区域 ID | 332232eb-63aa-465e-9028-52e5123866f0 |
| ACL | 否 | String | 桶权限，默认为private，可选值为 private,public-read,public-read-write | private |
| bucket | 是 | String | 桶名称，不可为空。长度 3-63 个字符内（含）字符只能有大小写字母、数字以及英文句号 . 和中划线 -，并且英文句号不能与英文句号或中划线相邻。英文句号和中划线也不能作为开头或结尾。不能使用 ip 地址作为桶名 | bucket1 |
| projectID | 否 | String | 企业项目ID，默认将使用 default 企业项目，其 ID 为 "0" | "437367233" |
| cmkUUID | 否 | String | cmkUUID，若 isEncrypted 为 true，则此参数必传 | wasgdfeb-63aa-465e-9028-52e5123866f0 |
| isEncrypted | 否 | Boolean | 加密状态 | false |
| storageType | 否 | String | 存储类型，可选的值为 STANDARD, STANDARD_IA, GLACIER，分别表示标准、低频、归档 | STANDARD |
| AZPolicy | 否 | String | single-az 或 multi-az，默认为single-az | single-az |
| otherBucketInfo | 否 | Object | 其他创建桶信息，如启用对象锁定 {"ObjectLockEnabledForBucket": true} | {"ObjectLockEnabledForBucket": true} |
响应参数
| 参数 | 参数类型 | 说明 | 示例 |
|---|---|---|---|
| statusCode | Integer | 返回码 取值范围：800 成功 |
800 |
| message | String | 状态描述 | SUCCESS |
| description | String | 状态描述，一般为中文 | 成功 |
| errorCode | String | 业务细分码（仅失败时具有此参数），为product.module.code三段式码 | openapi.userPermission.accessFailed |
请求示例
{
"bucket": "bucket1",
"regionID": "332232eb-63aa-465e-9028-52e5123866f0",
"ACL": "private"
}
响应示例
{
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
| 状态码 | 描述 |
|---|---|
| 800 | 表示请求成功。 |
| 900 | 表示请求失败。 |
错误码
errorCode 枚举值，见错误码总表
