You need to enable JavaScript to run this app.
导航

TagResources

最近更新时间2023.08.28 16:18:12

首次发布时间2023.08.28 16:18:12

调用 TagResources 为多个伸缩组添加用户标签。

请求参数

名称类型是否必填示例值描述
ActionStringTagResources要执行的操作,取值:TagResources。
VersionString2020-01-01API的版本,取值为:2020-01-01。

ResourceType

String

scalinggroup

资源类型。取值:

  • scalinggroup:伸缩组。

ResourceIds.N

String

ResourceIds.1=scg-ybmssdnnhn5pkgyd****&ResourceIds.2=scg-ybmssdnnhn5pkfud****

资源ID。您可以调用DescribeScalingGroups 接口查询伸缩组ID。

  • 参数 - N:表示资源的序号,支持多选。取值范围:1~20。

Tags.N.Key

String

Tags.1.Key=k1&Tags.2.Key=k2

用户标签的标签键,此处指定的标签将同时与ResourceIds.N指定的所有资源关联。

  • 参数 - N:表示标签键的序号。
  • 多个标签键之间用&分隔。
    命名规则如下:
  • 不能以volc:的任意大小写组合开头。
  • 只能包含语言字符、数字、空格和英文符号“_”、“.”、“:”、“/”、“=”、“+”、“-”、“@”。
  • 长度限制在1~128个字符之间。

同一资源的标签键不允许重复。

Tags.N.Value

String

v1

用户标签的标签值。

  • 参数 - N:表示标签值的序号。
  • 多个标签值之间用&分隔。
    命名规则如下:
  • 只能包含语言字符、数字、空格和英文符号“_”、“.”、“:”、“/”、“=”、“+”、“-”、“@”。
  • 允许为空,长度限制在0~256个字符之间。

如果传入该参数,则必须先传入Tags.N.Key

返回数据

名称类型示例值描述

OperationDetails

Array of Struct

-

Tag操作详情,详情为空表示添加成功。具体请参见下表“OperationDetail结构”。

OperationDetail

名称类型示例值描述
ResourceIdStringscg-ybmssdnnhn5pkgyd****资源ID。
ErrorStruct-资源操作错误详情。具体请参见下表“Error结构”。

Error

名称类型示例值描述

Code

String

OperationDenied.ResourceLocked

错误码。

Message

String

The specified operation is denied as your resource is locked for another operation.

错误详情。

请求示例

GET ?Action=TagResources&ResourceType=scalinggroup&ResourceIds.1=scg-ybmssdnnhn5pkgyd****&Tags.1.Key=k1&Tags.2.Key=k2&Version=2020-01-01 HTTP/1.1
Host: open.volcengineapi.com
Region: cn-beijing
Service: auto_scaling

返回示例

{
    "ResponseMetadata": {
        "RequestId": "202308161519511187C1C71BAF6357****",
        "Action": "TagResources",
        "Version": "2020-01-01",
        "Service": "auto_scaling",
        "Region": "cn-beijing"
    },
    "Result": {
        "OperationDetails": [
            {
                "ResourceId": "scg-ybmssdnnhn5pkgyd****",
                "Error": null
            }
        ]
    }
}