调用UntagResources,删除用户标签资源关系。

调用该接口时,您需要注意:

  • 只能删除用户标签。
  • 删除标签资源关系的时候,标签已经没有关联任何资源的,标签也需要删除。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求头

请求语法

DELETE /openapi/tags HTTPS|HTTP

请求参数

名称 类型 是否必选 示例值 描述
ResourceIds String ["es-cn-aaa","es-cn-bbb"]

要删除的实例ID列表。

ResourceType String INSTANCE

资源类型定义。固定值为INSTANCE

TagKeys String ["tagKey1","tagKey2"]

对应要删除的标签列表,最多包含20个子项。

All Boolean false

是否全部删除。仅当TagKey为空时有效。可选值:truefalse,默认为false

  • TagKeys为空,且All = true时,删除资源下所有资源标签关系。存在没有标签的资源,不处理接口,并返回成功。
  • 当传入TagKeys为空,同时All = false时,不处理接口,并返回成功。
  • TagKeys不为空,All无论为true或者false,接口会忽略此字段。
  • 传入多个标签和多个TagKeys,删除资源上指定的标签。当资源上不存在指定标签时,不处理该标签。
  • 如果资源不存在,返回InvalidResourceId.NotFound

返回数据

名称 类型 示例值 描述
RequestId String F99407AB-2FA9-489E-A259-40CF6D******

当前请求的实例ID。

示例

请求示例

DELETE /consoleapi/tags?
ResourceIds=["es-cn-78v1g8t6t000****"]
&ResourceType=INSTANCE
&TagKeys=["env"]

正常返回示例

XML 格式

<Result>true</Result>
<RequestId>3D8795D9-8FF5-46B2-86E6-E3B40*******</RequestId>

JSON 格式

{
    "Result":true,
    "RequestId": "3D8795D9-8FF5-46B2-86E6-E3B40*******"
}

错误码

访问错误中心查看更多错误码。