Help Center/ Virtual Private Cloud/ API Reference/ API V3/ Traffic Mirror Filter Rules/ Querying Details About a Traffic Mirror Filter Rule
Updated on 2024-10-11 GMT+08:00

Querying Details About a Traffic Mirror Filter Rule

Function

This API is used to query details about a traffic mirror filter rule.

Debugging

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

URI

GET /v3/{project_id}/vpc/traffic-mirror-filter-rules/{traffic_mirror_filter_rule_id}

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.

traffic_mirror_filter_rule_id

Yes

String

Traffic mirror filter rule ID.

Request Parameters

None

Response Parameters

Status code: 200

Table 2 Response body parameters

Parameter

Type

Description

traffic_mirror_filter_rule

TrafficMirrorFilterRule object

Traffic mirror filter rule.

request_id

String

Request ID.

Table 3 TrafficMirrorFilterRule

Parameter

Type

Description

id

String

Traffic mirror filter rule ID.

project_id

String

Project ID.

description

String

Description of a traffic mirror filter rule.

The value can contain no more than 255 characters and cannot contain angle brackets (< or >).

traffic_mirror_filter_id

String

Traffic mirror filter ID.

direction

String

Traffic direction.

The value can be ingress or egress.

source_cidr_block

String

Source CIDR block of the mirrored traffic.

destination_cidr_block

String

Destination CIDR block of the mirrored traffic.

source_port_range

String

Source port range.

Value range: 1-65535

Format: 80-200

destination_port_range

String

Destination port range.

Value range: 1-65535

Format: 80-200

ethertype

String

IP address version of the mirrored traffic.

The value can be IPv4 or IPv6.

protocol

String

Protocol of the mirrored traffic.

The value can be TCP, UDP, ICMP, ICMPV6, or ALL.

action

String

Whether to accept or reject traffic.

The value can be accept or reject.

priority

Integer

Mirror filter rule priority.

Value range: 1-65535.

A smaller value indicates a higher priority.

created_at

String

Time when a traffic mirror filter rule is created.

updated_at

String

Time when a traffic mirror filter rule is updated.

Example Requests

Querying details about a traffic mirror filter rule.

GET http://{endpoint}/v3/{project_id}/vpc/traffic-mirror-filter-rules/2230d5a2-1868-4264-b917-0e06fa132898

Example Responses

Status code: 200

OK

{
  "traffic_mirror_filter_rule" : {
    "created_at" : "2023-02-23T16:08:45.000+00:00",
    "updated_at" : "2023-02-23T16:17:12.000+00:00",
    "id" : "2230d5a2-1868-4264-b917-0e06fa132898",
    "project_id" : "7365fcd452924e398ec4cc1fe39c0d12",
    "description" : 123,
    "traffic_mirror_filter_id" : "417d7317-6c17-4428-a0f3-997d3e2293a0",
    "direction" : "ingress",
    "protocol" : "TCP",
    "ethertype" : "IPv4",
    "source_cidr_block" : "8.8.8.8/32",
    "destination_cidr_block" : "9.9.9.9/32",
    "destination_port_range" : "10-65535",
    "action" : "accept",
    "priority" : 20
  },
  "request_id" : "ca9682cf-0680-469f-bb04-5b0f17b075d0"
}

Status Codes

Status Code

Description

200

OK

Error Codes

See Error Codes.