更新时间:2026-01-09 GMT+08:00

流量镜像会话移除镜像源

功能介绍

流量镜像会话移除镜像源。

调用方法

请参见如何调用API

URI

PUT /v3/{project_id}/vpc/traffic-mirror-sessions/{traffic_mirror_session_id}/remove-sources

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

流量镜像会话所属的项目ID。

取值范围

不涉及。

traffic_mirror_session_id

String

流量镜像会话ID

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

traffic_mirror_session

TrafficMirrorSourcesOption object

流量镜像会话对象

表3 TrafficMirrorSourcesOption

参数

是否必选

参数类型

描述

traffic_mirror_sources

Array of strings

功能说明:镜像源ID列表

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

traffic_mirror_session

TrafficMirrorSession object

参数解释

查询流量镜像会话详情的响应体。

取值范围

不涉及。

request_id

String

参数解释

请求ID。

取值范围

不涉及。

表5 TrafficMirrorSession

参数

参数类型

描述

id

String

参数解释

流量镜像会话的资源ID。流量镜像会话创建成功后,会生成一个流量镜像会话 ID,是流量镜像会话对应的唯一标识。

取值范围

不涉及。

project_id

String

参数解释

流量镜像会话所属的项目ID。

取值范围

不涉及。

name

String

参数解释

流量镜像会话的名称。

取值范围

1-64个字符,支持数字、字母、中文、_(下划线)、-(中划线)、.(点)。

description

String

参数解释

流量镜像会话的描述信息。

取值范围

0-255个字符,不能包含“<”和“>”。

traffic_mirror_filter_id

String

参数解释

流量镜像会话关联的筛选条件的ID。

取值范围

不涉及。

traffic_mirror_sources

Array of strings

参数解释

流量镜像会话关联的镜像源的ID列表,支持弹性网卡作为镜像源。

取值范围

一个流量镜像会话默认最大支持10个镜像源。

traffic_mirror_target_id

String

参数解释

流量镜像会话关联的镜像目的ID。

取值范围

不涉及。

traffic_mirror_target_type

String

参数解释

流量镜像会话关联的镜像目的的类型。

取值范围

  • eni:镜像目的类型是弹性网卡。

  • elb:镜像目的类型是私网弹性负载均衡。

virtual_network_id

Integer

参数解释

流量镜像会话的VXLAN网络标识(VNI),用于区分不同会话的镜像流量。

取值范围

0~16777215,默认值是1。

packet_length

Integer

参数解释

流量镜像会话的镜像报文长度。

取值范围

1~1460,默认值是96。

priority

Integer

参数解释

流量镜像会话的优先级。

取值范围

1~32766。

enabled

Boolean

参数解释

是否开启流量镜像会话。

取值范围

  • true:开启流量镜像会话。

  • false:默认值,关闭流量镜像会话。

type

String

参数解释

流量镜像会话的镜像源的类型。

取值范围

  • eni:弹性网卡

  • eip:弹性公网IP

created_at

String

参数解释

流量镜像会话的创建时间。

取值范围

UTC时间格式,yyyy-MM-ddTHH:mm:ssZ。

updated_at

String

参数解释

流量镜像会话的更新时间。

取值范围

UTC时间格式,yyyy-MM-ddTHH:mm:ssZ。

请求示例

移除ID为e15a6e40-2580-4949-bf2a-55ee7cd49392的镜像会话中的镜像源6134900d-31a6-4b71-8453-dbca7f26982a

PUT https://{endpoint}/v3/{project_id}/vpc/traffic-mirror-sessions/e15a6e40-2580-4949-bf2a-55ee7cd49392/remove-sources

{
  "traffic_mirror_session" : {
    "traffic_mirror_sources" : [ "6134900d-31a6-4b71-8453-dbca7f26982a" ]
  }
}

响应示例

状态码:200

OK

{
  "traffic_mirror_session" : {
    "name" : "test-session",
    "created_at" : "2023-02-23T06:57:39.000+00:00",
    "updated_at" : "2023-02-23T06:57:39.000+00:00",
    "id" : "e15a6e40-2580-4949-bf2a-55ee7cd49392",
    "project_id" : "7365fcd452924e398ec4cc1fe39c0d12",
    "description" : "",
    "traffic_mirror_filter_id" : "b765ba87-c0b4-4f1a-9ec3-d5b1d1ddb137",
    "traffic_mirror_sources" : [ ],
    "traffic_mirror_target_id" : "",
    "traffic_mirror_target_type" : "",
    "virtual_network_id" : 1,
    "packet_length" : 96,
    "priority" : 6,
    "enabled" : true,
    "type" : "eni"
  },
  "request_id" : "6f107fc1-93be-4d5a-af71-4099da7eeaa9"
}

状态码

状态码

描述

200

OK

错误码

请参见错误码