文档首页/ 数据湖探索 DLI/ API参考/ 资源标签相关API/ 查询指定资源类型的标签信息 - ListResourcesTags
更新时间:2026-07-16 GMT+08:00
分享

查询指定资源类型的标签信息 - ListResourcesTags

功能介绍

该接口用于查询指定资源类型的标签信息,即指定项目中资源类型的所有资源标签集合。

调试

您可以在API Explorer中调试该接口,支持自动认证鉴权。API Explorer可以自动生成SDK代码示例,并提供SDK代码示例调试功能。

授权信息

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

  • 如果使用角色与策略授权,具体权限要求请参见权限及授权项说明。
  • 如果使用身份策略授权,需具备如下身份策略权限。

    授权项

    Action

    访问级别

    Access Level

    资源类型(*为必须)

    Resource Type (*: required)

    条件键

    Condition Key

    别名

    Alias

    依赖的授权项

    Dependencies

    vdli::listTags

    List

    -

    -

    -

    -

URI

GET /v3/{project_id}/{resource_type}/tags

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

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

resource_type

是

String

资源类型。

  • dli_queue:队列
  • dli_elastic_resource_pool:弹性资源池
  • dli_enhanced_datasource:增强型跨源连接
  • dli_database:数据库
  • dli_package_resource:资源包(不支持指定有Module ID的内置资源包)
  • dli_flink_job:Flink作业
表2 Query参数

参数

是否必选

参数类型

描述

limit

否

Integer

每页显示条数,默认为1000。

offset

否

Integer

查询结果偏移量,默认为0。

请求参数

无

响应参数

表3 响应参数

参数

参数类型

描述

tags

Array of objects

资源标签列表。请参考表4。

count

Long

标签数量。

表4 tags字段数据结构说明

参数

参数类型

描述

key

String

资源标签键。

values

Array of strings

资源标签值列表。

请求示例

无

响应示例

{
      "count": 2,
      "tags": [
        {
            "key": "key1",
            "values": [
                "value1",
                "value2"
]
        },
        {
            "key": "key2",
            "values": [
                "value1",
                "value2"
]
        }
    ]
}

状态码

状态码

描述

200

修改成功。

400

请求错误。

500

内部服务器错误。

错误码

请参见错误码。

相关文档