调用DescribeGroupedTags接口查询资产标签的统计信息。

调试

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

请求参数

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

需要执行的操作。

取值:DescribeGroupedTags

MachineTypes String ecs

指定要查询的资产类型。不指定资产类型时,默认查询所有资产类型下的标签信息。取值:

  • ecs:服务器
  • cloud_product:云产品

调用API时,除了本文中该API的请求参数,还需加入阿里云API公共请求参数。公共请求参数的详细介绍,请参见公共参数

调用API的请求格式,请参见本文示例中的请求示例。

返回数据

名称 类型 示例值 描述
Count Integer 0

该参数已废弃,无需关注。

GroupedFileds Array of GroupedFiled

资产标签的统计信息。

Count String 152

标签对应的资产数量。

Name String InternetIp

标签名称。

TagId Integer 3252366

标签ID。

HttpStatusCode Integer 200

请求数据结果的HTTP状态码。

RequestId String 151F6EB6-D5F3-417A-AF7B-4D84975DB586

阿里云为该请求生成的唯一标识符。

Success Boolean true

数据请求是否成功。取值:

  • true:请求成功
  • false:请求失败

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeGroupedTags
&<公共请求参数>

正常返回示例

XML格式

<DescribeGroupedTagsResponse>
      <RequestId>151F6EB6-D5F3-417A-AF7B-4D84975DB586</RequestId>
      <HttpStatusCode>200</HttpStatusCode>
      <GroupedFileds>
            <TagId>3252366</TagId>
            <Count>152</Count>
            <Name>InternetIp</Name>
      </GroupedFileds>
      <GroupedFileds>
            <TagId>3893339</TagId>
            <Count>3</Count>
            <Name>abc</Name>
      </GroupedFileds>
      <GroupedFileds>
            <TagId>3897941</TagId>
            <Count>3</Count>
            <Name>efg</Name>
      </GroupedFileds>
      <Count>0</Count>
      <Success>true</Success>
</DescribeGroupedTagsResponse>

JSON格式

{
	"RequestId": "151F6EB6-D5F3-417A-AF7B-4D84975DB586",
	"HttpStatusCode": 200,
	"GroupedFileds": [
		{
			"TagId": 3252366,
			"Count": "152",
			"Name": "InternetIp"
		},
		{
			"TagId": 3893339,
			"Count": "3",
			"Name": "abc"
		},
		{
			"TagId": 3897941,
			"Count": "3",
			"Name": "efg"
		}
	],
	"Count": 0,
	"Success": true
}

错误码

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