调用TagResources为一个或多个主机绑定标签。

调试

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

请求参数

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

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

RegionId String 是 ap-southeast-1

主机所属的地域ID。
ResourceType String 是 DEDICATEDHOST

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

主机ID，可以设置多个。

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

  • Resourceid.1表示传入第一个主机ID。
  • Resourceid.2表示传入第二个主机ID。
Tag.N.Key String 是 demokey

标签的键。

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

标签的值。

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

返回数据

名称 类型 示例值 描述
RequestId String 4B938011-874B-5F54-8B9E-7E2A08B3AA13

请求ID。

示例

请求示例

http(s)://cddc.aliyuncs.com/?Action=TagResources
&RegionId=ap-southeast-1
&ResourceId=["ch-bp1yp3mqggn8****"]
&Tag=[{"Key":"demokey","Value":"demovalue"}]
&ResourceType=DEDICATEDHOST
&公共请求参数

正常返回示例

XML格式 

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

<TagResourcesResponse>
    <RequestId>4B938011-874B-5F54-8B9E-7E2A08B3AA13</RequestId>
</TagResourcesResponse>

JSON格式 

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

{
  "RequestId" : "4B938011-874B-5F54-8B9E-7E2A08B3AA13"
}

错误码

HttpCode 错误码 错误信息 描述
400 OperationDenied.QuotaExceed The Tags parameter number is exceed. Valid is 20. 单个资源的用户标签数量过多，不能超过20。
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列表不能为空

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