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

查询流量镜像筛选规则列表

功能介绍

查询流量镜像筛选规则列表

调试

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID。

获取方式请参见获取项目ID。
表2 Query参数

参数

是否必选

参数类型

描述

id

否

String

使用规则ID过滤或排序

action

否

String

使用规则action过滤

description

否

String

使用规则描述过滤

destination_cidr_block

否

String

使用规则目的网段过滤

destination_port_range

否

String

使用规则目的端口范围过滤

direction

否

String

使用规则方向过滤

priority

否

String

使用规则优先级过滤

protocol

否

String

使用规则协议过滤

source_cidr_block

否

String

使用规则源网段过滤

source_port_range

否

String

使用规则源端口范围过滤

traffic_mirror_filter_id

否

String

使用筛选条件ID过滤

请求参数

无

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

traffic_mirror_filter_rules

Array of TrafficMirrorFilterRule objects

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

page_info

PageInfo object

分页信息

request_id

String

请求ID
表4 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

更新时间戳
表5 PageInfo

参数

参数类型

描述

previous_marker

String

当前页第一条记录。

current_count

Integer

当前页总数。

next_marker

String

当前页最后一条记录，最后一页时无next_marker字段。

请求示例

查询流量镜像筛选规则列表

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

响应示例

状态码： 200

OK

{
  "request_id" : "38719a68-c7c1-4fe1-bf12-4bb049349174",
  "traffic_mirror_filter_rules" : [ {
    "created_at" : "2023-02-17T08:42:44.000+00:00",
    "updated_at" : "2023-02-17T08:42:44.000+00:00",
    "id" : "3daa97b5-ad58-477d-86a5-52b65257f94b",
    "project_id" : "7365fcd452924e398ec4cc1fe39c0d12",
    "description" : "",
    "traffic_mirror_filter_id" : "b765ba87-c0b4-4f1a-9ec3-d5b1d1ddb137",
    "direction" : "ingress",
    "protocol" : "ICMPV6",
    "ethertype" : "IPv4",
    "action" : "accept",
    "priority" : 16
  } ],
  "page_info" : {
    "previous_marker" : "3daa97b5-ad58-477d-86a5-52b65257f94b",
    "current_count" : 1
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码。