更新流量镜像筛选规则
功能介绍
更新流量镜像筛选规则
调用方法
请参见如何调用API。
URI
PUT /v3/{project_id}/vpc/traffic-mirror-filter-rules/{traffic_mirror_filter_rule_id}
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
参数解释: 流量镜像筛选规则所属的项目ID。 取值范围: 不涉及。 |
|
traffic_mirror_filter_rule_id |
是 |
String |
参数解释: 流量镜像筛选条件规则的资源ID。您可以先通过查询流量镜像筛选规则列表API获取目标流量镜像筛选规则ID,再使用当前API更新流量镜像筛选规则。 取值范围: 不涉及。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
traffic_mirror_filter_rule |
是 |
流量镜像筛选条件规则对象 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
参数解释: 流量镜像筛选规则的流量方向。 取值范围:
|
|
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。 |
请求示例
更新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:47.000+00:00",
"updated_at" : "2023-03-09T13:16:43.000+00:00",
"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",
"action" : "reject",
"priority" : 23
}
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
OK |
错误码
请参见错误码。