查詢角色詳情
更新時間 2025-06-11 14:55:30
最近更新時間: 2025-06-11 14:55:30
分享文章
接口介紹
獲取角色詳情
接口約束
支持的線上資源池 ：合肥2、西安5
URI
GET /v4/oss/role/detail
請求參數
請求 Query 參數
| 參數 | 是否必填 | 參數類型 | 說明 | 示例 |
|---|---|---|---|---|
| regionID | 是 | String | 區域 ID | 332232eb-63aa-465e-9028-52e5123866f0 |
| roleName | 是 | String | 角色名 | role1 |
響應參數
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| statusCode | Integer | 返回碼 取值范圍：800 成功 |
800 |
| message | String | 狀態描述 | SUCCESS |
| returnObj | Object | 響應對象 | 見下級對象 |
| description | String | 狀態描述，一般為中文 | 成功 |
| errorCode | String | 業務細分碼（僅失敗時具有此參數），為product.module.code三段式碼 | openapi.userPermission.accessFailed |
表returnObj
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| status | Bool | 角色狀態 | ture |
| fuser_last_updated | String | 最近更新時間 | 2023-03-31T06:42:44Z |
| role_arn | String | 角色arn | arn:aws:iam:::role/role-zs1 |
| maxSessionDuration | Integer | 最大會話時長 | 3600 |
| role_name | String | 角色名 | role1 |
| note | String | 角色備注 | role_note1 |
| policies | Array of Objects | 該角色下綁定的策略列表 | 見下級對象 |
| created_time | String | 角色創建時間 | 2023-05-08T08:46:28Z |
表 policies
| 參數 | 參數類型 | 說明 | 示例 |
|---|---|---|---|
| note | String | 策略備注 | policy_note1 |
| bind_date | String | 策略綁定時間 | 2023-05-09T01:29:43Z |
| policy_name | String | 策略名 | policy1 |
請求示例
{
"regionID": "332232eb-63aa-465e-9028-52e5123866f0",
"roleName": "role1"
}
響應示例
{
"message": "SUCCESS",
"description": "成功",
"statusCode": 800,
"returnObj": {
"status": true,
"fuser_last_updated": "2023-05-17T02:26:36Z",
"role_arn": "arn:aws:iam:::role/role-xxx",
"maxSessionDuration": 7200,
"note": "",
"role_name": "role1",
"policies": [
{
"note": "",
"bind_date": "2023-05-17T02:26:36Z",
"policy_name": "policy1"
}
],
"created_time": "2023-05-16T08:00:43Z"
}
}
狀態碼
| 狀態碼 | 描述 |
|---|---|
| 800 | 表示請求成功。 |
| 900 | 表示請求失敗。 |
錯誤碼
errorCode 枚舉值，見錯誤碼總表
