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

ListTagResources

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

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

我的收藏

调用 ListTagResources 查询伸缩组的用户标签。

请求参数

名称类型是否必填示例值描述
ActionString是ListTagResources要执行的操作，取值：ListTagResources。
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。

TagFilters.N.Key

String

否

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

精确查找弹性伸缩资源时使用的标签键。

  • 标签键长度的取值范围：1~128。
  • 参数 - N：表示标签键的序号。取值：1～50。
  • 多个标签键之间用&分隔。
    TagFilters用于精确查找绑定了指定标签的弹性伸缩资源，由一个键值对组成。
  • 仅指定本参数时，返回关联该标签键的所有资源。
  • 同时指定多个标签键时，返回同时满足所有标签键的资源。

TagFilters.N.Value

String

否

TagFilters.1.Value=v1&TagFilters.2.Value=v2

精确查找弹性伸缩资源时使用的标签值。

  • 标签值可以为空字符串，长度取值范围：1~128。
  • 参数 - N：表示标签值的序号。取值范围：1～50。
  • 多个标签值之间用&分隔。

指定本参数时，则必须指定TagFilters.N.Key。

NextTokenString否bHpwdXJja2RxemU1eG5sb3NzdGcW1-RCEq******分页查询凭证，用于标记分页的位置，初次调用该接口时无需设置。下次查询时，取值为上一次API调用返回的NextToken参数值。
MaxResultsInteger否10分页查询时设置的每页行数，取值范围为1~100，默认为10。

返回数据

名称类型示例值描述

NextToken

String

bHpwdXJja2RxemU1eG5sb3NzdGcW1-RCEq******

本次调用返回的查询凭证值，返回为空表示该页为末页。

TagResourcesArray of Struct-由资源及其标签组成的集合。具体请参见下表“TagResource结构 ”。

TagResource

名称类型示例值描述
ResourceTypeStringscalinggroup资源类型。
ResourceIdStringscg-ybmssdnnhn5pkgyd****资源ID。
TagKeyStringk1标签键。
TagValueStringv1标签值。

请求示例

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

返回示例

{
    "ResponseMetadata": {
        "RequestId": "20230816152620D3B33B2D710FF361****",
        "Action": "ListTagResources",
        "Version": "2020-01-01",
        "Service": "auto_scaling",
        "Region": "cn-beijing"
    },
    "Result": {
        "NextToken": "",
        "TagResources": [
            {
                "ResourceType": "scalinggroup",
                "ResourceId": "scg-ybmssdnnhn5pkgyd****",
                "TagKey": "k1",
                "TagValue": "v1"
            },
            {
                "ResourceType": "scalinggroup",
                "ResourceId": "scg-ybmssdnnhn5pkfud****",
                "TagKey": "k2",
                "TagValue": "v2"
            }
        ]
    }
}