​

ves-io-schema-infraprotect-CustomAlertAPI-ListAlerts

Published April 5, 2023 | Last modified October 28, 2026

Examples of performing infraprotect CustomAlertAPI ListAlerts

Usecase:

List all alerts

Request:

Request using vesctl:

vesctl request rpc infraprotect.CustomAlertAPI.ListAlerts -i request.yaml --uri /public/namespaces/system/infraprotect/alerts --http-method POST

where file request.yaml has following contents:

namespace: system

vesctl yaml response:

alerts:
- bandwidth: "123456"
  endTime: "2026-09-28T05:25:26.369742Z"
  events:
  - attachments: []
    creator: SOC
    endTime: "2026-09-28T05:25:26.369742Z"
    id: "123"
    ip: 192.168.0.1/31
    name: mainnet_1234_2022
    startTime: "2026-09-28T04:25:26.369742Z"
  id: "123"
  ip: 192.168.0.1/31
  startTime: "2026-09-28T04:25:26.369742Z"
  type: DDoS Host Alert
- bandwidth: "987654"
  endTime: "2026-09-28T03:25:26.369742Z"
  events:
  - attachments: []
    creator: AutoMitigation
    endTime: "2026-09-28T03:25:26.369742Z"
    id: "456"
    ip: 10.0.0.0/24
    name: network_attack_2022
    startTime: "2026-09-28T02:25:26.369742Z"
  id: "456"
  ip: 10.0.0.0/24
  startTime: "2026-09-28T02:25:26.369742Z"
  type: DDoS Network Alert

Request using curl:

curl -X 'POST' -d '{"namespace":"system"}' -H 'Content-Type: application/json' -H 'X-Volterra-Useragent: v1/pgm=_var_folders_q2_3kp8z3zs0x5_m7pk1bgb0_ph0000gp_T_go-build3348201650_b001_apidocs.test/host=MTY6VVHQPH/svc=S:examplesvc/site=mytestce01' 'https://acmecorp.console.ves.volterra.io/api/infraprotect/namespaces/system/infraprotect/alerts'

curl response:

HTTP/1.1 200 OK
Content-Type: application/json
Date: Mon, 28 Sep 2026 04:25:26 GMT
Vary: Accept-Encoding


{
  "alerts": [
    {
      "id": "123",
      "ip": "192.168.0.1/31",
      "start_time": "2026-09-28T04:25:26.369742Z",
      "end_time": "2026-09-28T05:25:26.369742Z",
      "bandwidth": "123456",
      "type": "DDoS Host Alert",
      "events": [
        {
          "id": "123",
          "name": "mainnet_1234_2022",
          "creator": "SOC",
          "ip": "192.168.0.1/31",
          "start_time": "2026-09-28T04:25:26.369742Z",
          "end_time": "2026-09-28T05:25:26.369742Z",
          "has_details": false,
          "network_id": "",
          "mitigation_id": "",
          "description": "",
          "attachments": [
          ],
          "has_attachment": false
        }
      ],
      "arbor_id": "",
      "creator": "",
      "network_id": "",
      "source_type": "ALERT_SOURCE_TYPE_UNKNOWN"
    },
    {
      "id": "456",
      "ip": "10.0.0.0/24",
      "start_time": "2026-09-28T02:25:26.369742Z",
      "end_time": "2026-09-28T03:25:26.369742Z",
      "bandwidth": "987654",
      "type": "DDoS Network Alert",
      "events": [
        {
          "id": "456",
          "name": "network_attack_2022",
          "creator": "AutoMitigation",
          "ip": "10.0.0.0/24",
          "start_time": "2026-09-28T02:25:26.369742Z",
          "end_time": "2026-09-28T03:25:26.369742Z",
          "has_details": false,
          "network_id": "",
          "mitigation_id": "",
          "description": "",
          "attachments": [
          ],
          "has_attachment": false
        }
      ],
      "arbor_id": "",
      "creator": "",
      "network_id": "",
      "source_type": "ALERT_SOURCE_TYPE_UNKNOWN"
    }
  ]
}
On this page: