查询ACL资源实例数量
功能介绍
使用标签过滤查询ACL实例数量。
URI
POST /v3/{project_id}/firewalls/resource-instances/count
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
project_id |
是 |
String |
项目ID |
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 获取Token，请参考《统一身份认证服务API参考》的“获取用户Token”章节。请求响应成功后在响应消息头中包含的“X-Subject-Token”的值即为Token值。 |
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
matches |
否 |
Array of Match objects |
功能说明：搜索字段，key为要匹配的字段，value为匹配的值 约束：key为固定字典值，不能包含重复的key或不支持的key，当前key仅支持resource_name |
tags |
否 |
Array of ListTag objects |
包含标签，最多包含50个key，每个key下面的value最多10个，每个key对应的value可以为空数组但结构体不能缺失 。 Key不能重复，同一个key中values不能重复。 结果返回包含所有标签的资源列表，key之间是与的关系，key-value结构中value是或的关系。无tag过滤条件时返回全量数据。 |
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
request_id |
String |
请求ID |
total_count |
Integer |
资源数量 |
状态码： 400
参数 |
参数类型 |
描述 |
|---|---|---|
request_id |
String |
请求ID |
error_msg |
String |
错误消息 |
error_code |
String |
错误码 |
状态码： 401
参数 |
参数类型 |
描述 |
|---|---|---|
request_id |
String |
请求ID |
error_msg |
String |
错误消息 |
error_code |
String |
错误码 |
状态码： 403
参数 |
参数类型 |
描述 |
|---|---|---|
request_id |
String |
请求ID |
error_msg |
String |
错误消息 |
error_code |
String |
错误码 |
状态码： 404
参数 |
参数类型 |
描述 |
|---|---|---|
request_id |
String |
请求ID |
error_msg |
String |
错误消息 |
error_code |
String |
错误码 |
状态码： 500
参数 |
参数类型 |
描述 |
|---|---|---|
request_id |
String |
请求ID |
error_msg |
String |
错误消息 |
error_code |
String |
错误码 |
请求示例
过滤查询ACL资源实例列表，用tags和matches过滤。
POST https://{{Endpoint}}/v3/{project_id}/firewalls/resource-instances/count
{
"tags" : [ {
"key" : "key1",
"values" : [ "value1" ]
} ],
"matches" : [ {
"key" : "resource_name",
"value" : "network_aclv3_test"
} ]
}
响应示例
状态码： 200
请求正常返回
{
"request_id" : "239df34e-a651-4631-aaa1-d5fef231933a",
"total_count" : 2
}
状态码
状态码 |
描述 |
|---|---|
200 |
请求正常返回 |
400 |
参数非法 |
401 |
鉴权失败 |
403 |
权限不足 |
404 |
资源未找到 |
500 |
系统异常 |
错误码
请参见错误码。
