Query SIte Correlation Events (v2.0)
POST/v2.0/api/tenants/:tenant_id/sites/correlationevents/query
Query site correlation events.
Request
Path Parameters
ID of the tenant.
- application/json
Body
- Array [
- ]
aggregate Aggregate
The aggregate number of sites that match the query parameters.
data AggregateData[]
The details of the aggregate data.
Value of the aggregate data.
View the aggregate date.
Field
The name of the query response.
Possible values: [max
, count
, min
, avg
, sum
]
Operator
QoS application aggregate statistics.
The unit.
The destination page.
The number sites deleted for a time frame.
Group By
List the sites by ID.
Return the ID of a specified query in the current session.
The query limit.
The limit.
Retrieve information from a field.
List the fields to query.
The total number of query parameters.
Responses
- 200
- 400
Successful Operation
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- Array [
- ]
- ]
The actual count.
The deleted number.
The deleted IDs.
Description of the query. Max size = 256.
The ID.
Details of the next query.
The tenant ID.
Total number.
items SiteQueryFilter[]
address Address
The address of the site.
The name of the city. Max size = 100.
The name of the country. Max size = 100.
The postal code. Max size = 100.
The name of the state. Max size = 100.
The name of the street. Max size = 100.
The name of the street. Max size = 100.
The site mode of operation, can be in one of three states: Active - the site is in Control mode and network policy is applied. Monitor - the site is in Analytics mode, no network policy is applied. Disabled: the site is disabled.
Description for the site (Max size = 1024).
This attribute describes the type i.e. SPOKE or HUB.
events BaseEventState[]
Events
The event code.
The event ID.
Id
The priority set for the event.
The standing event. True or False.
The events are suppressed. True or False.
suppressed_info SuppressedInfo
The information on the suppressed events.
The event IDs of the root causes.
The suppressed event time.
The time stamp of the event.
The ID.
location Location
The geographical cordinates for the site address.
The decsription of the location.
The latitude of the location. Max range = 90.
The longitude of the location. Max range = 180.
The site name (Max size = 128).
The ID for the Original Network Policy Set. Can be retrieved using policysets API.
The ID for the Original Security Policy Set. Can be retrieved using securitypolicysets API.
Bind a site to a set of domains. Can be retrieved using sericebindingmaps API.
{
"count": 0,
"deleted_count": 0,
"deleted_ids": [
"string"
],
"id": "string",
"next_query": {},
"tenant_id": "string",
"total_count": 0,
"items": [
{
"address": {
"city": "string",
"country": "string",
"post_code": "string",
"state": "string",
"street": "string",
"street2": "string"
},
"admin_state": "string",
"element_cluster_role": "string",
"events": [
{
"event_code": "string",
"event_id": "string",
"id": "string",
"priority": 0,
"standing": true,
"suppressed": true,
"suppressed_info": {
"root_cause_event_ids": [
"string"
],
"suppressed_time": "2024-07-29"
},
"timestamp": 0
}
],
"id": "string",
"location": {
"latitude": 0,
"longitude": 0
},
"name": "string",
"policy_set_id": "string",
"security_policyset_id": "string",
"service_binding": "string"
}
]
}
Bad Request
- application/json
- Schema
- Example (from schema)
- Example
Schema
- Array [
- ]
_error ErrorResponse[]
The error code.
The error message.
{
"_error": [
{
"code": "string",
"message": "string"
}
]
}
{
"value": {
"_error": [
{
"code": "BAD_QUERY_REQUEST"
}
]
}
}