更新时间:2024-12-27 GMT+08:00

创建流日志

功能介绍

给ER实例创建流日志。

调用方法

请参见如何调用API

URI

POST /v3/{project_id}/enterprise-router/{er_id}/flow-logs

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

er_id

String

企业路由器实例ID

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Client-Token

String

幂等性标识

最小长度:1

最大长度:64

表3 请求Body参数

参数

是否必选

参数类型

描述

flow_log

FlowLogRequest object

创建流日志请求体

表4 FlowLogRequest

参数

是否必选

参数类型

描述

name

String

流日志名称

最小长度:1

最大长度:64

description

String

流日志描述

最小长度:0

最大长度:255

resource_type

String

流日志采集的资源类型:

  • VPC连接

  • 虚拟网关连接

resource_id

String

要采集的资源ID

log_group_id

String

日志组ID。请在云日志服务中获取,详情请参见《云日志服务用户指南》。

log_stream_id

String

日志主题ID。请在云日志服务中获取,详情请参见《云日志服务用户指南》。

log_store_type

String

流日志的存储类型:

  • LTS: 云日志服务器存储

响应参数

状态码: 202

表5 响应Header参数

参数

参数类型

描述

X-Client-Token

String

幂等性标识

表6 响应Body参数

参数

参数类型

描述

flow_log

FlowLog object

流日志详情

request_id

String

请求id

表7 FlowLog

参数

参数类型

描述

id

String

流日志ID

name

String

流日志名称

description

String

流日志描述

project_id

String

流日志任务创建者项目ID

resource_type

String

采集的资源类型:attachment

resource_id

String

采集的资源ID

log_group_id

String

日志组ID

log_stream_id

String

日志流ID

log_store_type

String

流日志存储类型:LTS

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

日志资源状态:pending|available|modifying|deleting|deleted|failed

enabled

Boolean

日志开关:true|false

请求示例

创建流日志

POST https://{erouter_endpoint}/v3/0605767a9980d5762fbcc00b3537e757/enterprise-router/a43c55e9-4911-4030-90e1-5c2bf6ae6fe2/flow-logs

{
  "flow_log" : {
    "name" : "flow-log",
    "description" : "flow log test",
    "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"
  }
}

响应示例

状态码: 202

Accepted

{
  "flow_log" : {
    "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流日志"
  },
  "request_id" : "915a14a6-867b-4af7-83d1-70efceb146f9"
}

状态码

状态码

描述

202

Accepted

错误码

请参见错误码