文档首页/ 数据湖探索 DLI/ API参考/ 权限相关API/ 查看赋权对象使用者权限信息
更新时间：2025-09-16 GMT+08:00
在线调试
CLI示例
查看PDF
分享

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

功能介绍

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

URI

  • URI格式：

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

  • 参数说明：
表1 URI 参数

参数名称

是否必选

参数类型

说明

project_id

是

String

参数解释：

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

约束限制：

无

取值范围：

只能由英文字母和数字组成，且长度为[1-64]个字符。

默认取值：

无
表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

对象类型。

  • database：数据库
  • table：数据表
  • column：列
  • queue：队列
  • datasourceauth：增强型跨源
  • resource：资源包
  • group：资源包组
  • elasticresourcepool：弹性资源池
  • variable：全局变量

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 spark is not supported now
父主题： 权限相关API