调用UntagResources将主机的标签解绑。

调试

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

请求参数

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

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

RegionId String 是 ap-southeast-1

主机所属的地域ID。
All Boolean 否 false

是否解绑主机上的所有标签，取值：

  • true：解绑主机上的所有标签。
  • false：不解绑上主机的所有标签，默认值。
说明 如果同时设置了TagKey.N和本参数，则本参数不生效。
ResourceType String 是 DEDICATEDHOST

资源类型，取值固定为DEDICATEDHOST。
ResourceId.N String 是 ch-t4n4dcdvu6840****

主机ID，可以设置多个。

N表示窜入第几个主机ID。例如：

- Resourceid.1表示传入第一个主机ID。

- Resourceid.2表示传入第二个主机ID。

TagKey.N String 否 demokey

标签的键。

  • N表示传入第几个标签的键。例如：
    • Tag.1.Key表示传入第一个标签的键。
    • Tag.2.Key表示传入第二个标签的键。
  • 如果标签的键不存在，则自动创建。

返回数据

名称 类型 示例值 描述
RequestId String B74AD197-214C-50F2-BF7D-B13632EE4D75

请求ID。

示例

请求示例

http(s)://cddc.aliyuncs.com/?Action=UntagResources
&RegionId=ap-southeast-1
&ResourceId=["ch-t4n4dcdvu6840****"]
&TagKey=[]
&All=false
&ResourceType=DEDICATEDHOST
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<UntagResourcesResponse>
    <RequestId>B74AD197-214C-50F2-BF7D-B13632EE4D75</RequestId>
</UntagResourcesResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "B74AD197-214C-50F2-BF7D-B13632EE4D75"
}

错误码

HttpCode 错误码 错误信息 描述
400 NoPermission.SystemTag The operator is not permission for the system tag 无法对系统标签进行操作。
400 InvalidParameter.TagValue The Tag.%s.Value parameter - %s is invalid 标签键参数非法，不能为空，或者长度超过128。
400 InvalidParameter.TagKey The Tag.%s.Key parameter - %s is invalid 标签值参数非法，不能为空，或者长度超过128。
400 InvalidDedicatedHostId.NotFound The parameter - ResourceIds.N is not found. 资源ID对应的资源无法找到。
400 MissingParameter.ResourceIds The parameter - ResourceIds.N should not be null. 资源ID列表不能为空

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