文档首页/ 数据复制服务 DRS/ API参考/ API v5（公测中）/ 权限管理/ 查询委托权限详情
更新时间：2025-08-13 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询委托权限详情

功能介绍

查询委托权限详情

URI

GET /v5/{project_id}/agency/{agency_name}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

租户在某一Region下的project ID。

获取方法请参见获取项目ID。

agency_name

是

String

委托名称。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

从IAM服务获取的用户Token。用户Token也就是调用IAM获取用户Token接口的响应值，请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

X-Language

否

String

请求语言类型。默认en-us。

取值范围：

  • en-us
  • zh-cn

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

is_existed

Boolean

委托是否存在。

name

String

委托名称。

roles

Array of AgencyRole objects

委托绑定的权限策略信息。
表4 AgencyRole

参数

参数类型

描述

name

String

策略名称。

description

String

策略描述。

状态码： 400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

状态码： 500

表6 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误描述。

请求示例

查询委托权限详情。

https://{endpoint}/v5/054e292c9880d4992f02c0196d3ea468/agency/DRS_AGENTCY

响应示例

状态码： 200

Success.

{
  "is_existed" : true,
  "name" : "DRS_AGENTCY",
  "roles" : [ {
    "name" : "DRS FullAccess",
    "description" : "策略描述1"
  }, {
    "name" : "Tenant Administrator",
    "description" : "策略描述2"
  } ]
}

状态码

状态码

描述

200

Success.

400

Client error.

500

Server error.

错误码

请参见错误码。

父主题： 权限管理

相关文档