Skip to content

L3l4 Top talkers Query.

POST
/api/infraprotect/namespaces/{namespace}/graph/l3l4/top_talkers/{network_id}
curl --request POST \
--url https://example-corp.console.ves.volterra.io/api/v1/api/production/us-east-1/namespaces/default/api/infraprotect/namespaces/example/graph/l3l4/top_talkers/example \
--header 'Authorization: <Authorization>' \
--header 'Content-Type: application/json' \
--data '{ "end_time": "2026-04-15T12:00:00Z", "namespace": "example", "network_id": "example", "start_time": "2026-04-15T12:00:00Z", "traffic_type": "TrafficTypeUnknown", "traffic_unit": "TrafficUnitUnknown" }'

Request to GET l3l4 Top talkers Traffic data.

Examples of this operation.

namespace
required
string

Namespace This request is supported only in system namespace.

network_id
required
string

NetworkId The network ID.

Media typeapplication/json
l3l4 TopTalkers Request

Used to display Top Talkers for a network.

object
end_time
End time

End time of metric collection from which data will be considered to build graph.

Optional: If not specified, then the end_time will be evaluated to

string format: date-time
<= 1024 characters
namespace
Namespace

This request is supported only in system namespace.

string
>= 6 characters <= 1024 characters
network_id
NetworkId

The network ID.

string
<= 1024 characters
start_time
Start time

Start time of metric collection from which data will be considered to build graph. Format: unix_timestamp|RFC 3339

Optional: If not specified, then the start_time will be evaluated to -3d.

string format: date-time
<= 1024 characters
traffic_type
string
default: TrafficTypeUnknown
Allowed values: TrafficTypeUnknown TrafficTypeExternal TrafficTypeInternal
traffic_unit
string
default: TrafficUnitUnknown
Allowed values: TrafficUnitUnknown TrafficUnitBps TrafficUnitPps

A successful response.

Media typeapplication/json
l3l4 TopTalkers Response

Response for Top Talkers.

object
data
Top Talkers list

List of data.

Array<object>
object
in
In

Traffic In for this talker.

string format: int64
<= 1024 characters
ip
IP

IP address.

string
<= 1024 characters
out
Out

Traffic Out for this talker.

string format: int64
<= 1024 characters
traffic_unit
string
default: TrafficUnitUnknown
Allowed values: TrafficUnitUnknown TrafficUnitBps TrafficUnitPps
Example
{
"traffic_unit": "TrafficUnitUnknown"
}

Returned when operation is not authorized.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when there is no permission to access resource.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when resource is not found.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when operation on resource is conflicting with current value.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when operation has been rejected as it is happening too frequently.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when server encountered an error in processing API.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when service is unavailable temporarily.

Media typeapplication/json
string format: string
Examplegenerated
example

Returned when server timed out processing request.

Media typeapplication/json
string format: string
Examplegenerated
example