资源数量统计
功能介绍
资源数量统计
调用方法
请参见如何调用API。
URI
POST /v3/{project_id}/{resource_type}/resource-instances/count
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
project_id |
是 |
String |
项目ID。 |
resource_type |
是 |
String |
资源的类型:cts-tracker |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
---|---|---|---|
without_any_tag |
否 |
Boolean |
true或false |
tags |
否 |
Array of TmsTags objects |
包含标签。 最多包含10个key,每个key下面的value最多10个,结构体不能缺失,key不能为空或者空字符串。Key不能重复,同一个key中values不能重复。 |
tags_any |
否 |
Array of TmsTags objects |
最多包含10个key,每个key下面的value最多10个,结构体不能缺失,key不能为空或者空字符串。Key不能重复,同一个key中values不能重复。 |
not_tags |
否 |
Array of TmsTags objects |
最多包含10个key,每个key下面的value最多10个,结构体不能缺失,key不能为空或者空字符串。Key不能重复,同一个key中values不能重复。 |
not_tags_any |
否 |
Array of TmsTags objects |
最多包含10个key,每个key下面的value最多10个,结构体不能缺失,key不能为空或者空字符串。Key不能重复,同一个key中values不能重复。 |
sys_tags |
否 |
Array of TmsTags objects |
最多包含10个key,每个key下面的value最多10个,结构体不能缺失,key不能为空或者空字符串。Key不能重复,同一个key中values不能重复。 |
matches |
否 |
Array of Match objects |
key为要匹配的字段,value为匹配的值。 如果value为空字符串则精确匹配,否则模糊匹配。 |
action |
否 |
String |
操作标识(区分大小写)。 取值范围: filter:分页过滤查询 count:查询总条数 |
limit |
否 |
String |
每页返回的资源个数。 取值范围:1~1000 参数取值说明: 如果action为filter时,默认为1000。 如果action为count时,无此参数。 |
offset |
否 |
String |
分页查询起始偏移量,表示从偏移量的下一个资源开始查询。 取值范围:0~2147483647 默认值为0。 参数取值说明: 查询第一页数据时,不需要传入此参数。 查询后续页码数据时,将查询前一页数据时响应体中的值带入此参数。 如果action为filter时,默认为0,必须为数字,不能为负数。 如果action为count时,无此参数。 |
响应参数
无
请求示例
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" } ] }
响应示例
状态码: 200
{ "total_count": 1, "resources": [{ "resource_id": "", "resource_detail": null, "tags": [{ "key": "key1", "value": "value1" }, "sys_tags": [{ "key": "key2", "value": "value2" }, "resource_name": ""] }] }
状态码
状态码 |
描述 |
---|---|
200 |
错误码
请参见错误码。