更新时间:2023-11-07 GMT+08:00

更新流量镜像筛选规则

功能介绍

更新流量镜像筛选规则

URI

PUT /v3/{project_id}/vpc/traffic-mirror-filter-rules/{traffic_mirror_filter_rule_id}

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID

traffic_mirror_filter_rule_id

String

流量镜像筛选条件规则ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

traffic_mirror_filter_rule

UpdateTrafficMirrorFilterRuleOption object

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

表3 UpdateTrafficMirrorFilterRuleOption

参数

是否必选

参数类型

描述

description

String

功能说明:流量镜像筛选规则的描述信息

取值范围:0-255个字符,不能包含“<”和“>”

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

priority

Integer

功能说明:镜像规则优先级

取值范围:1~65535,数字越小,优先级越高

action

String

功能说明:镜像策略

取值范围:accept(采集)、reject(不采集)

响应参数

状态码: 200

表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为7c12805a-1b8d-40b5-ab23-a8fac480f2ec的流量镜像筛选规则,策略更新为reject。

PUT http://{endpoint}/v3/{project_id}/vpc/traffic-mirror-filter-rules/7c12805a-1b8d-40b5-ab23-a8fac480f2ec

{
  "traffic_mirror_filter_rule" : {
    "source_port_range" : "80-90",
    "destination_cidr_block" : "192.168.1.0/24",
    "source_cidr_block" : "10.0.0.0/8",
    "action" : "reject"
  }
}

响应示例

状态码: 200

OK

{
  "request_id" : "197e0ed1-f59f-473b-9363-74666a7d3710",
  "traffic_mirror_filter_rule" : {
    "created_at" : "2023-03-09T13:14:47Z",
    "updated_at" : "2023-03-09T13:16:43Z",
    "id" : "7c12805a-1b8d-40b5-ab23-a8fac480f2ec",
    "project_id" : "7365fcd452924e398ec4cc1fe39c0d12",
    "description" : "",
    "traffic_mirror_filter_id" : "417d7317-6c17-4428-a0f3-997d3e2293a0",
    "direction" : "ingress",
    "protocol" : "ICMP",
    "ethertype" : "IPv4",
    "source_cidr_block" : "80-90",
    "destination_cidr_block" : "192.168.1.0/24",
    "source_port_range" : "10.0.0.0/8",
    "destination_port_range" : null,
    "action" : "reject",
    "priority" : 23
  }
}

状态码

状态码

描述

200

OK

错误码

请参见错误码