API Explorer
API Explorer
Getting Started
Release Notes
Appliance Management
Application Data Management
Asset Management
Asset Metadata
Authentication and Authorization
Cloud Disaster Recovery
Compliance
Copy Management
Credentials Management
Discovery
File Level Restore
Installation
Inventory Source Management
Kubernetes Data Management
Licenses Management
Location Management
Log Management
Monitoring
Protection Policies
Recovery and Reuse Management
Remote Service
Search Clusters
Secrets Manager
Server Disaster Recovery
Storage Management
Telemetry Setting
Upgrade
User Security Management
Virtual Machine Data Management
Whitelist Management

PowerProtect Data Manager (v19.7) REST API changes

Introduction

This section contains information about differences between version 19.6 and 19.7 of the REST API in PowerProtect Data Manager. The changes include:

  • Several new APIs
  • One deprecated API
  • New API specifications (including new property values, new models, and name changes to some models)

These changes are described below.

Summary of API changes

  • The following API is added for canceling the precheck of an upgrade package by the specified ID. You use the API when the upgrade package is stuck in the “PROCESSING” state. When the cancellation is done, it marks the upgrade package state to “PRECHECK_FAILED”.
POST /api/v2/upgrade-packages/{id}/precheck-cancellation
  • The following API is added for canceling an upgrade package by the specified ID. You use the API when the upgrade package is stuck in the “INSTALLED_CORE” state. When the cancellation is done, it marks the upgrade package state to “INSTALLED_WITH_ERRORS”.
POST /api/v2/upgrade-packages/{id}/upgrade-cancellation
  • The following API is added for getting all copy metrics from PowerProtect Data Manager for PowerProtect Central. You use the API to collect copy metrics from PowerProtect Data Manager per asset.
GET /api/v2/copy-metrics
  • The following API is added to replace the deprecated API for manual protection (backup or replication) of assets that are protected by a given protection policy. The deprecated API is: POST /api/v2/protection-policies/{id}/backups.
POST /api/v2/protection-policies/{id}/protections

This use case illustrates how to use this new API: https://developer.dellemc.com/data-protection/powerprotect/data-manager/tutorials/use-cases/manual-backup

  • You can create SLOs for different backup levels by adding an additional field “copyType” to the SLO value list and defining which copy type the SLO validates.

  • The status of the compliance result is changed. A new field is added: verifiedObjectives.status. The compliance result status contains: SUCCEEDED, FAILED, and SKIPPED.

Summary of API specification changes

  • Definition “ResourceRetryActivityResult” is changed to “RetryActivityResult”.
  • Definition “ActivityResource” is changed to “Resource”.
  • Definition “AppServer” is changed to “AppHostAppServer”.
  • Definition “IdRef” is changed to “Id”.
  • Definition “AgentRegistrationStatusWhitelist” is changed to “Whitelist”.