全部产品
Search
文档中心

应用实时监控服务ARMS:UntagResources - 删除标签资源关系

更新时间:Aug 28, 2026

用于删除ARMS资源实例标签。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称

类型

必填

描述

示例值

TagKey

array

否

需要删除的标签键列表,不超过 20 个。不填可通过 All 参数删除所有标签。

string

否

标签键。

Key1

ResourceId

array

是

应用的 PID 或实例 ID,最多 50 个。

string

否

实例 ID。

c7c13c449eea64fe89870ac658d******

ResourceType

string

是

需要修改标签的 ARMS 资源类型。

  • WEB-前端监控

  • APPLICATION-应用监控

  • PROMETHEUS-可观测监控 Prometheus 版

  • SYNTHETICTASK-云拨测

  • ALERTRULE-应用监控告警

  • PROMETHEUSALERTRULE-可观测监控 Prometheus 版告警

  • XTRACEAPP - 可观测链路 OpenTelemetry 版应用

APPLICATION

All

boolean

否

是否全部删除,只针对 TagKey.N 为空时有效。取值范围:

  • true:全部删除

  • false(默认):不全部删除

false

Tags

array<object>

否

标签键值对,当您未输入 ResourceIds 参数时必填。取值说明如下:

  • key:标签键,字符长度范围[1,128]。

  • value:标签值,字符长度范围[1,128]。

区分大小写。如果指定多个标签,则会为指定资源同时创建并绑定多个标签。同一个资源上的同一个标签键只能对应一个标签值。如果您尝试添加已有标签键,则对应的标签值会更新为新值。不能以aliyun和acs:开头,不能包含http://或者https://。

object

否

Key

string

否

标签键。必填参数,不允许为空字符串。最多支持 128 个字符,不能以aliyun和acs:开头,不能包含http://或 https://。

TestTag

Value

string

否

实例的标签值。

如果传入该值,则允许为空字符串。最多支持 128 个字符,不能以acs:开头,不能包含http://或者https://。

TestValue

返回参数

名称

类型

描述

示例值

object

Schema of Response

RequestId

string

请求 ID。

FC183B5E-C9AD-5E9E-937F-*******

Data

string

是否删除成功。

success

示例

正常返回示例

JSON格式

{
  "RequestId": "FC183B5E-C9AD-5E9E-937F-*******",
  "Data": "success"
}

错误码

HTTP status code

错误码

错误信息

描述

400 NoPermissionKeyOperator user is no permission for operating param tagKey.
400 DuplicateTagKey Param tagKey is duplicate.
400 NoPermissionUSER user no permission
400 ResourceIdAndTagIsNull resourceId or tag param must have one
400 TagISNull param tag must be not null. 标签不能为空
400 ScopeDisAgreement Param scope is different from before.
400 ParameterNextTokenIllegal param nextToken is invalid.
400 TagNumOUT the number of tag is out .
400 ResourceTypeIllegal The ResourceType parameter is invalid. 参数ResourceType非法。
400 ResourceIdIsNull param resourceId must be not null.
400 InvalidParameterTagKey The specified TagKey is invalid. 参数TagKey是非法的。
400 InvalidParameterTagValue The specified TagValue is invalid. 参数TagValue是非法的。
400 TagKeyIsIllegal The specified TagKey is invalid. 参数TagKey是非法的。
400 TagValueIsIllegal The specified TagValue is invalid. 参数TagValue是非法的。
400 ResourceIDOUT The specified resourceId number is out of range. 参数resourceId的个数超出了所规定的范围。

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

变更历史

更多信息,参考变更详情。