# 批量删除资源标签 - BatchDeleteResourceTags #### 功能介绍 为指定实例批量删除标签。 - 此接口为幂等接口： 删除时，如果删除的标签不存在，默认处理成功。 - 单次最多支持删除20个标签 - 删除时不对标签字符集范围做校验。 - 删除时tags结构体不能缺失，key不能为空，或者空字符串。 #### 调试 您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/DLI/doc?api=BatchDeleteResourceTags)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。 #### 授权信息 账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。 - 如果使用角色与策略授权，具体权限要求请参见[权限及授权项说明](https://support.huaweicloud.com/api-dli/dli_02_0375.html)。 - 如果使用身份策略授权，需具备如下身份策略权限。 | 授权项 Action | 访问级别 Access Level | 资源类型（\*为必须） Resource Type (\*: required) | 条件键 Condition Key | 别名 Alias | 依赖的授权项 Dependencies | |:---|:---|:---|:---|:---|:---| | dli::unTagResource | Tagging | queue | - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) - [g:ResourceTag/\](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) | - | - | | dli::unTagResource | Tagging | resource | - [g:ResourceTag/\](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) | - | - | | dli::unTagResource | Tagging | database | - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) - [g:ResourceTag/\](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) | - | - | | dli::unTagResource | Tagging | elasticresourcepool | - [g:EnterpriseProjectId](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) - [g:ResourceTag/\](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) | - | - | | dli::unTagResource | Tagging | edsconnection | - [g:ResourceTag/\](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) | - | - | | dli::unTagResource | Tagging | jobs | - [g:ResourceTag/\](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) | - | - | | dli::unTagResource | Tagging | - | - [g:RequestTag/\](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) - [g:TagKeys](https://support.huaweicloud.com/usermanual-iam5/iam_01_1287.html) | - | - | #### URI POST /v3/{project_id}/{resource_type}/{resource_id}/tags/delete 表1路径参数 | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | project_id | 是 | String | 项目编号，用于资源隔离。获取方式请参考[获取项目ID](https://support.huaweicloud.com/api-dli/dli_02_0183.html)。 | | 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：通过调用[查询所有队列 - ListQueues](https://support.huaweicloud.com/api-dli/dli_02_0196.html)获队列ID。响应中的queue_id为队列ID。 - 弹性资源池ID：通过调用[查询所有弹性资源池 - ListElasticResourcePools](https://support.huaweicloud.com/api-dli/dli_02_0327.html)获取弹性资源池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个标签。 - 一个"键"只能添加一个"值"。 - 每个资源中的键不能重复，同一个键中值不能重复。 | 表3tag | 参数 | 是否必选 | 参数类型 | 描述 | |:---|:---|:---|:---| | key | 是 | String | 键。 标签的键的最大长度为128个字符，标签的键可以包含任意语种字母、数字、空格和_ . : +-@，但首尾不能含有空格，不能以_sys_开头。 | | value | 是 | String | 值。 标签值的最大长度为255个字符，标签的值可以包含任意语种字母、数字、空格和_ . : +-@。 | #### 响应参数 无 #### 请求示例 ``` { "tags":[ { "key":"key1", "value": "value1" }, { "key":"key2", "value":"value2" } ] } ``` #### 响应示例 无 #### 状态码 | 状态码 | 描述 | |:---|:---| | 204 | 修改成功。 | | 400 | 请求错误。 | | 500 | 内部服务器错误。 | #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-dli/dli_02_0056.html)。