Query Events for Pagination Support (v3.6)
POST/v3.6/api/tenants/:tenant_id/events/query
Query events for supporting pagination.
Request
Path Parameters
The tenant ID.
- application/json
Body
Event offset time and date information.
If event is acknowledged. Value = True/False.
The destination page.
Possible values: [HUB
, SPOKE
, NONE
]
The element cluster values.
The event end time.
limit object
Possible values: [ascending
, descending
]
Possible values: [p1
, p2
, p3
, p4
]
The event priority.
query object
The query details of event category, code, correlation ID, entitity reference, site, and type.
Possible values: [critical
, major
, minor
]
The event severity level.
The event start time.
If the event is suppressed. Value = True/False.
suppressed_info object
Information on the suppressed event - event ID, suppressed time, summary event IDs etc.
Possible values: [include_standing
, standing_only
]
Temporal scope of the event.
Possible values: [raised
, created
]
The event time type.
view object
The event viewing details.
Possible values: [site
, code
, category
, entity
, correlation
, tenant
]
Responses
- 200
- 400
Successful Operation
- application/json
- Schema
- Example (from schema)
Schema
- Array [
- ]
The event query request ID.
The status code of the event.
The destination page.
The event included count.
items object[]
The details of the event query.
acknowledgement_info object
Possible values: [HUB
, SPOKE
, NONE
]
policy_info object
suppressed_info object
The event query total count.
{
"_request_id": "string",
"_status_code": 0,
"dest_page": 0,
"included_count": 0,
"items": [
{
"_created_on_utc": "2024-07-29T15:51:28.071Z",
"_etag": "string",
"_updated_on_utc": "2024-07-29T15:51:28.071Z",
"acknowledged": true,
"acknowledgement_info": {
"acknowledged_by": "string",
"acknowledgement_time": "2024-07-29T15:51:28.071Z"
},
"cleared": true,
"code": "string",
"correlation_id": "string",
"element_cluster_roles": [
"HUB"
],
"entity_ref": "string",
"id": "string",
"ident": "string",
"info": {},
"policy_info": {
"policyrule_id": "string",
"policyset_id": "string"
},
"priority": "string",
"severity": "string",
"standing": true,
"suppressed": true,
"suppressed_info": {
"event_id": "string",
"other_reason": "string",
"suppressed_time": "2024-07-29T15:51:28.071Z"
},
"time": "2024-07-29T15:51:28.071Z",
"type": "string"
}
],
"total_count": 0
}
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": "INVALID_REQUEST_ERROR_0001"
}
]
}
}