TagResources

调用TagResources接口为指定的网关创建并绑定标签。

在实例数量较多的情况下,您可以创建多个标签,为实例绑定不同的标签对其进行分类,之后通过标签进行实例筛选。

  • 标签由一对键(key)值(value)组成,键在同账号同地域下唯一,值无此限制。
  • 若设置的标签不存在,则自动创建该标签并绑定到目标实例。
  • 若实例已经绑定了有相同键的标签,则进行覆盖绑定。
  • 每个实例最多可以绑定20个标签。
  • 每次调用最多设置50个实例进行批量标签绑定。

请求参数

名称

类型

是否必选

示例值

描述

Action String TagResources

系统规定参数。取值:TagResources

RegionId String cn-hangzhou

地域ID,可以通过接口DescribeRegions查看可用的地域ID。

ResourceRegionId String cn-hangzhou

资源地域ID。

ResourceType String GATEWAY

资源类型定义。唯一取值:GATEWAY。

Tag.N.Key String testkey1

标签键。可以同时创建N个标签键,N的取值范围为1~20。不允许传入空字符串。

Tag.N.Value String testvalue1

标签键对应的标签值。可以同时创建N个标签值,N的取值范围为1~20。允许传入空字符串。

ResourceId.N String gw-uf6wjk5xxxxxxx

网关ID。

返回数据

名称

类型

示例值

描述

RequestId String 224DB9F7-3100-4899-AB9C-C938BCCB43E7

请求ID。

示例

请求示例

http(s)://[Endpoint]/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceRegionId=cn-hangzhou
&ResourceType=GATEWAY
&Tag=[{"Key":"testkey1","Value":"testvalue1"}]
&ResourceId=["gw-uf6wjk5xxxxxxx"]
&公共请求参数

正常返回示例

XML格式

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

<TagResourcesResponse>
  <RequestId>224DB9F7-3100-4899-AB9C-C938BCCB43E7</RequestId>
</TagResourcesResponse>

JSON格式

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

{
  "RequestId" : "224DB9F7-3100-4899-AB9C-C938BCCB43E7"
}

错误码

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