Sign in

v1

latestOpenAPI 3.1.02026-07-245531,0212.1 MB
Events

List all customer level events

Returns the list of all events generated at a customer level.

  • Recommended polling frequency per customer - only once in 30 minutes.
get/msp/v3/customers/{customerID}/events

Path parameters

customerIDstring required

Specify the unique ID of the customer. Get the ID of the customer using the 'List all customers' API.

Query parameters

pageSizeinteger

Specify the number of records you wish to receive in a single API response. The maximum allowed value is 500. Example - 30.

pageTokenstring

The token to access the next page of results. Use the token value received in the previous response's parameter 'nextPageToken'. Keep this field blank in the first request.

category'EVENT' | 'AUDIT' | 'ALERT'

Specify the category of events to be included in response.

typestring

Specify the type of events to be included in response. For all valid values of event types, please refer to : <a href="https://developer.druva.com/docs/events-api-for-msps#supported-druva-workloads">Supported Druva Workloads</a>. New type of events will be added in the list with time.

syslogSeverityinteger

Specify the syslogSeverity of events to be included in response. Specify the severity code as follows:

For Emergency use 0

For Alert (action must be taken immediately) use 1

For Critical (critical conditions) use 2

For Error (error conditions) use 3

For Warning (warning conditions) use 4

For Notice (normal but significant condition) use 5

For Informational (informational messages) use 6

For Debug (debug-level messages) use 7

Headers

Authorizationstring required

Specify the Bearer access token

Response

Ok

nextPageTokenstring

The token to access the next page of results. Use the received token value in subsequent request's parameter 'pageToken'.

Example response

{
  "events": [
    {
      "category": "EVENT",
      "customerName": "sampleCustomerName",
      "details": {
        "jobID": 46501,
        "orgID": 8290,
        "vmName": "WC-OPENDNS",
        "jobType": "backup",
        "message": "backup job triggered",
        "orgName": "Default Organization",
        "vcenter": "wc-vcenter.edu",
        "initiator": "System",
        "hypervisor": "",
        "resourceID": 1824522,
        "workloadID": "Vmware",
        "description": "backup job is triggered for vm WC-OPENDNS and job id is 46501",
        "productName": "Hybrid Workload",
        "backupPolicy": "VM Image",
        "workloadName": "VMware",
        "jobCreateTime": "2024-07-03T00:00:23Z",
        "jobTriggerSource": "System",
        "administrativeGroupID": 17210,
        "administrativeGroupName": "WCDC"
      },
      "feature": "Job",
      "globalID": "4a89ebfa-e1f5-4305-8a2f-ae4766be77c8",
      "timeStamp": "2022-05-03T23:28:01.631Z",
      "syslogFacility": 1,
      "syslogSeverity": 6,
      "type": "JobTriggered"
    }
  ],
  "nextPageToken": "eyJwYWdlTnVtYmVyIjoyLCJwYWdlU2l6ZSI6NTAwLCAiZmlsdGVycyI6bnVsbH0="
}