调用UntagResources为资源解绑并删除标签。

QPS限制

本接口的单用户QPS限制为10次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。更多信息，请参见QPS限制。

授权信息

默认仅限阿里云账号使用本接口，RAM用户只有在被授予了相关API操作权限后方可使用。本接口的授权信息如下表所示。更多信息，请参见权限策略和示例。

API

Action

Resource

UntagResources

mq:UntagResources

acs:mq:*:*:*

调试

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

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 UntagResources

系统规定参数。取值：UntagResources。

ResourceId.N RepeatList 是 TopicA

需要解绑标签的资源ID。
ResourceType String 是 TOPIC

资源类型。枚举类型，目前支持的资源类型：

  • INSTANCE
  • TOPIC
  • GROUP
InstanceId String 否 MQ_INST_111111111111_DOxxxxxx

如需解除Topic和Group ID与标签的绑定关系，该参数为必填。
TagKey.N RepeatList 否 CartService

资源的标签键。

  • N的取值范围为1~20。
  • 如果传入该值，则不允许为空字符串。
  • 最多支持128个字符，不能以aliyun和acs:开头，不能包含http://或者https://。
All Boolean 否 false

是否删除资源绑定的全部标签。当请求中未设置TagKey.N时该参数有效。默认值false。

返回数据

名称 类型 示例值 描述
RequestId String 19780F2E-7841-4E0F-A5D9-C64A0530****

公共参数，每个请求的ID都是唯一的，可用于排查和定位问题。

示例

请求示例

http(s)://ons.cn-hangzhou.aliyuncs.com/?Action=UntagResources
&ResourceId.1=TopicA
&ResourceType=TOPIC
&<公共请求参数>

正常返回示例

XML格式 

<UntagResourcesResponse>
  <RequestId>19780F2E-7841-4E0F-A5D9-C64A0530****</RequestId>
</UntagResourcesResponse>

JSON格式 

{"RequestId":"19780F2E-7841-4E0F-A5D9-C64A0530****"}

错误码

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

控制台操作

除了调用UntagResources接口，您还可以通过消息队列RocketMQ版控制台为资源解绑和删除标签。具体操作，请参见标签概述。