Query DB for IPFIX Configs (v2.0)
Queries the DB for limit number of IPFIX configs that match the query parameters.
- application/json
Request Body
aggregate Aggregate
The aggregate number of IPFIX configs that match the query parameters.
field stringThe field value.
operator stringPossible values: [
max
,count
,min
,avg
,sum
]The operator values.
- dest_page int32
The destination page.
- getDeleted boolean
The number IPFIX configs deleted for a time frame.
- group_by string[]
Group the IPFIX configs for the query.
- id string
List the IPFIX configs by ID.
- last_query_ts int64
Return the ID of a specified query in the current session.
- limit int32
The query limit.
- next_query object
The limit.
- query_params object
- retrieved_fields string[]
Retrieve information from a field.
- retrieved_fields_mask boolean
List the fields to query.
- sort_params object
- total_count int64
The total number of query parameters.
- 200
Successful Operation
- application/json
- Schema
- Example (from schema)
Schema
- count int32
The count of the query list.
- deleted_count int64
The deleted number of queries.
- deleted_ids string[]
The deleted query IDs.
- description
Description of the query. Max size = 256.
- id string
The ID.
- next_query object
Details of the next query.
- total_count int64
Total number of queries.
items IPFixConfigQueryFilter[]
Array [collector_config CollectorConfig[]
Collectors define the third-party applications which consume the exported flow records. Maximum 4 collectors can be configured.
Array [host stringThe IPv4 address or the FQDN Schema (domain name) of the IPFIX collector.
host_port int32The port number that matches the port on which the collector is configured to receive IPFIX records.
ipfixcollectorcontext_id stringThe ID of the IPFIX collector context. The device uses the IP address of the interface to which the collector context is bound as the source interface to export IPFIX flow records.
max_message_size int32Max Message Size
protocol stringPossible values: [
tcp
,udp
]The protocol type of the collector's config.
]descriptionThe description of the collector configuration.
element_id stringThe element ID.
export_cache_timeout integerExport Cache Timeout specifies the time for which the ION device should cache a new flow record before exporting it. Value must be within 10 and 600 seconds.The default value is 30 seconds.
filters IPFixFilter[]
The filters configured to select a subset of flows from all the observed flows to export to a collector. Maximum of 8 filters per IPFIX profile.
Array [app_def_ids string[]The IDs of the applications that filter flow records.
dst_ports Port[]
The destination port ranges, if applicable, for TCP and UDP protocols.
Array [end stringThe end port range must be between 1 and 65535.
start stringThe start port range must be between 1 and 65535.
]dst_prefixes_id stringThe destination prefix ID.
ipfixfiltercontext_ids string[]The ID of the IPFIX filter context that maps to an interface on the ION device.
priority_traffic_types string[]Possible values: [
P1_Video
,P1_Audio
,P1_Xact
,P1_Bulk
,P2_Video
,P2_Audio
,P2_Xact
,P2_Bulk
,P3_Video
,P3_Audio
,P3_Xact
,P3_Bulk
,P4_Video
,P4_Audio
,P4_Xact
,P4_Bulk
]The types of priority traffic for the IPFIX config.
protocols string[]Possible values: [
tcp
,udp
,ospf
,ipv6
,is-is-over-ipv4
,ipv6-nonxt
,etherip
,ipv6-icmp
,igmp
,udplite
,ipv6-opts
,icmp
,esp
,crtp
,ipip
,eigrp
,egp
,gre
,l2tpv3
,sctp
,ip-in-ip
,rsvp
,pim
,scps
,mpls-in-ip
,ah
,vrrp
,ipv6-route
,igp
,ipv6-frag
]The possible protocols types for the IPFIX config.
rtp_transport_type stringPossible values: [
audio
,video
]The value of the RTP transport identifier is Prisma SD-WAN specific and is identified from the flow.
src_ports Port[]
The source port for the flow.
Array [end stringThe end port range must be between 1 and 65535.
start stringThe start port range must be between 1 and 65535.
]src_prefixes_id stringThe source prefix IDs.
wan_path_direction stringPossible values: [
lan_to_wan
,wan_to_lan
]The diection of the WAN path.
]id stringThe ID of the collector configuration.
ipfixprofile_id string requiredThe IPFIX configuration profile ID.
ipfixtemplate_id stringThe IPFIX template ID.
name string requiredThe IPFIX profile name.
sampler IPFixSampler
Subset of flows to export from all the observed flows. The device forwards this subset to the filtering process to perform further selection if filters are configured.
algorithm stringPossible values: [
time_based
,none
]A time-based algorithm to configure the duration for sampling.
time_interval integerThe length of the sampling interval during which flows are selected. The default value is 5 ms.
time_spacing integerThe spacing between the end of one sampling interval and the start of the next sampling interval. The default value is 5 ms.
site_id string requiredThe site ID.
tags string[]A information field that can be added to identify the IPFIX config. Maximum 10 unique tags of length 1024 each are allowed.
]
{
"count": 0,
"deleted_count": 0,
"deleted_ids": [
"string"
],
"id": "string",
"next_query": {},
"total_count": 0,
"items": [
{
"collector_config": [
{
"host": "string",
"host_port": 0,
"ipfixcollectorcontext_id": "string",
"max_message_size": 0,
"protocol": "tcp"
}
],
"element_id": "string",
"export_cache_timeout": 0,
"filters": [
{
"app_def_ids": [
"string"
],
"dst_ports": [
{
"end": "string",
"start": "string"
}
],
"dst_prefixes_id": "string",
"ipfixfiltercontext_ids": [
"string"
],
"priority_traffic_types": [
"P1_Video"
],
"protocols": [
"tcp"
],
"rtp_transport_type": "audio",
"src_ports": [
{
"end": "string",
"start": "string"
}
],
"src_prefixes_id": "string",
"wan_path_direction": "lan_to_wan"
}
],
"id": "string",
"ipfixprofile_id": "string",
"ipfixtemplate_id": "string",
"name": "string",
"sampler": {
"algorithm": "time_based",
"time_interval": 0,
"time_spacing": 0
},
"site_id": "string",
"tags": [
"string"
]
}
]
}