創建角色
更新時間 2025-06-11 14:55:29
最近更新時間: 2025-06-11 14:55:29
分享文章
接口介紹
創建角色
接口約束
支持的線上資源池 ：合肥2、西安5。
URI
POST /v4/oss/create-role
請求參數
請求體 JSON Body 參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| regionID | 是 | String | 區域ID | 332232eb-63aa-465e-9028-52e5123866f0 |
| roleName | 是 | String | 角色名稱，在資源池區域內唯一 | role1 |
| path | 是 | String | 角色地址，必須以/開始和結尾 | / |
| assumeName | 是 | String | 被授權客戶端，目前僅支持sts | sts |
| note | 否 | String | 備注 | some notes |
| maxSessionDuration | 否 | Integer | 最大會話時間，單位秒，取值范圍：3600-43200秒，即1-12小時，默認 3600 | 3600 |
響應參數
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| statusCode | Integer | 返回碼 取值范圍：800 成功 |
800 |
| message | String | 狀態描述 | SUCCESS |
| returnObj | Object | 響應對象 | 見下級對象 |
| description | String | 狀態描述，一般為中文 | 成功 |
| errorCode | String | 業務細分碼（僅失敗時具有此參數），為product.module.code三段式碼 | openapi.userPermission.accessFailed |
表 returnObj
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| arn | String | 角色arn | arn:aws:iam::123456789012:role/Test-Role |
請求示例
{
"regionID": "332232eb-63aa-465e-9028-52e5123866f0",
"roleName": "role1",
"path": "/",
"assumeName": "sts"
}
響應示例
{
"message":"SUCCESS",
"description":"成功",
"statusCode":800,
"returnObj":{
"arn":"arn:aws:iam:::role/role1"
}
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 800 | 表示請求成功。 |
| 900 | 表示請求失敗。 |
錯誤碼
errorCode 枚舉值，見錯誤碼總表
