Get cyber resilience reports

The reports that indicate presence of security threats in your environment.

View rollback actions report

This report provides a consolidated and point-in-time view of your protected entities that were deleted within a specified date range.

URL

https://apis.druva.com/platform/reporting/v1/reports/dgRollbackActions

Request type

HTTP POST

Sample cURL request

curl --request POST \
     --url https://apis.druva.com/platform/reporting/v1/reports/dgRollbackActions \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "filters": {
    "pageSize": 100,
    "filterBy": [
      {
        "fieldName": "deleteRequestID",
        "operator": "EQUAL",
        "value": "string"
      }
    ]
  },
  "pageToken": ""
}
'

To try this API endpoint, see Reports API reference.

πŸ“˜

Note

On the API reference page, select dgRollbackActions as the report ID under path params to test this endpoint.

Sample responses

{
  "data": [
    {
      "dataSize": 20,
      "deleteRequestID": "11ef158d-929c-4841-ab83-0ca4179c1420",
      "deletedBy": "rollbackTest rollbackTest",
      "deletedDateTime": "2023-04-26T10:53:52.000Z",
      "deletionReason": "Automation testing - deletion for workload Teams",
      "entityName": "entity-1",
      "deletedItem": "Snapshot",
      "entityType": "SharePoint",
      "rollbackDateTime": "2023-04-26T10:57:51.000Z",
      "rolledBackBy": "rollbackTest rollbackTest",
      "status": "Rolled back",
      "permanentDeleteTime": "2023-04-28T10:57:51.000Z",
      "lastUpdatedDateTime": "2023-04-26T11:00:56.000Z"
    }
  ],
  "lastSyncTimestamp": "2024-03-26T15:32:09.788Z",
  "filters": {},
  "nextPageToken": "YTBDNDk6Rjk1MmViY1FpTVpBejNFTU9lSWxzUT09OjA="
}
FieldTypeDescription
dataarray of objectsThe collection of rollback actions.
dataSizeintegerThe data size.
deleteRequestIDstring (UUID)The delete request ID.
deletedBystringThe admin who deleted the entity.
deletedDateTimedate-timeThe date on which the entity was deleted. The time is in the UTC time zone. Example - 2019-10-25T00:00:00Z
deletionReasonstringThe reason for which the entity was deleted.
entityNamestringThe name of the entity.
deletedItemstringType of deleted entity.
entityTypestringThe type of entity. (Endpoints, Exchange Online,File Servers,Google Drive,Google Mail,Groups,NAS,One Drive,Profiles,Public Folders,SharePoint,Shared Drives,Teams,Users, VMware)
rollbackDateTimedate-timeThe date on which the entity was rolled-back. The time is in the UTC time zone. Example - 2019-10-26T00:00:00Z
rolledBackBystringThe admin who rolled-back the entity.
statusstringThe status of the request. Possible values(Available for rollback, Permanently deleted, Rollback in progress, Rolled back)
permanentDeleteTimedate-timeThe date on which the entity will be permanently deleted if not rolled-back. Example - 2019-10-28T00:00:00Z
lastUpdatedDateTimedate-timeThe last updated time stamp. The time is in the UTC time zone. Example - 2019-10-25T00:00:00Z
lastSyncTimestampdate-timeTime stamp until which report data is returned in the API. The time is in the UTC time zone.
filtersobjectFilters applied on the report.
nextPageTokenstringThe token to access the next page of results. This parameter will be empty for the last page of the results. This token is valid for 5 minutes.

{
  "code": "string",
  "data": {
    "additionalProp": {}
  },
  "message": "string",
  "retryable": true
}
FieldTypeDescription
codestringError code.
dataobjectData of the error.
messagestringError message.
retryablebooleanCan retry the API call (true for yes and false for no.)

View data protection risk report

This report provides a consolidated view of the connection status of the enterprise workload agents with Druva.

Endpoint URL

https://apis.druva.com/platform/reporting/v1/reports/dgDataProtectionRisk

Request type

HTTP POST

Sample cURL request

curl --request POST \
     --url https://apis.druva.com/platform/reporting/v1/reports/dgDataProtectionRisk \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "filters": {
    "pageSize": 100,
    "filterBy": [
      {
        "fieldName": "workloadName",
        "operator": "EQUAL",
        "value": "string"
      }
    ]
  },
  "pageToken": ""
}
'

To try this API endpoint, see Reports API reference.

πŸ“˜

Note

On the API reference page, select dgDataProtectionRisk as the report ID under path params to test this endpoint.

Sample responses

{
  "data": [
    {
      "organization": "custom-org",
      "workloadName": "Files",
      "workloadAgent": "device123",
      "connectionStatusToCloud": "Disconnected",
      "disconnectedFromCloudSince": "2024-03-26T15:32:09.788Z",
      "lastUpdatedTime": "2023-04-28T10:57:51.000Z",
      "vCenterESXiHosts": "centerhost123",
      "connectionStatusToVCenter": "Disconnected"
    }
  ],
  "lastSyncTimestamp": "2024-03-26T15:32:09.788Z",
  "filters": {},
  "nextPageToken": "YTBDNDk6Rjk1MmViY1FpTVpBejNFTU9lSWxzUT09OjA="
}
FieldTypeDescription
dataarray of objectsThe collection of enterprise workload agents' connection statuses with the cloud.
organizationstringThe name of the organization.
workloadAgentstringThe name of the workload. Possible values (Files, Hyper-V, MS-SQL, NAS, Oracle, Oracle-DTC, VMware)
connectionStatusToCloudstringThe connection status to the cloud. Example - Possible values (Connected,Disconnected)
disconnectedFromCloudSincedate-timeThe date since which device is disconnected from cloud. The time is in the UTC time zone. Example - 2019-10-25T00:00:00Z
lastUpdatedTimedate-timeThe last updated time stamp. The time is in the UTC time zone. Example - 2019-10-25T00:00:00Z
vCenterESXiHostsstringName of the vCentre or ESXi host where the backup proxy is deployed.
connectionStatusToVcenterstringThe connection status to the vCenter. Possible values (Connected,Disconnected)
lastSyncTimestampstringTime stamp until which report data is returned in the API. The time is in the UTC time zone.
filtersobjectFilters applied on the report.
nextPageTokenstringThe token to access the next page of results. This parameter will be empty for the last page of the results. This token is valid for 5 minutes.

{
  "code": "string",
  "data": {
    "additionalProp": {}
  },
  "message": "string",
  "retryable": true
}
FieldTypeDescription
codestringError code.
dataobjectData of the error.
messagestringError message.
retryablebooleanCan retry the API call (true for yes and false for no.)