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
dgRollbackActionsas 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="
}
| Field | Type | Description |
|---|---|---|
| data | array of objects | The collection of rollback actions. |
| dataSize | integer | The data size. |
| deleteRequestID | string (UUID) | The delete request ID. |
| deletedBy | string | The admin who deleted the entity. |
| deletedDateTime | date-time | The date on which the entity was deleted. The time is in the UTC time zone. Example - 2019-10-25T00:00:00Z |
| deletionReason | string | The reason for which the entity was deleted. |
| entityName | string | The name of the entity. |
| deletedItem | string | Type of deleted entity. |
| entityType | string | The 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) |
| rollbackDateTime | date-time | The date on which the entity was rolled-back. The time is in the UTC time zone. Example - 2019-10-26T00:00:00Z |
| rolledBackBy | string | The admin who rolled-back the entity. |
| status | string | The status of the request. Possible values(Available for rollback, Permanently deleted, Rollback in progress, Rolled back) |
| permanentDeleteTime | date-time | The date on which the entity will be permanently deleted if not rolled-back. Example - 2019-10-28T00:00:00Z |
| lastUpdatedDateTime | date-time | The last updated time stamp. The time is in the UTC time zone. Example - 2019-10-25T00:00:00Z |
| lastSyncTimestamp | date-time | Time stamp until which report data is returned in the API. The time is in the UTC time zone. |
| filters | object | Filters applied on the report. |
| nextPageToken | string | The 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
}
| Field | Type | Description |
|---|---|---|
| code | string | Error code. |
| data | object | Data of the error. |
| message | string | Error message. |
| retryable | boolean | Can 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
dgDataProtectionRiskas 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="
}
| Field | Type | Description |
|---|---|---|
| data | array of objects | The collection of enterprise workload agents' connection statuses with the cloud. |
| organization | string | The name of the organization. |
| workloadAgent | string | The name of the workload. Possible values (Files, Hyper-V, MS-SQL, NAS, Oracle, Oracle-DTC, VMware) |
| connectionStatusToCloud | string | The connection status to the cloud. Example - Possible values (Connected,Disconnected) |
| disconnectedFromCloudSince | date-time | The date since which device is disconnected from cloud. The time is in the UTC time zone. Example - 2019-10-25T00:00:00Z |
| lastUpdatedTime | date-time | The last updated time stamp. The time is in the UTC time zone. Example - 2019-10-25T00:00:00Z |
| vCenterESXiHosts | string | Name of the vCentre or ESXi host where the backup proxy is deployed. |
| connectionStatusToVcenter | string | The connection status to the vCenter. Possible values (Connected,Disconnected) |
| lastSyncTimestamp | string | Time stamp until which report data is returned in the API. The time is in the UTC time zone. |
| filters | object | Filters applied on the report. |
| nextPageToken | string | The 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
}
| Field | Type | Description |
|---|---|---|
| code | string | Error code. |
| data | object | Data of the error. |
| message | string | Error message. |
| retryable | boolean | Can retry the API call (true for yes and false for no.) |
Updated about 1 month ago