Creating a Traffic Mirror Session

Function

This API is used to create a traffic mirror session.

Debugging

You can debug this API through automatic authentication in API Explorer.

URI

POST /v3/{project_id}/vpc/traffic-mirror-sessions

**Table 1** Path Parameters
Parameter	Mandatory	Type	Description
project_id	Yes	String	Project ID. For details about how to obtain a project ID, see Obtaining a Project ID.

Request Parameters

**Table 2** Request body parameters
Parameter	Mandatory	Type	Description
traffic_mirror_session	Yes	CreateTrafficMirrorSessionOption object	Traffic mirror session.

**Table 3** CreateTrafficMirrorSessionOption
Parameter	Mandatory	Type	Description
name	Yes	String	Traffic mirror session name. The value can contain 1 to 64 characters, including letters, digits, underscores (_), hyphens (-), and periods (.).
description	No	String	Description of a traffic mirror session. The value can contain no more than 255 characters and cannot contain angle brackets (< or >).
traffic_mirror_filter_id	Yes	String	Traffic mirror filter ID.
traffic_mirror_sources	Yes	Array of strings	Mirror source IDs. An elastic network interface can be used as a mirror source. Each mirror session can have up to 10 mirror sources by default.
traffic_mirror_target_id	Yes	String	Mirror target ID.
traffic_mirror_target_type	Yes	String	Mirror target type. The value can be eni (elastic network interface) or elb (private network load balancer).
virtual_network_id	No	String	VNI, which is used to distinguish mirrored traffic of different sessions. Value range: 0-16777215 Default value: 1
packet_length	No	String	Maximum transmission unit (MTU). Value range: 1-1460 Default value: 96
priority	Yes	Integer	Mirror session priority. Value range: 1-32766
enabled	No	String	Whether to enable a mirror session. The value can be true or false. Default value: false
type	No	String	Supported mirror source type. The value can be: eni: elastic network interface. eip: elastic IP.

Response Parameters

Status code: 201

**Table 4** Response body parameters
Parameter	Type	Description
traffic_mirror_session	TrafficMirrorSession object	Traffic mirror session.
request_id	String	Request ID.

**Table 5** TrafficMirrorSession
Parameter	Type	Description
id	String	Traffic mirror session ID.
project_id	String	Project ID.
name	String	Traffic mirror session name. The value can contain 1 to 64 characters, including letters, digits, underscores (_), hyphens (-), and periods (.).
description	String	Description of a traffic mirror session. The value can contain no more than 255 characters and cannot contain angle brackets (< or >).
traffic_mirror_filter_id	String	Traffic mirror filter ID.
traffic_mirror_sources	Array of strings	Mirror source IDs. An elastic network interface can be used as a mirror source. Each mirror session can have up to 10 mirror sources by default.
traffic_mirror_target_id	String	Mirror target ID.
traffic_mirror_target_type	String	Mirror target type. The value can be eni (elastic network interface) or elb (private network load balancer).
virtual_network_id	Integer	VNI, which is used to distinguish mirrored traffic of different sessions. Value range: 0-16777215. Default value: 1
packet_length	Integer	Maximum transmission unit (MTU). Value range: 1-1460 Default value: 96
priority	Integer	Mirror session priority. Value range: 1-32766
enabled	Boolean	Whether to enable a mirror session. The value can be true or false. Default value: false
type	String	Supported mirror source type. The value can be eni (elastic network interface).
created_at	String	Time when a traffic mirror session is created.
updated_at	String	Time when a traffic mirror session is updated.

Example Requests

Create a traffic mirror session named test-session.

POST http://{endpoint}/v3/{project_id}/vpc/traffic-mirror-sessions

{
  "traffic_mirror_session" : {
    "name" : "test-session",
    "traffic_mirror_filter_id" : "b765ba87-c0b4-4f1a-9ec3-d5b1d1ddb137",
    "traffic_mirror_sources" : [ "6134900d-31a6-4b71-8453-dbca7f26982a" ],
    "traffic_mirror_target_id" : "c9f8acef-d550-4fbe-be7c-e8bfd3501dc1",
    "traffic_mirror_target_type" : "eni",
    "priority" : 11
  }
}

Example Responses

Status code: 201

Created

{
  "traffic_mirror_session" : {
    "name" : "test-session",
    "created_at" : "2023-03-23T10:53:12.000+00:00",
    "updated_at" : "2023-03-23T10:53:12.000+00:00",
    "id" : "16538eda-7e94-4b90-b5f3-a653f62dc817",
    "project_id" : "7365fcd452924e398ec4cc1fe39c0d12",
    "description" : "",
    "traffic_mirror_filter_id" : "b765ba87-c0b4-4f1a-9ec3-d5b1d1ddb137",
    "traffic_mirror_sources" : [ "6134900d-31a6-4b71-8453-dbca7f26982a" ],
    "traffic_mirror_target_id" : "c9f8acef-d550-4fbe-be7c-e8bfd3501dc1",
    "traffic_mirror_target_type" : "eni",
    "virtual_network_id" : 1,
    "packet_length" : 96,
    "priority" : 11,
    "enabled" : true,
    "type" : "eni"
  },
  "request_id" : "9a880225-1d2f-461e-8d8e-1866bfda77db"
}