Skip to content

Alerts History Scroll.

GET
/api/data/namespaces/{namespace}/alerts/history/scroll
curl --request GET \
--url https://example-corp.console.ves.volterra.io/api/v1/api/production/us-east-1/namespaces/default/api/data/namespaces/example/alerts/history/scroll \
--header 'Authorization: <Authorization>'

Scroll request is used to fetch large number of alert messages in multiple batches with each AlertsHistoryResponse containing no more than 500 alerts. To scroll through more than 500 or all alert messages, one can use the AlertsHistoryScrollRequest. Use the scroll_id returned in the AlertsHistoryResponse to fetch the next batch of alert messages and one can continue this process till the scroll_id returned in the AlertsHistoryResponse is "" which indicates no more alert messages to scroll.

Examples of this operation.

namespace
required
string

Namespace fetch the alerts scoped by namespace.

scroll_id
string

Long Base-64 encoded string which can be used to retrieve next batch of alert messages.

A successful response.

Media typeapplication/json
Alerts History Response

Response message for AlertsHistoryRequest/AlertsHistoryScrollRequest.

object
alerts
alerts

List of alerts that matched the filter. Contains no more than 500 alerts per response.

Array<string>
scroll_id
scroll_id

Long Base-64 encoded string which can be used to retrieve next batch of alert messages using the scroll request. Empty scroll_id indicates no more messages to scroll (EOF). Note: scroll_id is valid only for 2 minutes. I.e., If one intend to retrieve next batch of the result, then the scroll request should be sent within 2 minutes upon receiving the response.

string
<= 1024 characters
total_hits
total hits

Total number of alerts that matched the query.

string format: uint64
<= 1024 characters
Examplegenerated
{
"alerts": [
"example"
],
"scroll_id": "example",
"total_hits": "example"
}

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