What's New

Platform

Introducing APIs for Reports

We've added APIs for reports in our common reporting framework. Now, as per your requirements, you can quickly get report data.

You can build integrations to obtain specific data for various use cases. For example, you can:

• Track the status of workloads periodically and trigger automated responses using third-party apps or custom scripts. For example, you can create a ticket to inform an administrator if backups fail beyond a certain percentage on a specific day.
• Keep a close eye on critical activities such as failed Restore jobs. This visibility allows you to proactively address any issues that may arise.
• Run narrowed-down diagnostics using filters to provide evidence during audits.
• Build personalized reports or a view to monitor all your data.

With these new APIs, you'll have more flexibility and control over your reporting.

For more information, see Getting Started with Reports API.

Note: With this release, APIs are unavailable for Endpoints’ Storage Status report and HyBrid Workloads’ Credit Consumption report and Cost Allocation report.

Endpoints

Get details of Disabled Devices through APIs

You now get the following details of disabled devices with the help of enhanced List all Devices -v2 and Get Device Information - v2 APIs:

• Date & Time: Provides the timestamp when the device was marked Disabled.
• Disabled Mode: Provides information about the method or mode of the device being marked disabled. For example, the device is disabled through the Admin console.

Customer action: None.
For more information, see disable, enable or delete a user device.

Sensitive Data Governance: Introducing listing APIs

You can now use the following list APIs to create your own custom reports for file and email violations:

• List Data Types: Provides details of all the available data types
• List SDG policy templates: Provides details of all the available SDG policy templates created
• List SDG policies: Provides details of all the configured SDG policies
• List whitelisted keywords: Provides details of all the whitelisted keywords
• List SDG settings: Provides details of all the SDG settings configured
• List file violations: Provides details of all the file violations
• List email violations: Provides details of all the email violations

See Sensitive Data Governance APIs.

Federated Search: Introducing Search APIs

You can now use the following APIs to automate search and view details for the required files and emails using their SHA1 checksum value:

• Search for Files: Search and view details for files.
• Search for Emails: Search and view details of emails.

See Federated Search APIs.

The following APIs are now available:

• List all AD/LDAP Connectors - To list all configured AD/LDAP Connectors in your environment and monitor their status.
• Get admin audit trail retention settings - To get the duration that your Druva Cloud Administrator has configured to retain the Audit Trails.

Restore curated snapshot using API
We have added a new parameter snapshotName to initiate a restore activity​ API that enables you to restore a curated snapshot.

API to Download Authkey (to replace/add new device)

Administrators can now use the Download Authkey API to replace or add a new device. For more information, see Download Authkey API

The following API parameter is available for the Public Cloud:

A new parameter - deletionReason is added to the Delete a user and Delete a device​ APIs to specify the reason for deletion. The reason will be captured in the Admin Audit trail for auditing purposes.

Microsoft 365

Microsoft 365: Introducing Restore APIs

Introducing our new restore APIs, offering seamless functionality to list SharePoint sites, Exchange Online users, OneDrive accounts, and restore points. Effortlessly initiate restores for SharePoint Online, OneDrive, and Exchange Online, ensuring a smooth and efficient data recovery process.

The following is a list of APIs, along with a brief description:

• List All SharePoint Site Collections: Retrieve the list of SharePoint site collections.
• List All SharePoint Site Restore Points: Retrieve the list of restore points for protected SharePoint sites.
• Restore a SharePoint Site: Performs a restore of a SharePoint site to a new or existing site.
• List users based on query filters: Retrieve a filtered list of users based on query filters.
• List All Protected Cloud Apps: Retrieve the list of all protected SaaS Apps.
• List All OneDrive/Exchange Online Restore points: Retrieve the list of OneDrive/Exchange Online restore points.
• Restore a OneDrive Account or Exchange Online Mailbox: Performs a restore for a OneDrive account or an Exchange Online mailbox to a new or existing account.

Customer action required: None.

Enterprise Workloads

File Server

Sort jobs based on schedule time

With the newly added response parameter, scheduleTime, you can now sort the jobs based on the time the job is created or scheduled. This parameter is added to the following File Server APIs:

• List all jobs
• List all backup jobs
• List all restore jobs
• List all upload logs jobs

For more information, see API reference documentation on the Druva developer portal.

NAS

Manage backup and restore jobs using NAS APIs

Druva introduces the following job management APIs:

• On-demand backup
• On-demand restore
• Cancel backup job
• Cancel restore job

Using these APIs, you can create and cancel backup and restore jobs.

NAS

List all snapshots using NAS APIs

You can list all snapshots for a specific backup set by using the List all snapshots API.
For more information, see API reference documentation on the Druva developer portal.

Revamping NAS APIs

The following NAS APIs are undergoing some changes and are temporarily removed. The updated APIs will be published in the upcoming release.

• Cancel a job
• On-demand backup

VMware

Introducing Common Events API for VMware

Druva has introduced a new Events API for VMware. Using this API, you can get a list and view of all the events across the VMware workload. For more information, see API reference documentation on the Druva developer portal.

SQL Server

Restore to alternate location API

You can now restore a SQL database to an alternate location by using the Restore To Alternate Instance Request API. This actionable API can restore an SQL database backup to an alternate instance. For more information, see API reference documentation on the Druva developer portal.

The following APIs are available for Public Cloud and Gov Cloud:

File Server
List all snapshots and perform restore of files/folders to original or alternate server

You can list all snapshots for a specific backup set by using the List all snapshots API. Additionally, you can restore files/folders to the:

• original server by using the Create a restore job for the original server API
• alternate server by using the Create a restore job for the alternate server API

The following APIs are available for Public Cloud:

Nutanix AHV
Introducing APIs for AHV
Druva has introduced reporting APIs for Nutanix AHV. Using these APIs you can integrate tools and applications with Druva for a more customizable experience for reporting, analytics, alerts, and gain insight into the performances of Nutanix AHV virtual machines that Druva protects. For more information, see the Nutanix AHV.

The following API is available for both Public Cloud and Gov Cloud:

MS SQL Servers
Identify a job with a resource identifier
With the newly added response parameter, resourceID, in the List all backup jobs and List all restore jobs APIs, you can now correlate a resourceID with a specific job. For more information, see the List all backup jobs and List all restore jobs APIs on the Druva Developer Portal.

The following APIs are available for both Public Cloud and Gov Cloud:

VMware
List all snapshots and perform full automated restore of a VM using VMware actionable APIs
You can list all snapshots for a specific backup set by using the List all snapshots API. Additionally, you can restore a VM automatically to the original location by using the Full VM restore to original API.
For more information, see List all snapshots API.

MS SQL Servers
Restore a SQL Server database to the original location (with Replace)
Use the Restore To Original Instance API to perform a restore for the given SQL server databases to the original location (with Replace). The following APIs provide additional information to the Restore To Original Instance API.

• The List all snapshots API provides all the snapshots for the specified backup set.
• The Get Backupset Details API returns the complete backup set details of the requested backup sets. You can find the database name using this API.

For more information, see API reference documentation on the Druva developer portal.

The following APIs are available for both Public Cloud and Gov Cloud:

MS SQL Servers
Identify a job with a resource identifier
We are adding resourceID in the response parameter of the List All Jobs APIs. Using this resourceID parameter, you can now correlate the job with the respective resourceID. For more information, see the List all jobs API.

Filter the availability groups based on the availability group identifier
We are adding agID in the request and response parameters of the List All Availability Groups API.Using the agID that is specified, you can now list only the required availability group. If you do not provide an agID, the API returns all availability groups.
For more information, see the List all SQL availability groups API.

The following APIs are available for both Public Cloud and Gov Cloud:

File Servers
You can now use Druva APIs to run on-demand (manual) backups of the specified File Servers and cancel requested File Server jobs.

• On-demand backup API to run manual backups of a specified File Server.
• Cancel a job API to cancel a requested job.

Oracle-DTC
You can list all snapshots for a specific backup set by using the List all snapshots API. Additionally, you can also restore a database automatically to the original server by using the Full database restore to the original API.

Oracle-PBS
Earlier, the API endpoints for the Oracle PBS jobs, such as List all backup jobs, List all restore jobs, and so on, did not have backup set ID and backup set mount names. This made it difficult to correlate the job with the respective backup set.
To fix this, we are now passing the following additional response parameters to the APIs:

• List all backupsets: OrgID, BackupsetID, OracleStoreID
• List all backupstores: OrgID
• List all jobs: OrgID
• List all backup jobs: OrgID, BackupsetID, BackupMountName
• List all restore jobs: OrgID, BackupsetID, BackupMountName
• List all uploadlogs jobs: OrgID

The following APIs are available for both Public Cloud and Gov Cloud:

MS SQL Servers
You can now use Druva APIs to run on-demand (manual) backups of MS SQL Server databases and cancel requested MS SQL Server jobs.

• On-demand backup API to run full, differential, and transaction log backups of MS SQL Server databases.
• Cancel a job API to cancel a requested Backup, Restore, or Upload Log job.

The following APIs are available for both Public Cloud and Gov Cloud:

Oracle DTC
You can now cancel the requested Backup, Restore, or Upload Log job by using the Oracle Cancel job API.

NAS
You can now use the following Druva APIs to run on-demand (manual) backups of a specified NAS device and cancel requested NAS jobs.

• On-demand backup API to run a manual backup of a specified NAS device.
• Cancel a job API to cancel a specific job.

The following APIs are available for both Public Cloud and Gov Cloud.

VMware
You can now use the following Druva APIs to run on-demand (manual) backups of a specified VMware virtual machine and cancel requested VMware jobs.

• On-demand backup API to run a manual backup of a specified virtual machine.
• Cancel a job API to cancel a specific job.

Oracle - DTC
You can now use the On-demand backup API to run on-demand (manual) full, incremental, and archive log backups of Oracle databases.

Disaster Recovery
You can now use the following Druva APIs to automate failover jobs for all virtual machines of a DR Plan:

• List DR Plans API to list the DR Plan details of all configured DR Plans.
• Execute DR Failover jobs API to execute a failover job for all virtual machines in the selected DR Plan.

Cyber Resilience

Changed Service Name from Realize to Cyber Resililence
Aligning with licensing and offering, we have updated the Druva Realize service to Cyber Resilience.

New API for listing count of restore scan jobs

We have added the List count of restore scan jobs API to support automation and get information about the total count of all the restore scan jobs for different resource types- File Server, NAS, Endpoints, and so on.

Managed Service Providers (MSP)

Enhancement

Enhanced user and device filtering for precise monitoring and troubleshooting

We've introduced a new filter, "isDeleted," to our reporting APIs. This enhancement empowers you to fine-tune your monitoring and troubleshooting efforts by filtering reports based on user and device deletion status.

Key Benefits:

• Targeted Analysis: Pinpoint specific user groups for in-depth analysis.

• Efficient Troubleshooting: Quickly isolate issues by filtering out irrelevant data.

Following is the list of Endpoints reports that have this new filter:

• Last Backup Status Report

• User Provisioning Report

• User Rollout Report

By leveraging this new filter, you can gain deeper insights into your environment and make more informed decisions.

Deprecation

Deprecated three reports and their corresponding APIs

We have deprecated three reports and APIs in favor of more powerful reporting. Our previous reports, while valuable in their time, have become redundant and lack the detailed information needed for comprehensive usage analysis. To address this, we've developed improved versions of these reports with richer details, providing a more comprehensive view of your tenant's usage.

Listed below are the deprecated reports with their corresponding APIs

Thereby, subscribe to the new reports and upgrade your automation or monitoring tool with new APIs in the place of deprecated ones. The new reports and their respective APIs are:

Key benefits

• More Detailed Insights: Gain a comprehensive understanding of your tenant's usage patterns.

• Actionable Data: Make informed billing decisions based on actual Druva service and add-on consumption.

• Improved Efficiency: Access all backup job details in one centralized location with the Hybrid Workloads report.

Simplified details in the Customer Level Events API

We've simplified the details field in the API response of Customer Level Events API to provide a more developer-friendly experience. Previously, the details field was returned as a stringified JSON object, requiring consumers to parse it manually. With this update, the details field is now directly returned as a valid JSON object.

Key Changes:

• New Endpoint: https://apis.druva.com/msp/v3/customers/{customerID}/events

• Old Endpoint: https://apis.druva.com/msp/v2/customers/{customerID}/events

Benefits:

• Reduced processing time: Consumers no longer need to perform unnecessary stringification and parsing operations.

• Improved efficiency: Simplifies API integration and reduces potential error points.

Action required: Existing consumers of the Customer Level Events API should start using the new API endpoint to accommodate the new changes.

Streamlined Monitoring and Alerting for MSPs with Event-Driven APIs

Traditionally, monitoring required continuous checks on systems to detect changes. This can be inefficient and lead to information overload. Event-driven monitoring works differently. You can now leverage MSP event APIs to get the details about MSP alerts, audit trails, subscription history, and login activities. You can integrate the responses from these event APIs with your favorite monitoring tools. This unlocks a world of possibilities for customized dashboards, alerts, and even ticket generation.

Key benefits:

• Reduced Noise, Increased Focus: Focus on what matters! Receive alerts only when events occur, eliminating unnecessary notifications and streamlining your workflow.

• Customizable Monitoring: Tailor your monitoring experience to your specific needs. Leverage third-party tools to create custom dashboards, alerts, and even automate ticket generation for faster issue resolution.

• Improved Manageability: Gain a comprehensive view of your entire infrastructure, allowing for proactive problem identification and improved overall manageability.

For more information about events APIs, see MSP-level event APIs.

New APIs for reporting automation and integration are now available for MSPs

MSP Admins can now leverage new APIs to automatically generate reports for Endpoints, Hybrid Workloads, and Cyber Resilience. This eliminates manual report creation, saving you valuable time.

These APIs utilize a single set of MSC credentials, eliminating the need to manage separate credentials for each customer.

The enhanced API response includes customer name, account name, and customer ID, simplifying data integration with your existing tools and removing the need to maintain a separate customer list.

For more information, see

• Hybrid Workloads Reports

• Endpoints Reports

• Cyber Resilience Reports

New Feature
Druva has released a new version - V2 of MSP APIs. V2 APIs come with enhanced APIs that enable the automation of tasks related to Endpoints in addition to Hybrid Workloads & Microsoft 365.

Deprecation
Druva has deprecated V1 of MSP APIs.