通过标签查询资源实例数量 - CountResourcesByTag

功能介绍

通过标签查询资源实例数量。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

• 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
• 如果使用身份策略授权，需具备如下身份策略权限。

  授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
  ga::listResourcesByTag	List	-	g:TagKeys	ga:tag:listResourcesByTag	-

URI

POST /v1/{resource_type}/resource-instances/count

请求参数

响应参数

状态码：200

请求示例

通过标签查询资源实例数量

POST https://{ga_endpoint}/v1/{resource_type}/resource-instances/count

{
  "tags" : [ {
    "key" : "tagKey",
    "values" : [ "tagValue" ]
  } ],
  "matches" : [ {
    "key" : "resourceName",
    "value" : "name"
  } ]
}

响应示例

状态码：200

操作成功

{
  "total_count" : 10,
  "request_id" : "ac1bf54f-6a23-4074-af77-800648d25bc9"
}

状态码

错误码

请参见错误码。