AWS::EC2::TrafficMirrorSession - AWS CloudFormation
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

AWS::EC2::TrafficMirrorSession

创建流量镜像会话。

流量镜像会话主动将数据包从流量镜像源复制到流量镜像目标。创建一个筛选器,然后将它分配给会话以定义要镜像的流量的子集,例如所有 TCP 流量。

流量镜像源和流量镜像目标(监视设备)可以位于同一 VPC 中,也可以位于通过 VPC 对等连接或中转网关连接的其他 VPC 中。

默认情况下,不镜像任何流量。使用 AWS::EC2::TrafficMirrorFilterRule 指定用于指定要镜像的流量的筛选规则。

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

{ "Type" : "AWS::EC2::TrafficMirrorSession", "Properties" : { "Description" : String, "NetworkInterfaceId" : String, "PacketLength" : Integer, "SessionNumber" : Integer, "Tags" : [ Tag, ... ], "TrafficMirrorFilterId" : String, "TrafficMirrorTargetId" : String, "VirtualNetworkId" : Integer } }

YAML

Type: AWS::EC2::TrafficMirrorSession Properties: Description: String NetworkInterfaceId: String PacketLength: Integer SessionNumber: Integer Tags: - Tag TrafficMirrorFilterId: String TrafficMirrorTargetId: String VirtualNetworkId: Integer

属性

Description

流量镜像会话的描述。

必需:否

类型:字符串

Update requires: No interruption

NetworkInterfaceId

源网络接口的 ID。

必需:是

类型:字符串

Update requires: Replacement

PacketLength

要镜像的每个数据包中的字节数。这些是 VXLAN 标头之后的字节。在需要镜像整个数据包时,请不要指定此参数。要镜像数据包的子集,请将其设置为要镜像的长度(以字节为单位)。例如,如果将此值设置为 100,则将满足筛选条件的前 100 个字节复制到目标。

如果您不想镜像整个数据包,请使用 PacketLength 参数指定要镜像的每个数据包中的字节数。

必需:否

类型:整数

Update requires: No interruption

SessionNumber

会话编号将确定在多个会话使用一个接口时评估会话的顺序。具有匹配筛选器的第一个会话是镜像数据包的会话。

有效值为 1-32766。

必需:是

类型:整数

Update requires: No interruption

Tags

要分配给流量镜像会话的标签。

必需:否

类型Tag 的列表

Update requires: No interruption

TrafficMirrorFilterId

流量镜像筛选器的 ID。

必需:是

类型:字符串

Update requires: No interruption

TrafficMirrorTargetId

流量镜像目标的 ID。

必需:是

类型:字符串

Update requires: No interruption

VirtualNetworkId

流量镜像会话的 VXLAN ID。有关 VXLAN 协议的更多信息,请参阅 RFC 7348。如果未指定 VirtualNetworkId,则会随机选择账户范围内的唯一 ID。

必需:否

类型:整数

Update requires: No interruption

返回值

Ref

在将此资源的逻辑 ID 传递给内部 Ref 函数时,Ref 返回流量镜像会话的 ID。

For more information about using the Ref function, see Ref.

示例

创建流量镜像会话

这是一个流量镜像会话,该会话将镜像每个数据包中的前 100 个字节。

JSON

{ "SampleTrafficMirrorSession": { "Type": "AWS::EC2::TrafficMirrorSession", "Properties": { "Description": "Example traffic mirror session", "NetworkInterfaceId": "eni-070203a001EXAMPLE", "TrafficMirrorTargetId": "tmt-5319fsEXAMPLE", "TrafficMirrorFilterId": "tmf-1tdbhqEXAMPLE", "SessionNumber": 1, "PacketLength": 100, "VirtualNetworkId": 1234, "Tags": [ { "Key": "Name", "Value": "SampleSession" } ] } } }

YAML

SampleTrafficMirrorSession: Type: "AWS::EC2::TrafficMirrorSession" Properties: Description: "Example traffic mirror session" NetworkInterfaceId: "eni-070203a001EXAMPLE" TrafficMirrorTargetId: "tmt-5319fsEXAMPLE" TrafficMirrorFilterId: "tmf-1tdbhqEXAMPLE" SessionNumber: 1 PacketLength: 100 VirtualNetworkId: 1234 Tags: - Key: "Name" Value: "SampleSession"

另请参阅