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

本文将提供一个示例，为杭州地域ID为7fee80e1-8c48-4c2f-8300-0f6dc40b****的资源栈创建并绑定标签，标签键为FinanceDept、标签值为FinanceJoshua。

调试

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

请求参数

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

要执行的操作，取值：TagResources。
RegionId String 是 cn-hangzhou

标签所属的地域ID。您可以调用DescribeRegions查看最新的阿里云地域列表。

ResourceType String 是 stack

资源类型。取值：

  • stack：资源栈。
  • stackgroup：资源栈组。
  • template：模板。
  • templatescratch：资源场景。
ResourceId.N String 是 7fee80e1-8c48-4c2f-8300-0f6dc40b****

资源ID。最多支持指定50个资源ID。

说明 当ResourceType取值为stackgroup时，资源ID需指定资源栈组名称。
Tag.N.Key String 是 FinanceDept

资源的标签键。最多支持指定20个标签键。

长度不超过128个字符，不能以aliyun和acs:开头，不能包含http://或者https://。

Tag.N.Value String 是 FinanceJoshua

资源的标签值。最多支持指定20个标签值。

长度不超过128个字符，不能以aliyun和acs:开头，不能包含http://或者https://。

关于公共请求参数的详情，请参见公共参数。

返回数据

名称 类型 示例值 描述
RequestId String C46FF5A8-C5F0-4024-8262-B16B639225A0

请求ID。

示例

请求示例

http(s)://ros.aliyuncs.com/?Action=TagResources
&RegionId=cn-hangzhou
&ResourceId.1=7fee80e1-8c48-4c2f-8300-0f6dc40b****
&ResourceType=stack
&Tag.1.Key=FinanceDept
&Tag.1.Value=FinanceJoshua
&<公共请求参数>

正常返回示例

XML格式 

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

<TagResourcesResponse>
		<RequestId>C46FF5A8-C5F0-4024-8262-B16B639225A0</RequestId>
</TagResourcesResponse>

JSON格式 

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

{
  "RequestId" : "C46FF5A8-C5F0-4024-8262-B16B639225A0"
}

错误码

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

HttpCode

错误码

错误信息

描述

400

InvalidParameter

The specified parameter ResourceType is invalid, {reason}.

指定的资源类型参数错误，reason为具体原因。

400

InvalidParameter

The specified parameter ResourceIds is invalid, {reason}.

资源ID不存在或校验异常，reason为具体原因。

400

InvalidParameter

The specified parameter Tags is invalid, {reason}.

指定的Tags参数错误，reason为具体原因。

400

Duplicate.TagKey

The Tag.N.Key contain duplicate key.

标签中存在重复的键，请保持键的唯一性。