资源数量统计 - ListCountResources

功能介绍

资源数量统计

调用方法

请参见如何调用API。

授权信息

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

如果使用角色与策略授权，具体权限要求请参见权限和授权项。
如果使用身份策略授权，需具备如下身份策略权限。
授权项
访问级别
资源类型（*为必须）
条件键
别名
依赖的授权项
cts:resource:count
List
-
-
-
-

授权项	访问级别	资源类型（*为必须）	条件键	别名	依赖的授权项
cts:resource:count	List	-	-	-	-

URI

POST /v3/{project_id}/{resource_type}/resource-instances/count

表1 路径参数
参数	是否必选	参数类型	描述
project_id	是	String	项目ID。
resource_type	是	String	资源的类型：cts-tracker

请求参数

表2 请求Body参数
参数	是否必选	参数类型	描述
without_any_tag	否	Boolean	是否仅查询未带标签的资源。该字段为true时查询所有不带标签的资源，此时忽略 “tags”字段。该字段为false或者未提供该参数时，该条件不生效，即返回所有资源或按"tags"，"matches"等条件过滤。
tags	否	Array of TmsTags objects	标签列表。最多包含20个key，每个key下面的value最多20个。
matches	否	Array of Match objects	搜索字段。key为要匹配的字段，value为匹配的值。如果value为空字符串则精确匹配，否则模糊匹配。

表3 TmsTags
参数	是否必选	参数类型	描述
key	否	String	键。最大长度128个unicode字符。标签的键可以包含任意语种字母、数字、空格和_ . : =+ - @，但首尾不能含有空格
values	否	Array of strings	value列表

表4 Match
参数	是否必选	参数类型	描述
key	否	String	键。当前值限定为resource_name。
value	否	String	值。每个值最大长度255个unicode字符。不能包含“_”,“%”特殊字符。

响应参数

状态码：200

表5 响应Body参数
参数	参数类型	描述
total_count	Integer	总记录数。

请求示例

https://{endpoint}/v3/{project_id}/{resource_type}/resource-instances/count

{
  "offset" : "100",
  "limit" : "100",
  "action" : "count",
  "without_any_tag" : true,
  "tags" : [ {
    "key" : "key1",
    "values" : [ "*value1", "value2" ]
  } ],
  "tags_any" : [ {
    "key" : "key1",
    "values" : [ "*value1", "value2" ]
  } ],
  "not_tags" : [ {
    "key" : "key1",
    "values" : [ "*value1", "value2" ]
  } ],
  "not_tags_any" : [ {
    "key" : "key1",
    "values" : [ "*value1", "value2" ]
  } ],
  "sys_tags" : [ {
    "key" : "key1",
    "values" : [ "*value1", "value2" ]
  } ],
  "matches" : [ {
    "key" : "resource_name",
    "value" : "resource1"
  } ]
}