獲取桶ACL
更新時間 2025-06-11 14:55:19
最近更新時間: 2025-06-11 14:55:19
分享文章
接口介紹
獲取 Bucket 的 ACL, 即存儲桶(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
GET /v4/oss/get-bucket-acl
請求參數
請求 Query 參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| bucket | 是 | String | 桶名 | bucket1 |
| regionID | 是 | String | 區域 ID | 332232eb-63aa-465e-9028-52e5123866f0 |
響應參數
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| statusCode | Integer | 返回碼 取值范圍:800 成功 |
800 |
| message | String | 狀態描述 | SUCCESS |
| description | String | 狀態描述,一般為中文 | 成功 |
| returnObj | Object | 響應對象 | 見下級對象 |
| errorCode | String | 業務細分碼(僅失敗時具有此參數),為product.module.code三段式碼 | openapi.userPermission.accessFailed |
表 returnObj
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| owner | Object | 所有者 | 見下級對象 |
| grants | Array of Objects | 授權信息 | 見下級對象 |
表 owner
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| displayName | String | 展示名稱 | d_name |
| ID | String | 用戶名 | user1 |
表 grants
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| grantee | Object | 被授予權限的人的容器 | 見下級對象 |
| permission | String | 權限,為 WRITE, WRITE_ACP, FULL_CONTROL, READ, READ_ACP 之中的值 WRITE:向桶中寫對象的權限 WRITE_ACP:修改桶的訪問控制權限的能力 READ:讀取桶中文件列表的能力 READ_ACP:獲取桶的訪問控制權限的能力 FULL_CONTROL:同桶的所屬者相同的權限,以上能力都具有 |
READ_ACP |
表 grantee
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| emailAddress | String | 郵箱地址 | example@xx.com |
| type | String | 用戶類型, CanonicalUser,Group 二者之一 | CanonicalUser |
| displayName | String | 展示名稱 | zhangsan |
| ID | String | 用戶名 | lisi |
| URI | String | URI,不存在時為 null | //acs.amazonaws.com/groups/global/AuthenticatedUsers |
請求示例
GET //zos-global.ctapi.daliqc.cn/v4/oss/get-bucket-acl?bucket=bucket1®ionID=332232eb-63aa-465e-9028-52e5123866f0
響應示例
{
"returnObj": {
"owner": {
"displayName": "d_name",
"ID": "user1"
},
"grants": [
{
"grantee": {
"displayName": "zhangsan",
"emailAddress": "example@xx.com",
"ID": "lisi",
"type": "CanonicalUser"
},
"permission": "READ_ACP"
}
]
},
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 800 | 表示請求成功。 |
| 900 | 表示請求失敗。 |
錯誤碼
errorCode 枚舉值,見錯誤碼總表