文档首页/ 数据湖探索 DLI/ API参考/ 资源标签相关API/ 批量删除资源标签
更新时间：2025-08-06 GMT+08:00
在线调试
CLI示例
查看PDF
分享

批量删除资源标签

功能介绍

为指定实例批量删除标签。

  • 此接口为幂等接口： 删除时，如果删除的标签不存在，默认处理成功。
  • 单次最多支持删除20个标签
  • 删除时不对标签字符集范围做校验。
  • 删除时tags结构体不能缺失，key不能为空，或者空字符串。

URI

POST /v3/{project_id}/{resource_type}/{resource_id}/tags/delete

表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作业

resource_id

是

String

资源ID。

最小长度：1

最大长度：1000

获取方式：
  • 队列ID：通过调用查询所有队列获队列ID。响应中的queue_id为队列ID。
  • 弹性资源池ID：通过调用查询所有弹性资源池获取弹性资源池ID。响应中的resource_id为弹性资源池ID。
  • 增强型跨源连接ID：在DLI管理控制台的“增强型跨源连接”列表页获取“连接ID”即为增强型跨源连接ID。
  • 数据库ID：添加标签时候传入的数据库ID即数据库名。您可以在DLI控制台的“库表管理”页面查看数据库名称。
  • Flink作业ID：在DLI管理控制台的“Flink作业”列表页面单击Flink作业名称，在Flink作业的详情页面即可获取Flink作业ID。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

tags

是

Array of tag objects

标签列表。请参考表3。

  • 最多支持20个标签。
  • 一个“键”只能添加一个“值”。
  • 每个资源中的键不能重复，同一个键中值不能重复。
表3 tag

参数

是否必选

参数类型

描述

key

是

String

键。

标签的键的最大长度为128个字符，标签的键可以包含任意语种字母、数字、空格和_ . : +-@，但首尾不能含有空格，不能以_sys_开头。

value

是

String

值。

标签值的最大长度为255个字符，标签的值可以包含任意语种字母、数字、空格和_ . : +-@。

响应参数

无

请求示例

{
    "tags":[
        {
            "key":"key1"
        },
        {
            "key":"key2",
            "value":"value2"
        }
    ]
}

响应示例

无

状态码

状态码

描述

204

修改成功。

400

请求错误。

500

内部服务器错误。

错误码

请参见错误码。

父主题： 资源标签相关API