文档首页/ 虚拟私有云 VPC/ API参考/ API V3/ 流量镜像筛选规则/ 创建流量镜像筛选规则
更新时间：2024-10-11 GMT+08:00
在线调试
CLI示例
编辑
查看PDF
分享

创建流量镜像筛选规则

功能介绍

创建流量镜像筛选规则

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。

URI

POST /v3/{project_id}/vpc/traffic-mirror-filter-rules

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。

获取方式请参见获取项目ID。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

traffic_mirror_filter_rule

是

CreateTrafficMirrorFilterRuleOption object

流量镜像筛选条件规则对象
表3 CreateTrafficMirrorFilterRuleOption

参数

是否必选

参数类型

描述

description

否

String

功能说明：流量镜像筛选规则的描述信息

取值范围：0-255个字符，不能包含“<”和“>”

traffic_mirror_filter_id

是

String

功能说明：流量镜像筛选条件ID

direction

是

String

功能说明：流量方向

取值范围：

ingress，入方向；

egress，出方向

protocol

是

String

功能说明：镜像流量的协议类型

取值范围：TCP、UDP、ICMP、ICMPV6、ALL

ethertype

是

String

功能说明：镜像流量的地址协议版本

取值范围：IPv4，IPv6

source_cidr_block

否

String

功能说明：镜像流量的源网段

destination_cidr_block

否

String

功能说明：镜像流量的目的网段

source_port_range

否

String

功能说明：流量源端口范围

取值范围：1~65535

格式：80-200

destination_port_range

否

String

功能说明：流量目的端口范围

取值范围：1~65535

格式：80-200

action

是

String

功能说明：镜像策略

取值范围：accept（采集）、reject（不采集）

priority

是

Integer

功能说明：镜像规则优先级

取值范围：1~65535，数字越小，优先级越高

响应参数

状态码： 201

表4 响应Body参数

参数

参数类型

描述

traffic_mirror_filter_rule

TrafficMirrorFilterRule object

流量镜像筛选条件规则对象

request_id

String

请求ID
表5 TrafficMirrorFilterRule

参数

参数类型

描述

id

String

功能说明：流量镜像筛选规则ID

project_id

String

功能说明：项目ID

description

String

功能说明：流量镜像筛选规则的描述信息

取值范围：0-255个字符，不能包含“<”和“>”

traffic_mirror_filter_id

String

功能说明：流量镜像筛选条件ID

direction

String

功能说明：流量方向

取值范围：

ingress，入方向；

egress，出方向

source_cidr_block

String

功能说明：镜像流量的源网段

destination_cidr_block

String

功能说明：镜像流量的目的网段

source_port_range

String

功能说明：流量源端口范围

取值范围：1~65535

格式：80-200

destination_port_range

String

功能说明：流量目的端口范围

取值范围：1~65535

格式：80-200

ethertype

String

功能说明：镜像流量的地址协议版本

取值范围：IPv4，IPv6

protocol

String

功能说明：镜像流量的协议类型

取值范围：TCP、UDP、ICMP、ICMPV6、ALL

action

String

功能说明：镜像策略

取值范围：accept（采集）、reject（不采集）

priority

Integer

功能说明：镜像规则优先级

取值范围：1~65535，数字越小，优先级越高

created_at

String

创建时间戳

updated_at

String

更新时间戳

请求示例

创建一条流量镜像筛选规则，入方向，筛选条件ID为417d7317-6c17-4428-a0f3-997d3e2293a0，源cidr为192.168.0.0/24。

POST http://{endpoint}/v3/{project_id}/vpc/traffic-mirror-filter-rules

{
  "traffic_mirror_filter_rule" : {
    "traffic_mirror_filter_id" : "417d7317-6c17-4428-a0f3-997d3e2293a0",
    "ethertype" : "ipv4",
    "direction" : "ingress",
    "protocol" : "ICMP",
    "source_cidr_block" : "192.168.0.0/24",
    "action" : "accept",
    "priority" : 29
  }
}

响应示例

状态码： 201

Created

{
  "request_id" : "8dec5453-1690-4378-a976-40ba5e6d62ff",
  "traffic_mirror_filter_rule" : {
    "created_at" : "2023-03-22T07:07:55.000+00:00",
    "updated_at" : "2023-03-22T07:07:55.000+00:00",
    "id" : "1be5f64b-49a1-427d-a49e-9619cfb0492c",
    "project_id" : "7365fcd452924e398ec4cc1fe39c0d12",
    "description" : "",
    "traffic_mirror_filter_id" : "417d7317-6c17-4428-a0f3-997d3e2293a0",
    "direction" : "ingress",
    "protocol" : "ICMP",
    "ethertype" : "IPv4",
    "source_cidr_block" : "192.168.0.0/24",
    "action" : "accept",
    "priority" : 29
  }
}

状态码

状态码

描述

201

Created

错误码

请参见错误码。

相关文档