本文导读

功能介绍
调试
URI
请求参数
响应参数
请求示例
响应示例
状态码
错误码

展开导读

文档首页/ 虚拟私有云 VPC/ API参考/ API V3/ 流量镜像筛选规则/ 创建流量镜像筛选规则

创建流量镜像筛选规则

更新时间：2025-04-07 GMT+08:00

编辑

查看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

错误码

请参见错误码。

父主题： 流量镜像筛选规则

上一篇：查询流量镜像筛选规则详情

下一篇：更新流量镜像筛选规则

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！您可在我的云声建议查看反馈及问题处理状态。

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消

如您有其它疑问，您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问

创建流量镜像筛选规则

功能介绍

调试

URI

请求参数

响应参数

请求示例

响应示例

状态码

错误码

相关文档

意见反馈

文档内容是否对您有帮助？

文档反馈