链接复制成功！
创建流量镜像筛选规则
功能介绍
创建流量镜像筛选规则
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。
URI
POST /v3/{project_id}/vpc/traffic-mirror-filter-rules
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。 获取方式请参见获取项目ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
traffic_mirror_filter_rule |
是 |
流量镜像筛选条件规则对象 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
traffic_mirror_filter_rule |
TrafficMirrorFilterRule object |
流量镜像筛选条件规则对象 |
|
request_id |
String |
请求ID |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
错误码
请参见错误码。
