NAME

Paws::EC2::CreateTrafficMirrorSession - Arguments for method CreateTrafficMirrorSession on Paws::EC2

DESCRIPTION

This class represents the parameters used for calling the method CreateTrafficMirrorSession on the Amazon Elastic Compute Cloud service. Use the attributes of this class as arguments to method CreateTrafficMirrorSession.

You shouldn't make instances of this class. Each attribute should be used as a named argument in the call to CreateTrafficMirrorSession.

SYNOPSIS

my $ec2 = Paws->service('EC2');
my $CreateTrafficMirrorSessionResult = $ec2->CreateTrafficMirrorSession(
  NetworkInterfaceId    => 'MyNetworkInterfaceId',
  SessionNumber         => 1,
  TrafficMirrorFilterId => 'MyTrafficMirrorFilterId',
  TrafficMirrorTargetId => 'MyTrafficMirrorTargetId',
  ClientToken           => 'MyString',                  # OPTIONAL
  Description           => 'MyString',                  # OPTIONAL
  DryRun                => 1,                           # OPTIONAL
  PacketLength          => 1,                           # OPTIONAL
  TagSpecifications     => [
    {
      ResourceType => 'client-vpn-endpoint'
      , # values: client-vpn-endpoint, customer-gateway, dedicated-host, dhcp-options, egress-only-internet-gateway, elastic-ip, elastic-gpu, export-image-task, export-instance-task, fleet, fpga-image, host-reservation, image, import-image-task, import-snapshot-task, instance, internet-gateway, key-pair, launch-template, local-gateway-route-table-vpc-association, natgateway, network-acl, network-interface, network-insights-analysis, network-insights-path, placement-group, reserved-instances, route-table, security-group, snapshot, spot-fleet-request, spot-instances-request, subnet, traffic-mirror-filter, traffic-mirror-session, traffic-mirror-target, transit-gateway, transit-gateway-attachment, transit-gateway-connect-peer, transit-gateway-multicast-domain, transit-gateway-route-table, volume, vpc, vpc-peering-connection, vpn-connection, vpn-gateway, vpc-flow-log; OPTIONAL
      Tags => [
        {
          Key   => 'MyString',
          Value => 'MyString',
        },
        ...
      ],    # OPTIONAL
    },
    ...
  ],    # OPTIONAL
  VirtualNetworkId => 1,    # OPTIONAL
);

# Results:
my $ClientToken = $CreateTrafficMirrorSessionResult->ClientToken;
my $TrafficMirrorSession =
  $CreateTrafficMirrorSessionResult->TrafficMirrorSession;

# Returns a L<Paws::EC2::CreateTrafficMirrorSessionResult> object.

Values for attributes that are native types (Int, String, Float, etc) can passed as-is (scalar values). Values for complex Types (objects) can be passed as a HashRef. The keys and values of the hashref will be used to instance the underlying object. For the AWS API documentation, see https://docs.aws.amazon.com/goto/WebAPI/ec2/CreateTrafficMirrorSession

ATTRIBUTES

ClientToken => Str

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see How to Ensure Idempotency (https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html).

Description => Str

The description of the Traffic Mirror session.

DryRun => Bool

Checks whether you have the required permissions for the action, without actually making the request, and provides an error response. If you have the required permissions, the error response is DryRunOperation. Otherwise, it is UnauthorizedOperation.

REQUIRED NetworkInterfaceId => Str

The ID of the source network interface.

PacketLength => Int

The number of bytes in each packet to mirror. These are bytes after the VXLAN header. Do not specify this parameter when you want to mirror the entire packet. To mirror a subset of the packet, set this to the length (in bytes) that you want to mirror. For example, if you set this value to 100, then the first 100 bytes that meet the filter criteria are copied to the target.

If you do not want to mirror the entire packet, use the PacketLength parameter to specify the number of bytes in each packet to mirror.

REQUIRED SessionNumber => Int

The session number determines the order in which sessions are evaluated when an interface is used by multiple sessions. The first session with a matching filter is the one that mirrors the packets.

Valid values are 1-32766.

TagSpecifications => ArrayRef[Paws::EC2::TagSpecification]

The tags to assign to a Traffic Mirror session.

REQUIRED TrafficMirrorFilterId => Str

The ID of the Traffic Mirror filter.

REQUIRED TrafficMirrorTargetId => Str

The ID of the Traffic Mirror target.

VirtualNetworkId => Int

The VXLAN ID for the Traffic Mirror session. For more information about the VXLAN protocol, see RFC 7348 (https://tools.ietf.org/html/rfc7348). If you do not specify a VirtualNetworkId, an account-wide unique id is chosen at random.

SEE ALSO

This class forms part of Paws, documenting arguments for method CreateTrafficMirrorSession in Paws::EC2

BUGS and CONTRIBUTIONS

The source code is located here: https://github.com/pplu/aws-sdk-perl

Please report bugs to: https://github.com/pplu/aws-sdk-perl/issues