创建流量镜像会话
更新时间：2025-03-26
描述
创建流量镜像会话。
请求结构
Plain Text
1POST /v{version}/traffic/mirror/session?clientToken={clientToken} HTTP/1.1
2Host: nds.bj.baidubce.com
3Authorization: authorization string
4{
5 "name":{name},
6 "description":{description},
7 "sourceType":{sourceType},
8 "sourceId":{sourceId},
9 "sourceRootId":{sourceRootId},
10 "destType":{destType},
11 "destId":{destId},
12 "trafficMirrorRuleGroupId":{trafficMirrorRuleGroupId},
13 "vni":{vni},
14 "packetLength":{packetLength}
15}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值为1 |
| clientToken | String | 否 | Query参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串 |
| name | String | 是 | RequestBody参数 | 流量镜像会话的名称，限制：大小写字母、数字，中文以及-_/.特殊字符，必须以字母、中文开头，长度1-65 |
| description | String | 否 | RequestBody参数 | 流量镜像会话的描述，长度1-200 |
| sourceType | String | 是 | RequestBody参数 | 流量镜像会话源类型，取值： eip：弹性公网IP nat：增强型nat网关 peerconn：对等连接 dcgw：专线网关 csn：云智能网 |
| sourceId | String | 是 | RequestBody参数 | 流量镜像会话源实例ID，取值： 1、sourceType为eip时，sourceId为公网IP地址； 2、sourceType为nat时，sourceId为nat实例Id； 3、sourceType为peerconn时，sourceId为对等连接本端接口ID； 4、sourceType为dcgw时，sourceId为专线网关实例ID； 5、sourceType为csn时，sourceId为云智能网绑定的VPC实例ID； |
| sourceRootId | String | 否 | RequestBody参数 | 流量镜像会话源所属实例ID，仅当sourceType为peerconn或csn时必填，取值： 1、sourceType为peerconn时，sourceRootId为对等连接实例ID； 2、sourceType为csn时，sourceRootId为云智能网实例ID |
| destType | String | 是 | RequestBody参数 | 流量镜像会话目的类型，目前仅支持取值“blb” |
| destId | String | 是 | RequestBody参数 | 流量镜像会话目的实例ID |
| trafficMirrorRuleGroupId | String | 是 | RequestBody参数 | 筛选条件ID |
| vni | Integer | 否 | RequestBody参数 | 指定VNI（VXLAN Network Identifier）来区分不同的镜像流量，取值范围1~16777215；如果未指定，将随机分配VNI |
| packetLength | Integer | 否 | RequestBody参数 | 数据包长度，镜像的每个数据包中的字节数，取值范围100~1500；如果未指定，将镜像整个数据包 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| trafficMirrorSessionId | String | 流量镜像会话实例ID |
请求示例
Plain Text
1POST /v1/traffic/mirror/session?clientToken=1849ef6b-f73c-4f5d-b88b-259ca47af849 HTTP/1.1
2Host: nds.bj.baidubce.com
3Authorization: bce-auth-v1/c3119080364d11e8912505e5e0ae9978/2018-04-02T08:14:25Z/3600/host;x-bce-account;x-bce-client-ip;x-bce-date;x-bce-request-id;x-bce-security-token/6b93bfd5ca2328fcb5560fa57f56253d80a629f6aac9c9cb74adf9a055fceb53
4{
5 "name": "natMirror",
6 "description": "this is a description",
7 "sourceType": "nat",
8 "sourceId": "nat-bixwkjf484hm",
9 "destType": "blb",
10 "destId": "lb-5feebdf7",
11 "trafficMirrorRuleGroupId": "rg-unzyuaviqnxc",
12 "vni": 1,
13 "packetLength": 300
14}返回示例
Plain Text
1HTTP/1.1 200 OK
2x-bce-request-id: 7e789a40-adac-414a-8bd4-916d6be61112
3Date: Mon, 02 Apr 2019 08:14:25 GMT
4Content-Type: application/json;charset=UTF-8
5Server: BWS
6{
7 "trafficMirrorSessionId":"ms-8fjs5xw46qw4"
8}