POST /#Action=ModifyTrafficMirrorSession

Modifies a Traffic Mirror session.

Servers

Request headers

Name Type Required Description
X-Amz-Content-Sha256 String No
X-Amz-Credential String No
Content-Type String Yes The media type of the request body.

Default value: "text/xml"

X-Amz-Date String No
X-Amz-Algorithm String No
X-Amz-SignedHeaders String No
X-Amz-Security-Token String No
X-Amz-Signature String No

Query parameters

Name Type Required Description
Version String Yes

Possible values:

  • "2016-11-15"
Action String Yes

Possible values:

  • "ModifyTrafficMirrorSession"

Request body fields

Name Type Required Description
TrafficMirrorSessionId String Yes

The ID of the Traffic Mirror session.

TrafficMirrorTargetId String No

The Traffic Mirror target. The target must be in the same VPC as the source, or have a VPC peering connection with the source.

TrafficMirrorFilterId String No

The ID of the Traffic Mirror filter.

VirtualNetworkId Integer No

The virtual network ID of the Traffic Mirror session.

PacketLength Integer No

The number of bytes in each packet to mirror. These are bytes after the VXLAN header. To mirror a subset, set this to the length (in bytes) 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. Do not specify this parameter when you want to mirror the entire packet.

DryRun Boolean No

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.

SessionNumber Integer No

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.

Description String No

The description to assign to the Traffic Mirror session.

RemoveFields[] Array No

The properties that you want to remove from the Traffic Mirror session.

When you remove a property from a Traffic Mirror session, the property is set to the default.

How to start integrating

  1. Add HTTP Task to your workflow definition.
  2. Search for the API you want to integrate with and click on the name.
    • This loads the API reference documentation and prepares the Http request settings.
  3. Click Test request to test run your request to the API and see the API's response.