调用GetResourceCounts通过分组和过滤查询资源数量-资源管理-阿里云

接口说明

仅能搜索当前账号下有权限访问的资源数量。
仅能搜索支持资源中心的云服务及资源类型。

调试

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

调试

授权信息

当前API暂无授权信息透出。

请求参数

名称	类型	必填	描述	示例值
GroupByKey	string	否	资源数量统计的分组维度。取值： ResourceType：资源类型。 RegionId：地域。 ResourceGroupId：资源组 ID。	ResourceType
Filter	array<object>	否	过滤条件。
	object	否	过滤条件。
Key	string	否	过滤条件键。取值见下方`支持的过滤参数`。	RegionId
MatchType	string	否	匹配方式。取值为 Equals，表示相等匹配。	Equals
Value	array	否	过滤条件值。
	string	否	过滤条件值。	cn-shanghai
SearchExpression	string	否	搜索关键词。资源中心会根据相关性对搜索结果进行过滤。	keywords
IncludeDeletedResources	boolean	否	是否包含已删除资源。	true

支持的过滤参数

参数	描述	支持的匹配类型
ResourceType	资源类型。	Equals
RegionId	地域 ID。	Equals
ResourceId	资源 ID。	Equals、Prefix
ResourceGroupId	资源组 ID。	Equals、Exists、NotExists
ResourceName	资源名称。	Equals、Contains
Tag	标签键值对。 JSON 格式为 `{ "key": $key, "value": $value }` ，key 与 value 至少出现一个。例如：查询标签键`foo`和标签值`bar`，则传递`{ "key": "foo", "value": "bar" }` ；查询标签键`foo`，则传递`{ "key": "foo" }`。	Contains、NotContains、NotExists
VpcId	VPC ID。	Equals
VSwitchId	交换机 ID。	Equals

返回参数

名称	类型	描述	示例值
	object	返回参数。
Filters	array<object>	过滤条件。
	object	过滤条件。
Key	string	过滤条件键。	RegionId
Values	array	过滤条件值。
	string	过滤条件值。	cn-shanghai
GroupByKey	string	资源统计的分组维度。	ResourceType
RequestId	string	请求 ID。	6D98D9B0-318D-56A4-910C-93B5F945AF2B
ResourceCounts	array<object>	资源数量列表。
	object	资源数量。
Count	integer	资源数量。	2
GroupName	string	分组名称。	ACS::ECS::NetworkInterface

示例

正常返回示例

JSON格式

{
  "Filters": [
    {
      "Key": "RegionId",
      "Values": [
        "cn-shanghai"
      ]
    }
  ],
  "GroupByKey": "ResourceType",
  "RequestId": "6D98D9B0-318D-56A4-910C-93B5F945AF2B",
  "ResourceCounts": [
    {
      "Count": 2,
      "GroupName": "ACS::ECS::NetworkInterface"
    }
  ]
}

错误码

HTTP status code	错误码	错误信息	描述
400	InvalidParameter.Filter.ResourceType	The specified parameter value of Filter.ResourceType is not valid.
409	ExceedLimit.FilterValue	The number of objects specified in the FilterValue parameter exceeds the upper limit.	参数 FilterValue 数量超出上限。

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

变更历史

更多信息，参考变更详情。