Veritas NetBackup™ Release Notes

You can find documentation for the NetBackup APIs in these locations:

• On your master server

  APIs are stored in YAML files on the master server:

  https://<master_server>/api-docs/index.html

  The APIs are documented in Swagger format. This format lets you review the code and test the functionality by making actual calls with the APIs. You must have the appropriate security permissions to access the master server and APIs to use the Swagger APIs.

  Caution:

  Veritas recommends that you test APIs only in a development environment. Because you can make actual API calls from the Swagger files, you should not test the APIs in a production environment.

• On SORT

  NetBackup API documentation is also available on SORT:

  HOME > KNOWLEDGE BASE > Documents > Product Version > 8.3

  Look under API Reference. A Getting Started document provides background information about using NetBackup APIs. The API YAML files are also available for reference, however, they are not functional. You cannot test the APIs from the documents on SORT.

NetBackup 8.3 includes these new and enhanced APIs:

• Access Control: Provides access to NetBackup role-based access control configuration.

• Asset Service: Provides access to NetBackup asset information.

• Cloud Buckets: Create and list cloud buckets for MSDP storage servers.

• Cloud Files & Folders Recovery: Recovers individual files and folders from cloud virtual machines.

• Cloud Recovery Targets: Lists the targets to which cloud assets can be recovered.

• Credential Management: Provides management of credentials used by NetBackup.

• Data Classifications: List data classifications defined in the system.

• Disk Volumes: Update disk volumes.

• Disk Volume Replication Targets: Provides ability to configuration replication targets for disk volumes.

• Event Log: Provides an insight of the activities and issues in the NetBackup environment. Also allows custom notifications with easy integration using event log messages and notifications APIs.

• Hosts: List hosts that are pending certificate renewal.

• Identity Providers: Manage identity provider configurations for single sign-on based authentication using SAML.

• Key Management Services: Provides access to key management service configuration.

• Media Servers: List media servers.

• NetBackup Certificate Authorities: Provides access to NetBackup certificate authority configuration.

• Policies: Make a copy of an existing policy and list unique clients associated with policies.

• Recovery Point Service: Query information on data that has been backed up based on workload.

• Security Domains: Manage AD/LDAP domains with Veritas NetBackup Authentication Service (AT).

• Snapshot Management Servers: Provides access to snapshot management server configuration.

• SQL Server Instant Access: Provides the Instant Acess capabilities for SQL Server backups.

• SQL Server Restore: Restore SQL Server from a single recovery point or a complete chain.

• SSO Login: Log in to the NetBackup web UI using single sign-on (SSO) authentication method.

• Trust Versions: List the trust versions based on NetBackup certificate authority migration.

• Trusted Master Servers: Provides access to trusted master server configuration.

• Universal Shares: Manage universal share storage on an MSDP storage server.

The following APIs have been deprecated in NetBackup 8.3.

• Asset DB: The Asset DB APIs have been superseded by the Asset Service APIs.

• Role-Based Access Control: The APIs in the /rbac sub-context have been superseded by the /access-control sub-context. Any RBAC configuration data created using the APIs defined in the /rbac sub-context is now read-only. This data remains available to help create similar access control using the new APIs found in the /access-control sub-context.

The following APIs have been versioned in NetBackup 8.3. The previous version of these APIs is still supported if you specify the correct version.

• GET /admin/jobs

  The PolicyType enum was updated to be UPPERCASE_WITH_UNDERSCORES.

• GET /admin/jobs/{jobId}

  The PolicyType enum was updated to be UPPERCASE_WITH_UNDERSCORES.

• POST /config/{workloadType}/access-hosts

  Error code and response changed to 500 "client hostname could not be found", instead of a generic exception when an invalid access host is provided and cannot be validated.

• GET /config/policies

  Now returns more information than just each policy's name and has default pagination if called without pagination parameters.

• POST /recovery/workloads/{workload}/scenarios/{scenarioType}/pre-recovery-check

  Introduced 404 in pre-recovery check. This error is returned if an invalid vmserver is provided in the request.

• GET /security/auditlogs

  Now supports pagination, filtering, and sorting. This API now returns the audit details object.

• GET /security/auditlogs/{auditId}

  This API now returns the audit details object.

• GET /security/cacert

  Now returns the latest trust-version along with the list of certificate authorities that need to be added or removed from the trust-store of the NetBackup host.

• GET /security/logindetails

  Now supports pagination, filtering, and sorting. This API now returns the audit login details object.

• GET /security/logindetails/{auditId}

  This API now returns the audit login details object.

• GET /storage/disk-pools

  No longer returns attributes related to size for CLOUD disk pools. Changed filter parameters from case insensitive to case sensitive.

• POST /storage/disk-pools

  No longer accepts kmsKeyPassphrase which was required for CLOUD disk pool.

• POST /storage/storage-servers

  Removed KMS attributes from input.

• POST /storage/storage-servers/{storageServerId}/disk-volumes

  Now supports creation of cloud disk volumes for MSDP storage servers.

• GET /storage/storage-units

  No longer returns attributes related to size for CLOUD storage unit.

• GET /storage/storage-units/{storageUnitName}

  No longer returns attributes related to size for CLOUD storage unit.

• PATCH /storage/storage-units/{storageUnitName}

  No longer returns attributes related to size for CLOUD storage unit.

• GET /storage/storage-units/{storageUnitName}/replication-relationships

  Updated resource type in the response.