GET

/#Action=CreateTrafficMirrorFilterRule

http://ec2.{region}.amazonaws.com/#Action=CreateTrafficMirrorFilterRule

Creates a Traffic Mirror filter rule. A Traffic Mirror rule defines the Traffic Mirror source traffic to mirror. You need the Traffic Mirror filter ID when you create the rule.

Access Token Required: API Key

Query Params

TrafficMirrorFilterIdstringrequired

The ID of the filter that this rule is associated with.

TrafficDirectionstringrequired

The type of traffic.

Allowed:

RuleNumberintegerrequired

The number of the Traffic Mirror rule. This number must be unique for each Traffic Mirror rule in a given direction. The rules are processed in ascending order by rule number.

RuleActionstringrequired

The action to take on the filtered traffic.

Allowed:

DestinationPortRangeobject

The destination port range.

SourcePortRangeobject

The source port range.

Protocolinteger

The protocol, for example UDP, to assign to the Traffic Mirror rule. For information about the protocol value, see <a href="https://www.iana.org/assignments/protocol-numbers/protocol-numbers.xhtml">Protocol Numbers</a> on the Internet Assigned Numbers Authority (IANA) website.

DestinationCidrBlockstringrequired

The destination CIDR block to assign to the Traffic Mirror rule.

SourceCidrBlockstringrequired

The source CIDR block to assign to the Traffic Mirror rule.

Descriptionstring

The description of the Traffic Mirror rule.

DryRunboolean

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 <code>DryRunOperation</code>. Otherwise, it is <code>UnauthorizedOperation</code>.

ClientTokenstring

Unique, case-sensitive identifier that you provide to ensure the idempotency of the request. For more information, see <a href="https://docs.aws.amazon.com/AWSEC2/latest/APIReference/Run_Instance_Idempotency.html">How to ensure idempotency</a>.

Actionstringrequired

Allowed:

Versionstringrequired

Allowed:

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'http://ec2.{region}.amazonaws.com/#Action=CreateTrafficMirrorFilterRule' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}