You need to enable JavaScript to run this app.
导航
弹性伸缩
  • 文档首页
    • /
  • 弹性伸缩

TagResources

最近更新时间：2024.03.20 15:42:20

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

我的收藏

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

请求参数

名称类型是否必填示例值描述
ActionString是TagResources要执行的操作，取值：TagResources。
VersionString是2020-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:或sys:的任意大小写组合开头。

      说明

      volc:或sys:开头为系统预留标签键，禁止创建。

  • 只能包含语言字符、数字、空格和英文符号“_”、“.”、“:”、“/”、“=”、“+”、“-”、“@”。
  • 长度限制在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
            }
        ]
    }
}