创建流量镜像筛选条件
功能介绍
流量镜像筛选条件用于筛选指定流量实现镜像。您可以通过此接口创建筛选条件,筛选条件包含入方向规则和出方向规则,规则由优先级、流量采集策略以及匹配条件组成。
• 入方向规则:用来匹配镜像源接收到的流量。
• 出方向规则:用来匹配镜像源发送出去的流量。
筛选条件无法独立使用,需要被关联至镜像会话才可以使用。
调用方法
请参见如何调用API。
URI
POST /v3/{project_id}/vpc/traffic-mirror-filters
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 流量镜像筛选条件所属的项目ID。 取值范围: 不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
traffic_mirror_filter |
是 |
流量镜像筛选条件对象 |
响应参数
状态码:201
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
traffic_mirror_filter |
TrafficMirrorFilter object |
参数解释: 查询流量镜像筛选条件详情的响应体。 取值范围: 不涉及。 |
|
request_id |
String |
参数解释: 请求ID。 取值范围: 不涉及。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
参数解释: 流量镜像筛选条件的资源D。流量镜像筛选条件创建成功后,会生成一个流量镜像筛选条件 ID,是流量镜像筛选条件对应的唯一标识。 取值范围: 不涉及。 |
|
project_id |
String |
参数解释: 流量镜像筛选条件所属的项目ID。 取值范围: 不涉及。 |
|
description |
String |
参数解释: 流量镜像筛选条件的描述信息。 取值范围: 0-255个字符,不能包含“<”和“>” |
|
name |
String |
参数解释: 流量镜像筛选条件的名称。 取值范围: 1-64个字符,支持数字、字母、中文、_(下划线)、-(中划线)、.(点)。 |
|
ingress_rules |
Array of TrafficMirrorFilterRule objects |
参数解释: 流量镜像筛选条件中的入方向筛选规则列表。 取值范围: 不涉及。 |
|
egress_rules |
Array of TrafficMirrorFilterRule objects |
参数解释: 流量镜像筛选条件中的出方向筛选规则列表。 取值范围: 不涉及。 |
|
created_at |
String |
参数解释: 流量镜像筛选条件的创建时间。 取值范围: UTC时间格式,yyyy-MM-ddTHH:mm:ssZ。 |
|
updated_at |
String |
参数解释: 流量镜像筛选条件的更新时间。 取值范围: UTC时间格式,yyyy-MM-ddTHH:mm:ssZ。 |
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
id |
String |
参数解释: 流量镜像筛选规则的资源ID。 取值范围: 不涉及。 |
|
project_id |
String |
参数解释: 流量镜像筛选规则所属的项目ID。 取值范围: 不涉及。 |
|
description |
String |
参数解释: 流量镜像筛选规则的描述信息。 取值范围: 0-255个字符,不能包含“<”和“>”。 |
|
traffic_mirror_filter_id |
String |
参数解释: 流量镜像筛选规则所在流量镜像筛选条件的ID。 取值范围: 不涉及。 |
|
direction |
String |
参数解释: 流量镜像筛选规则的流量方向。 取值范围:
|
|
source_cidr_block |
String |
参数解释: 流量镜像筛选规则的源地址。 取值范围:
|
|
destination_cidr_block |
String |
参数解释: 流量镜像筛选规则的目的地址。 取值范围:
|
|
source_port_range |
String |
参数解释: 流量镜像筛选规则的源端口范围。 取值范围:
|
|
destination_port_range |
String |
参数解释: 流量镜像筛选规则的目的端口范围。 取值范围:
|
|
ethertype |
String |
参数解释: 流量支持的IP地址类型。 取值范围: IPv4,IPv6 |
|
protocol |
String |
参数解释: 流量支持的网络协议类型。 取值范围:
|
|
action |
String |
参数解释: 流量镜像筛选规则的流量采集策略。 取值范围:
|
|
priority |
Integer |
参数解释: 流量镜像筛选规则的优先级。 取值范围: 1~65535,数字越小,优先级越高。 |
|
created_at |
String |
参数解释: 流量镜像筛选规则的创建时间。 取值范围: UTC时间格式,yyyy-MM-ddTHH:mm:ssZ。 |
|
updated_at |
String |
参数解释: 流量镜像筛选规则的更新时间。 取值范围: UTC时间格式,yyyy-MM-ddTHH:mm:ssZ。 |
请求示例
创建流量镜像筛选条件,命名为test1,描述为description。
POST https://{endpoint}/v3/{project_id}/vpc/traffic-mirror-filters
{
"traffic_mirror_filter" : {
"name" : "test1",
"description" : "description"
}
}
响应示例
状态码:201
Created
{
"traffic_mirror_filter" : {
"id" : "59d2b2e7-0d35-41f7-a12e-f7699366cd21",
"project_id" : "49a42f378df747bf8b8f6a70e25b63fb",
"name" : "test1",
"description" : "description",
"ingress_rules" : [ ],
"egress_rules" : [ ],
"created_at" : "2022-08-29T06:22:01.000+00:00",
"updated_at" : "2022-08-29T06:22:01.000+00:00"
},
"request_id" : "f05abcd9-fa75-43a5-a795-b3d8e8b7a9e9"
}
状态码
|
状态码 |
描述 |
|---|---|
|
201 |
Created |
错误码
请参见错误码。