查询权限信息 - ShowPrivileges
功能介绍
查询权限信息接口用于获取用户或角色的权限配置详情。该接口适用于以下场景：当需要验证用户权限分配是否符合安全策略、排查权限异常问题、进行权限审计或系统集成时，管理员可通过此接口获取权限的关联角色、资源范围、操作类型及生效状态等元数据。使用该接口的前提条件是目标权限数据已存在于系统中，调用者需具备权限管理查看权限，且权限管理系统服务正常运行。查询操作完成后，系统将返回权限的完整配置信息（支持分页/过滤），且不会对权限配置或系统运行状态产生影响。若权限数据不存在、用户权限不足或服务异常，接口将返回对应的错误信息（如"404 Not Found"、"403 Forbidden"或"503 Service Unavailable"）。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
URI
GET /v1/{project_id}/privileges/{name}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释：用户项目ID。获取方法请参见获取项目ID和名称。 约束限制：1 - 64字符，字母、数字和中划线。 取值范围：不涉及。 默认取值：不涉及 |
| name | 是 | String | 参数解释：权限名称。 约束限制：不涉及。 取值范围：不涉及。 默认取值：不涉及 |
请求参数
无
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| isPrivileged | Boolean | 参数解释：是否具有特权。 取值范围：不涉及。 |
| policies | Array of policies objects | 参数解释：权限策略列表。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释：权限策略的唯一标识ID。 取值范围：不涉及。 |
| name | String | 参数解释：权限策略的名称。 取值范围：不涉及。 |
| type | String | 参数解释：权限策略的类型。 取值范围：不涉及。 |
| policy | policy object | 参数解释：权限策略。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| Version | String | 参数解释：权限策略的版本。 取值范围：不涉及。 |
| Statement | Array of Statement objects | 参数解释：权限策略的声明列表。 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| Effect | String | 参数解释：权限策略的生效效果。 取值范围：不涉及。 |
| Action | Array of strings | 参数解释：权限策略的操作列表。 |
| Condition | Condition object | 参数解释：权限策略的条件。 |
请求示例
无
响应示例
无
状态码
| 状态码 | 描述 |
|---|---|
| 200 | Demo Information |
错误码
请参见错误码。
