调用TagResources接口为指定的资源列表统一创建并绑定标签。

调试

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

请求参数

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

系统规定参数。取值：TagResources。
ResourceId.N String 否 nlb-nrnrxwd15en27r****

资源ID。一次调用最多支持添加50个资源ID。
Tag.N.Key String 否 env

标签键。最多支持128个字符，不能以aliyun或acs:开头，不能包含http://或https://。

一次调用最多支持添加20个标签。
Tag.N.Value String 否 product

标签值。最多支持128个字符，不能以aliyun或acs:开头，不能包含http://或https://。

一次调用最多支持添加20个标签。
ResourceType String 是 loadbalancer

资源类型，取值：

  • loadbalancer：网络型负载均衡实例。
  • securitypolicy：安全策略。
  • servergroup：服务器组。
DryRun Boolean 否 true

是否只预检此次请求。取值：

  • true：发送检查请求，不会为资源创建并绑定标签。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过，则返回对应错误。如果检查通过，则返回错误码DryRunOperation。
  • false（默认值）：发送正常请求，通过检查后返回HTTP 2xx状态码并直接进行操作。
ClientToken String 否 123e4567-e89b-12d3-a456-426655440000

客户端Token，用于保证请求的幂等性。

从您的客户端生成一个参数值，确保不同请求间该参数值唯一。ClientToken只支持ASCII字符。

说明 若您未指定，则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId不一样。
RegionId String 否 cn-hangzhou

资源所在的地域ID。

您可以通过调用DescribeRegions接口获取地域ID。

返回数据

名称 类型 示例值 描述
RequestId String 54B48E3D-DF70-471B-AA93-08E683A1B45

请求ID。
JobId String 72dcd26b-f12d-4c27-b3af-18f6aed5****

异步任务ID。

示例

请求示例

http(s)://[Endpoint]/?Action=TagResources
&ResourceId=["nlb-nrnrxwd15en27r****"]
&Tag=[{"Key":"env","Value":"product"}]
&ResourceType=loadbalancer
&DryRun=true
&ClientToken=123e4567-e89b-12d3-a456-426655440000
&RegionId=cn-hangzhou
&公共请求参数

正常返回示例

XML格式

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

<TagResourcesResponse>
    <RequestId>54B48E3D-DF70-471B-AA93-08E683A1B45</RequestId>
    <JobId>72dcd26b-f12d-4c27-b3af-18f6aed5****</JobId>
</TagResourcesResponse>

JSON格式

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

{
  "RequestId" : "54B48E3D-DF70-471B-AA93-08E683A1B45",
  "JobId" : "72dcd26b-f12d-4c27-b3af-18f6aed5****"
}

错误码

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