文档首页/ 云数据库 GaussDB/ API参考/ API（推荐）/ 权限管理/ 查询委托权限详情 - QueryingAgencyPermissionDetails
更新时间：2025-12-26 GMT+08:00
查看PDF
分享

查询委托权限详情 - QueryingAgencyPermissionDetails

功能介绍

查询委托权限详情。

调试

您可以在API Explorer中调试该接口。

URI

GET /v3/{project_id}/agency/{agency_name}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

租户在某一Region下的项目ID。

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

约束限制：

不涉及。

取值范围：

只能由英文字母、数字组成，且长度为32个字符。

默认取值：

不涉及。

agency_name

是

String

参数解释：

委托名称。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：

用户Token。

通过调用IAM服务获取用户Token接口获取。

请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。

约束限制：

不涉及。

取值范围：

不涉及。

默认取值：

不涉及。

X-Language

否

String

参数解释：

语言。

约束限制：

不涉及。

取值范围：

  • zh-cn
  • en-us

默认取值：

en-us

响应参数

表3 响应Body参数

参数

参数类型

描述

name

String

参数解释：

委托名称。

取值范围：

不涉及。

is_existed

Boolean

参数解释：

委托是否存在。

取值范围：

  • true：存在。
  • false：不存在。

roles

Array of objects

参数解释：

委托绑定的权限策略信息。详情请参见表4。
表4 AgencyRoleResult

参数

参数类型

描述

name

String

参数解释：

策略名称。

取值范围:

不涉及。

description

String

参数解释：

策略描述。

取值范围:

不涉及。

请求示例

查询委托权限详情。

GET https://gaussdb-opengauss.ap-southeast-1.myhuaweicloud.com/v3/9a29cc53af2f499cb48a6d81839264cb/agency/RDSAccessProjectResource

响应示例

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

状态码

错误码

请参见错误码。

父主题： 权限管理