查询委托权限详情 - ShowAgencyInfo

功能介绍

查询委托权限详情。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，当前API调用无需身份策略权限。

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"
  } ]
}