Get Flow Information (v3.4)
List all the flow information.
- application/json
Request Body
Filter for flows
- debug_level string required
Possible values: [
summary
,tcp-flags
,traffic
,all
]The values of the debug levels.
- end_time date required
The end time to get the flows information.
filter FlowsFilter required
Filters according to the specifications.
app string[] requiredApp
element string[] requiredElement
flow FlowTupple required
Flow
destination_ip string[] requiredDestination Ip
destination_port integer[] requiredDestination Port
protocol integer requiredProtocol
source_ip string[] requiredSource Ip
source_port integer[] requiredSource Port
flow_type string requiredPossible values: [
local
,wan
,all
]Flow Type
path string[] requiredPath
path_type string[] requiredPossible values: [
public_direct
,public_vpn
,private_direct
,private_vpn
,unknown
,servicelink
]Path Type
security_policy_destination_zone string[] requiredSecurity Policy Destination Zone
security_policy_rule string[] requiredSecurity Policy Rule
security_policy_rule_action string requiredPossible values: [
allow
,deny
,reject
]Security Policy Rule Action
security_policy_source_zone string[] requiredSecurity Policy Source Zone
site string[] requiredSite
waninterface string[] requiredWaninterface
- max_datapoints integer required
The max data points.
- name string required
The description of the flow. Maz size = 128.
- start_time date required
The start time to get the flow information.
- 200
- 400
- 500
Successful Operation
- application/json
- Schema
- Example (from schema)
Schema
flows Flows required
Flows
debug_level string requiredDebug Level
end_time string requiredEnd Time
items FlowDetails[] required
Items
Array [app_id string requiredApp Id
average_ntt float requiredAverage Ntt: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
average_pg float requiredAverage Pg: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
average_rtt float requiredAverage Rtt: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
average_srt float requiredAverage Srt: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
average_udp_trt float requiredAverage Udp Trt: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
avg_jitter_c2s float requiredAvg Jitter C2s: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
avg_jitter_s2c float requiredAvg Jitter S2c: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
avg_mos_c2s float requiredAvg Mos C2s: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
avg_mos_s2c float requiredAvg Mos S2c: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
avg_packet_loss_c2s float requiredAvg Packet Loss C2s: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
avg_packet_loss_s2c float requiredAvg Packet Loss S2c: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
bytes_c2s int64 requiredBytes C2s
bytes_s2c int64 requiredBytes S2c
codec_c2s int64[] requiredCodec C2s: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
codec_s2c int64[] requiredCodec S2c: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
destination_ip string requiredDestination Ip
destination_lan_network_id string requiredDestination Lan Network Id
destination_lan_vlan_id integer requiredDestination Lan Vlan Id
destination_port integer requiredDestination Port
element_id string requiredElement Id
fc_app_id string requiredFc App Id
fin_c2s int64 requiredFin C2s
fin_s2c int64 requiredFin S2c
flow_action string requiredFlow Action
flow_decision_metadata_list FlowDecisionMetadata[] required
Flow Decision Metadata List
Array [available_wan_networks string[] requiredAvailable Wan Networks: JsonAlias(value = [bw_paths]) JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
chosen_wan_path string requiredChosen Wan Path: JsonAlias(value = [path_id])
flow_decision_bitmap int64[] requiredFlow Decision Bitmap: JsonAlias(value = [bitmap]) JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
flow_decision_time int64 requiredFlow Decision Time: JsonAlias(value = [time])
policy_allowed_wan_paths string[] requiredPolicy Allowed Wan Paths: JsonAlias(value = [policy_paths]) JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
predictive_wan_network_normalized_load string[] requiredPredictive Wan Network Normalized Load: JsonAlias(value = [bw_values]) JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
preferred_wan_path string requiredPreferred Wan Path: JsonAlias(value = [pref_wan_path]) JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
sla_filtered_state_up_policy_allowed_wan_paths string[] requiredSla Filtered State Up Policy Allowed Wan Paths: JsonAlias(value = [policy_l2l3_sla_paths]) JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
state_up_policy_allowed_wan_paths string[] requiredState Up Policy Allowed Wan Paths: JsonAlias(value = [policy_l2l3_paths]) JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
]flow_end_time_ms int64 requiredFlow End Time Ms
flow_start_time_ms int64 requiredFlow Start Time Ms
incomplete_trans int64 requiredIncomplete Trans: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
init_success boolean requiredInit Success: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
is_local_traffic boolean requiredIs Local Traffic
is_sec_policy_present boolean requiredIs Sec Policy Present
lan_dscp_lan_to_wan integer[] requiredLan Dscp Lan To Wan: JsonDeserialize(as = classOf[Void], builder = classOf[Void], contentAs = classOf[Void], contentConverter = classOf[Converter$None], contentUsing = classOf[JsonDeserializer$None], converter = classOf[Converter$None], keyAs = classOf[Void], keyUsing = classOf[KeyDeserializer$None], using = classOf[CustomGetSetPositionsDeserializer])
lan_dscp_wan_to_lan integer[] requiredLan Dscp Wan To Lan: JsonDeserialize(as = classOf[Void], builder = classOf[Void], contentAs = classOf[Void], contentConverter = classOf[Converter$None], contentUsing = classOf[JsonDeserializer$None], converter = classOf[Converter$None], keyAs = classOf[Void], keyUsing = classOf[KeyDeserializer$None], using = classOf[CustomGetSetPositionsDeserializer])
lan_origination_id string requiredLan Origination Id
lan_termination_id string requiredLan Termination Id
lan_to_wan boolean requiredLan To Wan
max_jitter_c2s float requiredMax Jitter C2s: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
max_jitter_s2c float requiredMax Jitter S2c: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
max_mos_c2s float requiredMax Mos C2s: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
max_mos_s2c float requiredMax Mos S2c: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
max_ntt float requiredMax Ntt: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
max_packet_loss_c2s float requiredMax Packet Loss C2s: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
max_packet_loss_s2c float requiredMax Packet Loss S2c: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
max_pg float requiredMax Pg: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
max_rtt float requiredMax Rtt: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
max_srt float requiredMax Srt: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
max_udp_trt float requiredMax Udp Trt: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
media_type string requiredMedia Type: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
min_mos_c2s float requiredMin Mos C2s: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
min_mos_s2c float requiredMin Mos S2c: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
min_ntt float requiredMin Ntt: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
min_pg float requiredMin Pg: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
min_rtt float requiredMin Rtt: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
min_srt float requiredMin Srt: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
min_udp_trt float requiredMin Udp Trt: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
network_policy_dst_prefix_id string requiredNetwork Policy Dst Prefix Id
network_policy_id string requiredNetwork Policy Id
network_policy_nctx_id string requiredNetwork Policy Nctx Id
network_policy_set_id string requiredNetwork Policy Set Id
network_policy_src_prefix_id string requiredNetwork Policy Src Prefix Id
network_policy_stack_id string requiredNetwork Policy Stack Id
new_flow boolean requiredNew Flow
ooo_pkts_c2s int64 requiredOoo Pkts C2s
ooo_pkts_s2c int64 requiredOoo Pkts S2c
packets_c2s int64 requiredPackets C2s
packets_s2c int64 requiredPackets S2c
path_id string requiredPath Id
path_type string requiredPath Type
policy_id string requiredPolicy Id
priority_class integer requiredPriority Class: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
priority_policy_default_rule_mapping_incoming_dscp int64 requiredPriority Policy Default Rule Mapping Incoming Dscp
priority_policy_dst_prefix_id string requiredPriority Policy Dst Prefix Id
priority_policy_id string requiredPriority Policy Id
priority_policy_nctx_id string requiredPriority Policy Nctx Id
priority_policy_remark_dscp int64 requiredPriority Policy Remark Dscp
priority_policy_set_id string requiredPriority Policy Set Id
priority_policy_src_prefix_id string requiredPriority Policy Src Prefix Id
priority_policy_stack_id string requiredPriority Policy Stack Id
protocol integer requiredProtocol
reset_c2s int64 requiredReset C2s
reset_s2c int64 requiredReset S2c
retransmit_bytes_c2s int64 requiredRetransmit Bytes C2s
retransmit_bytes_s2c int64 requiredRetransmit Bytes S2c
retransmit_pkts_c2s int64 requiredRetransmit Pkts C2s
retransmit_pkts_s2c int64 requiredRetransmit Pkts S2c
sack_pkts_c2s int64 requiredSack Pkts C2s
sack_pkts_s2c int64 requiredSack Pkts S2c
sec_fc_app_id string[] requiredSec Fc App Id
security_policy_rules SecurityPolicyRules[] required
Security Policy Rules: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = NON_EMPTY, valueFilter = classOf[Void])
Array [bytes_c2s int64 requiredbytes_s2c int64 requiredpackets_c2s int64 requiredpackets_s2c int64 requiredsecurity_destination_zone_id string requiredSecurity Destination Zone Id: JsonAlias(value = [dst_zone_id])
security_policy_rule_action string requiredSecurity Policy Rule Action: JsonAlias(value = [action])
security_policy_rule_id string requiredSecurity Policy Rule Id: JsonAlias(value = [rule_id])
security_source_zone_id string requiredSecurity Source Zone Id: JsonAlias(value = [src_zone_id])
time int64 requiredTime
]service_endpoint_id string requiredService Endpoint Id: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
source_ip string requiredSource Ip
source_lan_network_id string requiredSource Lan Network Id
source_lan_vlan_id integer requiredSource Lan Vlan Id
source_port integer requiredSource Port
success_transactions int64 requiredSuccess Transactions: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
syn_c2s int64 requiredSyn C2s
syn_s2c int64 requiredSyn S2c
traffic_type string requiredTraffic Type: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
unknown_domain string requiredUnknown Domain
unknown_reason string requiredUnknown Reason
vlan_id integer requiredVlan Id
wan_path_change_reason string requiredWan Path Change Reason: JsonInclude(content = ALWAYS, contentFilter = classOf[Void], value = ALWAYS, valueFilter = classOf[Void])
waninterface_id string requiredWaninterface Id
win_scaler_c2s int64 requiredWin Scaler C2s
win_scaler_s2c int64 requiredWin Scaler S2c
win_size_c2s int64 requiredWin Size C2s
win_size_s2c int64 requiredWin Size S2c
]start_time string requiredStart Time
{
"flows": {
"debug_level": "string",
"end_time": "string",
"items": [
{
"app_id": "string",
"average_ntt": 0,
"average_pg": 0,
"average_rtt": 0,
"average_srt": 0,
"average_udp_trt": 0,
"avg_jitter_c2s": 0,
"avg_jitter_s2c": 0,
"avg_mos_c2s": 0,
"avg_mos_s2c": 0,
"avg_packet_loss_c2s": 0,
"avg_packet_loss_s2c": 0,
"bytes_c2s": 0,
"bytes_s2c": 0,
"codec_c2s": [
0
],
"codec_s2c": [
0
],
"destination_ip": "string",
"destination_lan_network_id": "string",
"destination_lan_vlan_id": 0,
"destination_port": 0,
"element_id": "string",
"fc_app_id": "string",
"fin_c2s": 0,
"fin_s2c": 0,
"flow_action": "string",
"flow_decision_metadata_list": [
{
"available_wan_networks": [
"string"
],
"chosen_wan_path": "string",
"flow_decision_bitmap": [
0
],
"flow_decision_time": 0,
"policy_allowed_wan_paths": [
"string"
],
"predictive_wan_network_normalized_load": [
"string"
],
"preferred_wan_path": "string",
"sla_filtered_state_up_policy_allowed_wan_paths": [
"string"
],
"state_up_policy_allowed_wan_paths": [
"string"
]
}
],
"flow_end_time_ms": 0,
"flow_start_time_ms": 0,
"incomplete_trans": 0,
"init_success": true,
"is_local_traffic": true,
"is_sec_policy_present": true,
"lan_dscp_lan_to_wan": [
0
],
"lan_dscp_wan_to_lan": [
0
],
"lan_origination_id": "string",
"lan_termination_id": "string",
"lan_to_wan": true,
"max_jitter_c2s": 0,
"max_jitter_s2c": 0,
"max_mos_c2s": 0,
"max_mos_s2c": 0,
"max_ntt": 0,
"max_packet_loss_c2s": 0,
"max_packet_loss_s2c": 0,
"max_pg": 0,
"max_rtt": 0,
"max_srt": 0,
"max_udp_trt": 0,
"media_type": "string",
"min_mos_c2s": 0,
"min_mos_s2c": 0,
"min_ntt": 0,
"min_pg": 0,
"min_rtt": 0,
"min_srt": 0,
"min_udp_trt": 0,
"network_policy_dst_prefix_id": "string",
"network_policy_id": "string",
"network_policy_nctx_id": "string",
"network_policy_set_id": "string",
"network_policy_src_prefix_id": "string",
"network_policy_stack_id": "string",
"new_flow": true,
"ooo_pkts_c2s": 0,
"ooo_pkts_s2c": 0,
"packets_c2s": 0,
"packets_s2c": 0,
"path_id": "string",
"path_type": "string",
"policy_id": "string",
"priority_class": 0,
"priority_policy_default_rule_mapping_incoming_dscp": 0,
"priority_policy_dst_prefix_id": "string",
"priority_policy_id": "string",
"priority_policy_nctx_id": "string",
"priority_policy_remark_dscp": 0,
"priority_policy_set_id": "string",
"priority_policy_src_prefix_id": "string",
"priority_policy_stack_id": "string",
"protocol": 0,
"reset_c2s": 0,
"reset_s2c": 0,
"retransmit_bytes_c2s": 0,
"retransmit_bytes_s2c": 0,
"retransmit_pkts_c2s": 0,
"retransmit_pkts_s2c": 0,
"sack_pkts_c2s": 0,
"sack_pkts_s2c": 0,
"sec_fc_app_id": [
"string"
],
"security_policy_rules": [
{
"bytes_c2s": 0,
"bytes_s2c": 0,
"packets_c2s": 0,
"packets_s2c": 0,
"security_destination_zone_id": "string",
"security_policy_rule_action": "string",
"security_policy_rule_id": "string",
"security_source_zone_id": "string",
"time": 0
}
],
"service_endpoint_id": "string",
"source_ip": "string",
"source_lan_network_id": "string",
"source_lan_vlan_id": 0,
"source_port": 0,
"success_transactions": 0,
"syn_c2s": 0,
"syn_s2c": 0,
"traffic_type": "string",
"unknown_domain": "string",
"unknown_reason": "string",
"vlan_id": 0,
"wan_path_change_reason": "string",
"waninterface_id": "string",
"win_scaler_c2s": 0,
"win_scaler_s2c": 0,
"win_size_c2s": 0,
"win_size_s2c": 0
}
],
"start_time": "string"
}
}
Bad Request
- application/json
- Schema
- Example (from schema)
- Example
Schema
_error ErrorResponse[]
Array [code stringmessage string]
{
"_error": [
{
"code": "string",
"message": "string"
}
]
}
{
"value": {
"_error": [
{
"code": "EMPTY_REQ_BODY"
},
{
"code": "SCHEMA_MISMATCH"
},
{
"code": "START_TIME_GREATER_THAN_END_TIME"
},
{
"code": "INVALID_REQUEST_ERROR_0001"
},
{
"code": "EMPTY_FILTER"
},
{
"code": "PATH_AND_PATH_TYPE_NOT_SUPPORTED"
},
{
"code": "SITE_WITH_PATH_MISSING"
},
{
"code": "SITE_WITH_WANINTERFACE_MISSING"
},
{
"code": "SITE_WITH_ELEMENT_MISSING"
},
{
"code": "SITE_WITH_FLOW_TUPLE_MISSING"
},
{
"code": "INVALID_IP"
},
{
"code": "INVALID_FLOW_TYPE"
}
]
}
}
Internal Server Error
- application/json
- Schema
- Example (from schema)
Schema
_error ErrorResponse[]
Array [code stringmessage string]
{
"_error": [
{
"code": "string",
"message": "string"
}
]
}