文档首页/ 虚拟私有云 VPC/ API参考/ API V3/ 流量镜像筛选条件/ 查询流量镜像筛选条件列表
更新时间:2024-10-11 GMT+08:00

查询流量镜像筛选条件列表

功能介绍

查询流量镜像筛选条件列表

调试

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

URI

GET /v3/{project_id}/vpc/traffic-mirror-filters

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

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

表2 Query参数

参数

是否必选

参数类型

描述

id

String

使用ID过滤查询或排序

name

String

使用name过滤或排序

description

String

使用description过滤查询

created_at

String

使用创建时间戳排序

updated_at

String

使用更新时间戳排序

请求参数

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

traffic_mirror_filters

Array of TrafficMirrorFilter objects

流量镜像筛选条件对象列表

page_info

PageInfo object

分页信息

request_id

String

请求ID

表4 TrafficMirrorFilter

参数

参数类型

描述

id

String

功能说明:流量镜像筛选条件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

创建时间戳

updated_at

String

更新时间戳

表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

更新时间戳

表6 PageInfo

参数

参数类型

描述

previous_marker

String

当前页第一条记录。

current_count

Integer

当前页总数。

next_marker

String

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

请求示例

查询流量镜像筛选条件列表

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

响应示例

状态码: 200

OK

{
  "request_id" : "05e4a009-74aa-47cb-8055-c3da26a51737",
  "traffic_mirror_filters" : [ {
    "id" : "59d2b2e7-0d35-41f7-a12e-f7699366cd21",
    "project_id" : "49a42f378df747bf8b8f6a70e25b63fb",
    "name" : "test1",
    "description" : "new_filter",
    "ingress_rules" : [ ],
    "egress_rules" : [ ],
    "created_at" : "2022-08-29T06:22:01.000+00:00",
    "updated_at" : "2022-08-29T06:22:01.000+00:00"
  } ],
  "page_info" : {
    "previous_marker" : "180edd76-ab7e-4039-acc2-239ff89243e8",
    "current_count" : 1
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码