文档首页/ 数据湖探索 DLI/ API参考/ 权限相关API/ 查看赋权对象使用者权限信息
更新时间:2024-08-09 GMT+08:00

查看赋权对象使用者权限信息

功能介绍

获取对象赋权用户的权限信息。

URI

  • URI格式:

    GET /v1.0/{project_id}/authorization/privileges

  • 参数说明:
表1 URI 参数

参数名称

是否必选

参数类型

说明

project_id

String

项目编号,用于资源隔离。获取方式请参考获取项目ID

表2 query参数

参数名称

是否必选

参数类型

说明

object

String

授权对象,和赋权API中的“object”对应。

  • "jobs.flink.flink作业ID",查询指定的作业。
  • "groups.程序包组名",查询指定的程序包组。
  • "resources.程序包名",查询指定程序包。
    说明:

    查看分组下的程序包时,“object”的格式为"resources.程序包组名/程序包名"。

带入query参数的URL示例如下:

GET /v1.0/{project_id}/authorization/privileges?object={object}

请求消息

无请求参数。

响应消息

表3 响应参数

参数名称

是否必选

参数类型

说明

is_success

Boolean

执行请求是否成功。“true”表示请求执行成功。

message

String

系统提示信息。执行成功时,信息可能为空。

object_name

String

对象名称。

object_type

String

对象类型。

privileges

Array of Object

权限信息。具体内容请参考表4

count

Integer

权限总数量。

表4 privileges参数

参数名称

是否必选

参数类型

说明

object

String

授权对象,和赋权API中的“object”对应。

is_admin

Boolean

判断用户是否为管理员。

user_name

String

用户名称,即该用户在当前数据库上有权限。

privileges

Array of Strings

该用户在数据库上的权限。

请求示例

响应示例

{
    "is_success": true,
    "message": "",
    "object_name": "9561",
    "object_type": "flink",
    "count": 2,
    "privileges": [
        {
            "user_name": "testuser1",
            "is_admin": true,
            "privileges": [
                "ALL"
            ]
        },
        {
            "user_name": "user1",
            "is_admin": false,
            "privileges": [
                "GET"
            ]
        }
    ]
}

状态码

状态码如表5所示。

表5 状态码

状态码

描述

200

授权成功。

400

请求错误。

500

内部服务器错误。

错误码

调用接口出错后,将不会返回上述结果,而是返回错误码和错误信息,更多介绍请参见错误码

表6 错误码

错误码

错误信息

DLI.0001

user input validation failed, object_type sql or saprk is not supported now