查询流日志列表
功能介绍
查询企业路由器实例下的流日志列表
接口约束
-
支持过滤查询,过滤条件有resource_type,resource_id,enterprise_project_id过滤条件可以重复和组合。
-
支持分页查询,limit和marker组合实现分页查询。
-
支持单字段排序功能,排序字段有[id,name,state],不支持多字段排序。
调用方法
请参见如何调用API。
URI
GET /v3/{project_id}/enterprise-router/{er_id}/flow-logs
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 项目ID |
| er_id | 是 | String | 企业路由器实例ID |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| resource_type | 否 | String |
|
| resource_id | 否 | Array of strings | 连接对应的资源ID列表 |
| limit | 否 | Integer | 每页返回的个数。 取值范围:1~2000。 最小值:1 最大值:2000 |
| marker | 否 | String | 查询的页码id,为空时为查询第一页。 使用说明:必须与limit一起使用。 最小长度:1 最大长度:128 |
| sort_key | 否 | Array of strings |
|
| sort_dir | 否 | Array of strings | 返回结果按照升序或降序排列,默认为asc,降序为desc |
请求参数
无
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| flow_logs | Array of FlowLog objects | 流日志详情 |
| request_id | String | 请求ID |
| total_count | Long | 总计数量 |
| page_info | PageInfo object | 分页查询的信息 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 流日志ID |
| name | String | 流日志名称 |
| description | String | 流日志描述 |
| project_id | String | 流日志任务创建者项目ID |
| resource_type | String |
|
| resource_id | String | 采集的资源ID |
| log_group_id | String | 日志组ID |
| log_stream_id | String | 日志流ID |
| log_store_type | String | 流日志存储类型:
|
| log_aggregation_interval | Integer | 日志聚合时间,单位s,取值范围:60-600 |
| created_at | String | 创建时间,格式:YYYY-MM-DDTHH:mm:ss.sssZ |
| updated_at | String | 更新时间,格式:YYYY-MM-DDTHH:mm:ss.sssZ |
| state | String |
|
| enabled | Boolean |
|
请求示例
查询流日志列表
GET https://{erouter_endpoint}/v3/0605767a9980d5762fbcc00b3537e757/enterprise-router/a43c55e9-4911-4030-90e1-5c2bf6ae6fe2/flow-logs 响应示例
状态码:200
OK
{
"flow_logs" : [ {
"id" : "b216bc1d-5963-41a7-89f9-779a5128c5ac",
"name" : "flow_log",
"project_id" : "0605767a9980d5762fbcc00b3537e757",
"resource_type" : "attachment",
"resource_id" : "6f83b848-8331-4271-ac0c-ef94b7686402",
"log_group_id" : "0139393c-eeb2-49f0-bbd4-c5faec6b1497",
"log_stream_id" : "d22c3b44-2f71-470f-83f3-96a8af6956ad",
"log_store_type" : "LTS",
"log_aggregation_interval" : 600,
"created_at" : "2020-03-11T15:13:31Z",
"updated_at" : "2022-03-11T15:13:31Z",
"state" : "available",
"enabled" : true,
"description" : "ER流日志"
} ],
"page_info" : {
"next_marker" : "1",
"current_count" : 1
},
"request_id" : "915a14a6-867b-4af7-83d1-70efceb146f9"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
错误码
请参见错误码。