創建桶
更新時間 2025-06-11 14:55:16
最近更新時間: 2025-06-11 14:55:16
分享文章
接口介紹
在指定賬號下創建一個新的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。
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 枚舉值，見錯誤碼總表
