调用GetResourceCounts查询当前账号下的资源数量_资源管理(Resource Management)-阿里云帮助中心

查询当前账号下有权限访问的资源数量。

接口说明

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

调试

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

调试

授权信息

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

请求参数

名称	类型	必填	描述	示例值
GroupByKey	string	否	资源数量统计的分组维度。取值： ResourceType：资源类型。 RegionId：地域。 ResourceGroupId：资源组 ID。	ResourceType
Filter	object []	否	过滤条件。
Key	string	否	过滤条件键。取值见下方`支持的过滤参数`。	RegionId
Value	array	否	过滤条件值。
	string	否	过滤条件值。	cn-shanghai
MatchType	string	否	匹配方式。取值为 Equals，表示相等匹配。	Equals

支持的过滤参数

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

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

变更时间

变更内容概要

操作

2023-08-22

API 内部配置变更，不影响调用

看变更集

变更项	变更内容
	API 内部配置变更，不影响调用。