Getting Started

Introduction

The NetBackup API provides a web-service based interface to configure and administer NetBackup, the industry leader in data protection for enterprise environments.

NetBackup API is RESTful

The NetBackup API is built on the Representational State Transfer (REST) architecture, which is the most widely used style for building APIs. The NetBackup API uses the HTTP protocol to communicate with NetBackup. The NetBackup API is therefore easy to use in cloud-based applications, as well as across multiple platforms and programming languages.

JSON message format

The NetBackup API uses JavaScript Object Notation (JSON) as the message format for request and response messages.

The client-server relationship

The NetBackup API employs client-server communication in the form of HTTP requests and responses.

  • The API client (your program) uses the HTTP protocol to make an API request to the NetBackup server.

  • The NetBackup server processes the request. The server responds to the client with an appropriate HTTP status code indicating either success or failure. The client then extracts the required information from the server’s response.

Overview

Authentication

NetBackup authenticates the incoming API requests based on the JSON Web Token (JWT) that needs to be provided in the Authorization HTTP header when making the API requests. This JSON Web Token (JWT) is acquired by executing a login API request first.

Tip
The port that is used to access the NetBackup API is the standard NetBackup PBX port, 1556.

Example

The following procedure provides a sample workflow to retrieve job information from NetBackup. This procedure involves logging in to NetBackup to receive a JWT and then requesting job information for a specific job (job ID 5 in this scenario).

Step 1

Use the NetBackup API endpoint POST /login to create a login request:

curl -X POST https://masterservername:1556/netbackup/login         \
     -H 'content-type: application/vnd.netbackup+json;version=1.0' \
     -d '{                                                         \
            "domainType":"vx",                                     \
            "domainName":"mydomain",                               \
            "userName":"myusername",                               \
            "password":"mypassword"                                \
        }'

The following response to the login request contains the JSON Web Token (JWT):

Note
This response contains three attributes: token, tokenType and validity. The token attribute provides the JWT. The validity attribute indicates that the token returned is valid for 86400 seconds, or 24 hours.
  {
      "token": "eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsInppcCI6IkRFRiJ9.eNp0VF1v2jAU_S9-nHiArXQrb15yaT2cOLIdEJ2mKGWZmnXARMKEVvW_13EciO3weu65H-d-vaIyr9FsMp18Gt_dTsefb6bjESqrCs3Q7umYbfOqLg5ohH7XpYIWqwVfzNM1k6tHvCKJMhSnv63_5MvHO-V_cztC1fFJkQ_b3bGaHar6UGxeitm_k2Lnx_o5q_cvxW44Wlll-c9t2Vjrw7FokW2-eS53hcJ-5X-qwoT5n232u7o4qfJfEQchMZfZN_YVzb6jD-jHSGOMQ0YifA9ndElg5dJAZg9MyDMUcMASsmUkgC-B96jGYrFDoKCwgFEKgSQsPlsoETILgEsyJ4HyE2dLxEIyX9txDJYwSoK1Xa_F01EFZcLnZJgS3MOBNxEhDhNGYi9Tr7KLdJZ4JXBYsgUM0nUtnFFfmirQ7ZBUUZzm6EwEHClDmbTBKczEtacZK55kkXJuwrjcflm6gq45Tgne7I1_o9XF8CNPqdMTnIZEUnYvXLIjQZPnEIoQS2yjAwPVuJLrIFioFfYy4VQ-6JY70hLgERGiv6gad2SYVR9Ya822h6mOKI3sSXRnwSGEWBJMnTLsszTZhpbfarnh9cfI9_saN08DbzZF87m6RcSxyqAKoK63o9RsrJWnPd2zdq-5A8MRqUjUNllN6I4BgpQTuU44S7zzHOqQyeJdboDjAKiVor2YK8_nMutL7DQJux-m_KIIYukvnrthumPCbaS9BCbwkB5j8vW0cYZGfPVrXZHqrHrvU7tfsWmY9wf0Onakt7d3AAAA__8.VVE25rQqbrC-isGOqbRTqMPoK4ts5-9_6zSgz0fUg11m9GCClq10PS9u1DlaXye-S2MYYyHVEHSVs6uKcPVvN2WGBHkv7t-c4Hixc9O8zrJYhJaP979wF_gn08YnRlX7_o4Qj6muc1IWHjK0hPMIgq0X-sBU2Git9uppVW1jbLA",
      "tokenType": "BEARER",
      "validity": 86400
  }
Step 2

Get the job information using the NetBackup API endpoint GET /admin/jobs/{jobId}. In this example, the information for the job ID 5 is requested.

Note
The Authorization header uses the value of the token attribute from the response to the login request made in the previous step.
curl -X GET https://masterservername:1556/netbackup/admin/jobs/5 \
     -H 'Accept: application/vnd.netbackup+json;version=2.0'     \
     -H 'Authorization: eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiIsInppcCI6IkRFRiJ9.eNp0VF1v2jAU_S9-nHiArXQrb15yaT2cOLIdEJ2mKGWZmnXARMKEVvW_13EciO3weu65H-d-vaIyr9FsMp18Gt_dTsefb6bjESqrCs3Q7umYbfOqLg5ohH7XpYIWqwVfzNM1k6tHvCKJMhSnv63_5MvHO-V_cztC1fFJkQ_b3bGaHar6UGxeitm_k2Lnx_o5q_cvxW44Wlll-c9t2Vjrw7FokW2-eS53hcJ-5X-qwoT5n232u7o4qfJfEQchMZfZN_YVzb6jD-jHSGOMQ0YifA9ndElg5dJAZg9MyDMUcMASsmUkgC-B96jGYrFDoKCwgFEKgSQsPlsoETILgEsyJ4HyE2dLxEIyX9txDJYwSoK1Xa_F01EFZcLnZJgS3MOBNxEhDhNGYi9Tr7KLdJZ4JXBYsgUM0nUtnFFfmirQ7ZBUUZzm6EwEHClDmbTBKczEtacZK55kkXJuwrjcflm6gq45Tgne7I1_o9XF8CNPqdMTnIZEUnYvXLIjQZPnEIoQS2yjAwPVuJLrIFioFfYy4VQ-6JY70hLgERGiv6gad2SYVR9Ya822h6mOKI3sSXRnwSGEWBJMnTLsszTZhpbfarnh9cfI9_saN08DbzZF87m6RcSxyqAKoK63o9RsrJWnPd2zdq-5A8MRqUjUNllN6I4BgpQTuU44S7zzHOqQyeJdboDjAKiVor2YK8_nMutL7DQJux-m_KIIYukvnrthumPCbaS9BCbwkB5j8vW0cYZGfPVrXZHqrHrvU7tfsWmY9wf0Onakt7d3AAAA__8.VVE25rQqbrC-isGOqbRTqMPoK4ts5-9_6zSgz0fUg11m9GCClq10PS9u1DlaXye-S2MYYyHVEHSVs6uKcPVvN2WGBHkv7t-c4Hixc9O8zrJYhJaP979wF_gn08YnRlX7_o4Qj6muc1IWHjK0hPMIgq0X-sBU2Git9uppVW1jbLA'

The response to the GET request contains the job information for job ID 5:

{
    "data": {
        "links": {
            "self": {
                "href": "/admin/jobs/5"
            },
            "file-lists": {
                "href": "https://masterservername:1556/netbackup/admin/jobs/5/file-lists"
            },
            "try-logs": {
                "href": "https://masterservername:1556/netbackup/admin/jobs/5/try-logs"
            }
        },
        "type": "job",
        "id": "5",
        "attributes": {
            "jobId": 5,
            "parentJobId": 0,
            "activeProcessId": 27116,
            "mainProcessId": 0,
            "jobType": "IMAGEDELETE",
            "jobSubType": "IMMEDIATE",
            "policyType": "STANDARD",
            "policyName": "",
            "scheduleType": "FULL",
            "scheduleName": "",
            "clientName": "",
            "controlHost": "",
            "jobOwner": "root",
            "jobGroup": "",
            "backupId": "",
            "sourceMediaId": "",
            "sourceStorageUnitName": "",
            "sourceMediaServerName": "",
            "destinationMediaId": "",
            "destinationStorageUnitName": "",
            "destinationMediaServerName": "",
            "dataMovement": "STANDARD",
            "streamNumber": 0,
            "copyNumber": 0,
            "priority": 0,
            "retentionLevel": 0,
            "compression": 0,
            "status": 1,
            "state": "DONE",
            "done": 1,
            "numberOfFiles": 0,
            "estimatedFiles": 0,
            "kilobytesTransferred": 0,
            "kilobytesToTransfer": 0,
            "transferRate": 0,
            "percentComplete": 0,
            "currentFile": "",
            "restartable": 0,
            "suspendable": 0,
            "resumable": 0,
            "killable": 1,
            "frozenImage": 0,
            "transportType": "LAN",
            "dedupRatio": 0,
            "currentOperation": 0,
            "jobQueueReason": 0,
            "jobQueueResource": "",
            "robotName": "",
            "vaultName": "",
            "profileName": "",
            "sessionId": 0,
            "numberOfTapeToEject": 0,
            "submissionType": 0,
            "acceleratorOptimization": 0,
            "dumpHost": "",
            "instanceDatabaseName": "",
            "auditUserName": "",
            "auditDomainName": "",
            "auditDomainType": 0,
            "restoreBackupIDs": "",
            "startTime": "2018-01-09T10:03:22.000Z",
            "endTime": "2018-01-09T10:03:23.000Z",
            "activeTryStartTime": "2018-01-09T10:03:22.000Z",
            "lastUpdateTime": "2018-01-09T10:03:23.256Z",
            "kilobytesDataTransferred": 0,
            "try": 1
        }
    }
}

SSL certificate validation

The NetBackup web service always sends its certificate during SSL handshakes. This certificate can be validated by the API client. To validate the certificate, you will need to get the Certificate Authority (CA) certificate from the master server and then use the CA certificate in the API requests.

Tip
It is a good practice to validate the SSL certificate. This action ensures that you are communicating with the correct web service.
Step 1

Get the CA certificate from the master server using the GET /security/cacert API:

Note
You cannot make a secure request with certificate validation until you have the CA certificate. To obtain the initial CA certificate you must skip the certificate validation, with the "--insecure" curl option.
curl -X GET https://masterservername:1556/netbackup/security/cacert \
     -H 'content-type: application/vnd.netbackup+json;version=2.0'   \
     --insecure

The response to the cacert request contains two certificates:

    {
        "webRootCert": "-----BEGIN CERTIFICATE-----\nMIICljCCAf+gAwIBAgIIcte7aAAAAAAwDQYJKoZIhvcNAQENBQAwTTEOMAwGA1UE\nAxMFbmJhdGQxLjAsBgNVBAsUJXJvb3RAbW9ybGV5dm01LnJtbnVzLnNlbi5zeW1h\nbnRlYy5jb20xCzAJBgNVBAoTAnZ4MB4XDTE4MDEwODE0MjcyNloXDTM4MDEwMzE1\nNDIyNlowTTEOMAwGA1UEAxMFbmJhdGQxLjAsBgNVBAsUJXJvb3RAbW9ybGV5dm01\nLnJtbnVzLnNlbi5zeW1hbnRlYy5jb20xCzAJBgNVBAoTAnZ4MIGfMA0GCSqGSIb3\nDQEBAQUAA4GNADCBiQKBgQDpRc/yo0utxcKrftPeOzn1o1MR5b42uGWrwg9kU4VM\nZN++0kvrtRWt4wz8zdtNU4wtg/MHWt0ffj6FRYYAZBbM8fu56GFux3wCPJSHWl6B\nZ0nD1vZxFUwTXkRAAObuHrYphjBNf1oUU+4GS44KD4/UW/bucKdZsUI1+HcfCQZw\nNwIDAQABo38wfTAPBgNVHRMBAf8EBTADAQH/MAsGAyoDBQQEcm9vdDAPBgMqAwYE\nCDAwMDAwMDE3MC0GAyoDCAQmezg2ZDY5MDU0LWY0OGEtMTFlNy1hNDAyLTYwYWQy\nMTZjYTdlZX0wHQYDVR0OBBYEFE/mpo7PbWs7p/zkAHWi/BDwpdn+MA0GCSqGSIb3\nDQEBDQUAA4GBAAmZJ98XLqG0H+qwyuZ97YdzE2dWKpRduuARYJp437Sc6tpL6nFn\nuzbtGV30tDdhROYPf1AoNRmZHvz40Hra1B8j4VFggPZOAmmk+UJPjzeHn6qhlRxl\nHjCdEqUZ//+1Aqgj6f/6bqPO5boCVP1qw8N60fkBaV3zLwAOY6CKiHS0\n-----END CERTIFICATE-----\n",
        "cacert": [
   "-----BEGIN CERTIFICATE-----\nMIICljCCAf+gAwIBAgIIcte7aAAAAAAwDQYJKoZIhvcNAQENBQAwTTEOMAwGA1UE\nAxMFbmJhdGQxLjAsBgNVBAsUJXJvb3RAbW9ybGV5dm01LnJtbnVzLnNlbi5zeW1h\nbnRlYy5jb20xCzAJBgNVBAoTAnZ4MB4XDTE4MDEwODE0MjcyNloXDTM4MDEwMzE1\nNDIyNlowTTEOMAwGA1UEAxMFbmJhdGQxLjAsBgNVBAsUJXJvb3RAbW9ybGV5dm01\nLnJtbnVzLnNlbi5zeW1hbnRlYy5jb20xCzAJBgNVBAoTAnZ4MIGfMA0GCSqGSIb3\nDQEBAQUAA4GNADCBiQKBgQDpRc/yo0utxcKrftPeOzn1o1MR5b42uGWrwg9kU4VM\nZN++0kvrtRWt4wz8zdtNU4wtg/MHWt0ffj6FRYYAZBbM8fu56GFux3wCPJSHWl6B\nZ0nD1vZxFUwTXkRAAObuHrYphjBNf1oUU+4GS44KD4/UW/bucKdZsUI1+HcfCQZw\nNwIDAQABo38wfTAPBgNVHRMBAf8EBTADAQH/MAsGAyoDBQQEcm9vdDAPBgMqAwYE\nCDAwMDAwMDE3MC0GAyoDCAQmezg2ZDY5MDU0LWY0OGEtMTFlNy1hNDAyLTYwYWQy\nMTZjYTdlZX0wHQYDVR0OBBYEFE/mpo7PbWs7p/zkAHWi/BDwpdn+MA0GCSqGSIb3\nDQEBDQUAA4GBAAmZJ98XLqG0H+qwyuZ97YdzE2dWKpRduuARYJp437Sc6tpL6nFn\nuzbtGV30tDdhROYPf1AoNRmZHvz40Hra1B8j4VFggPZOAmmk+UJPjzeHn6qhlRxl\nHjCdEqUZ//+1Aqgj6f/6bqPO5boCVP1qw8N60fkBaV3zLwAOY6CKiHS0\n-----END CERTIFICATE-----\n"
        ]
    }
Step 2

Save the webRootCert certificate. To do this save the webRootCert string to a file. Make sure to convert the \n escape sequences to new lines (carriage returns).

For example, your file would look something like this:

-----BEGIN CERTIFICATE-----
MIICljCCAf+gAwIBAgIIcte7aAAAAAAwDQYJKoZIhvcNAQENBQAwTTEOMAwGA1UE
AxMFbmJhdGQxLjAsBgNVBAsUJXJvb3RAbW9ybGV5dm01LnJtbnVzLnNlbi5zeW1h
bnRlYy5jb20xCzAJBgNVBAoTAnZ4MB4XDTE4MDEwODE0MjcyNloXDTM4MDEwMzE1
NDIyNlowTTEOMAwGA1UEAxMFbmJhdGQxLjAsBgNVBAsUJXJvb3RAbW9ybGV5dm01
LnJtbnVzLnNlbi5zeW1hbnRlYy5jb20xCzAJBgNVBAoTAnZ4MIGfMA0GCSqGSIb3
DQEBAQUAA4GNADCBiQKBgQDpRc/yo0utxcKrftPeOzn1o1MR5b42uGWrwg9kU4VM
ZN++0kvrtRWt4wz8zdtNU4wtg/MHWt0ffj6FRYYAZBbM8fu56GFux3wCPJSHWl6B
Z0nD1vZxFUwTXkRAAObuHrYphjBNf1oUU+4GS44KD4/UW/bucKdZsUI1+HcfCQZw
NwIDAQABo38wfTAPBgNVHRMBAf8EBTADAQH/MAsGAyoDBQQEcm9vdDAPBgMqAwYE
CDAwMDAwMDE3MC0GAyoDCAQmezg2ZDY5MDU0LWY0OGEtMTFlNy1hNDAyLTYwYWQy
MTZjYTdlZX0wHQYDVR0OBBYEFE/mpo7PbWs7p/zkAHWi/BDwpdn+MA0GCSqGSIb3
DQEBDQUAA4GBAAmZJ98XLqG0H+qwyuZ97YdzE2dWKpRduuARYJp437Sc6tpL6nFn
uzbtGV30tDdhROYPf1AoNRmZHvz40Hra1B8j4VFggPZOAmmk+UJPjzeHn6qhlRxl
HjCdEqUZ//+1Aqgj6f/6bqPO5boCVP1qw8N60fkBaV3zLwAOY6CKiHS0
-----END CERTIFICATE-----
Step 3

You can now use the CA certificate in your API requests. For example, to securely use the cacert API remove the --insecure option and use the --cacert <filename> option. In the following example, the CA certificate was saved in the file cacert.pem.

curl -X GET https://masterservername:1556/netbackup/security/cacert \
     -H 'content-type: application/vnd.netbackup+json;version=2.0'   \
     --cacert cacert.pem

Authorization

A given NetBackup API may require that one or more Permissions are assigned to a given principal before the request is allowed to run on the server. In this document, any required permissions for a given resource path are documented in the Description section of the resource as below:

Requires Permission: [Permission value]

When multiple permissions are listed, the enforcement is a logical OR, meaning the principal must have at least one of the expected permissions. Permissions are granted to a principal through the roles that are assigned in their NetBackup RBAC access rules.

Note
Internally, NetBackup uses API Permissions to authorize individual API requests. A permission is composed of one or more API permissions. The authorization context for an authorized principal is represented in their JWT and contains one or more API Permission values that are derived from assigned permissions. However, API Permissions are not exposed to end users for delegation and configuration.

The following table describes the permissions that are assigned to the system-defined roles that are present at installation.

Workload administrator Backup administrator Security administrator

Recover/Restore

Manage Jobs

Manage Access Rules

Instant Access

Manage Protection Plans

Manage Global Security Settings

Download Files

Manage Assets

Manage Certificates

Restore Files

Manage NetBackup

View Audit Logs

Manage Assets

View Usage Data

Manage Hosts

Manage SLPs

View Application Servers

Manage Policies

View Assets

Manage Application Servers and Asset Groups

View Cloud Application Servers

Manage Cloud Application Servers

View Protection Plans

View Recovery Points

Manage API Keys

View API Keys

View Domains

Versioning

To maintain compatibility with the back-level API clients, it is sometimes necessary to version the NetBackup API. The NetBackup API is developed so that new versions are minimized. However, at times changes are needed to the API that require a new API version. The mechanism to version the NetBackup API is described below.

Version numbers follow a simple MAJOR.MINOR pattern, such as 1.2. These version numbers are not the same as the NetBackup release number. The current API version number is documented with every NetBackup release. The version number may not increase sequentially from one NetBackup release to the next release. The version number may increase by multiple major versions between two consecutive NetBackup releases.

Content negotiation is used to specify which API version the API client is requesting. A new vendor-specific media type application/vnd.netbackup+json is used, along with a media type parameter named version. For example: application/vnd.netbackup+json;version=2.0. This media type should be used in the Accept or Content-Type HTTP header of your request. If you send both Accept and Content-Type HTTP headers, their values must match.

In some cases, an API does not consume any input or produce any output. Such a case normally means that neither Accept nor Content-Type HTTP headers are required. However, because these headers are used to specify the API version, the Accept header must be specified.

Tip
The value of the Content-Type or Accept HTTP header in a NetBackup API request must use this format: application/vnd.netbackup+media;version=<major>.<minor>

It is important for you to consider the kind of changes that will require a new version of the NetBackup API. Developing your API client with these rules in mind will ensure that your API client remains compatible with the future versions of the NetBackup API.

The following is a list of possible API changes and if they result in a new API version:

API change results in a new version? Yes / No

Add a new endpoint

No

Remove an endpoint

Yes

Add an output field or attribute

No

Remove output field or attribute

Yes

Add required input field or attribute

Yes

Add non-required input field or attribute

No

Note
  • If the API client expects a particular endpoint or field in the NetBackup response, then removing the endpoint or field results in a new version.

  • If NetBackup expects a new required field in the request from the API client, then adding it results in a new version.

  • As you develop your API client, as a best practice you should ignore any new fields that are returned to you. Do not treat unrecognized fields as an error. This way your API clients can continue to work with future releases of NetBackup without any change.

Pagination

Some NetBackup APIs use pagination to limit the number of resources returned in a response. These APIs use the page[offset] and page[limit] query parameters to set the starting point (offset) and the page size (limit). The results are returned in a page-by-page format.

Tip
The default page size is 10 resources. The type of resource depends on the individual API. For example: For the API that gets a list of jobs, the page contains job-related information for up to 10 NetBackup jobs.

Filtering

Some NetBackup APIs use the 'filter' query parameter to limit or reduce the number of resources that the response returns.

Note
The supported OData operators and functions depend on each individual NetBackup API, as described in the NetBackup API reference.

Date and time formatting

All NetBackup APIs accept and return date and time values using the ISO 8601 format in UTC with the Z zone designator.

More information on the details of the ISO spec can be found in the Wikipedia article, "ISO 8601": https://en.wikipedia.org/wiki/ISO_8601.

API Code Samples

To hit the ground running with the NetBackup API, you can refer to the API code samples in different programming languages. The API code samples are located on github: https://github.com/VeritasOS/netbackup-api-code-samples. This is a community-supported, open source project available under the MIT license.

Disclaimer
  • The API code samples are not officially supported by Veritas and should not be used in a production environment.

  • The purpose of these code samples is only to serve as a reference, to help you write your own applications using the NetBackup API.

What’s New?

NetBackup 8.1.2

Versioned APIs

This is a list of APIs that have been versioned in 8.1.2. The previous version of these APIs is still supported specifying the correct version. See the Versioning section above for more details. See the 8.1.2 documentation for the APIs listed below to see the new definition of these APIs.

  • GET /admin/jobs

  • GET /admin/jobs/{jobId}

  • GET /config/policies/{policyName}

  • PUT /config/policies/{policyName}/schedules/{scheduleName}

  • GET /config/servers/vmservers

  • GET /security/cacert

NetBackup 8.1.2 adds support for the following APIs:

Note
Each API in this list includes a link to the API reference for further details.

NetBackup Authentication API

The NetBackup Authentication API provides authentication by means of a JSON Web Token (JWT) that is used when making the API requests. The JWT is acquired by executing a login API request and can be invalidated by executing a logout API request.

NetBackup Administration API

The NetBackup Administration API provides management of NetBackup jobs. The API can get job details for a specific job or get a list of jobs based on filter criteria, restart or resume a job, suspend, cancel, or delete a job, get a job’s file list, and get the job logs.

NetBackup Asset API

The NetBackup Asset API provides access to NetBackup asset information.

NetBackup Catalog API

The NetBackup Catalog API provides access to the NetBackup catalog to get details about backup images. The API can list backup images based on filters or get details for a specific backup image ID.

NetBackup Configuration API

The NetBackup Configuration API provides configuration and management controls for NetBackup hosts, NetBackup policies, Web Socket servers, and VM server credentials.

NetBackup Manage API

The NetBackup Manage API provide access to the alerting operations. The APIs can generate alerts, fetch alert details, and send alert notifications. The APIs also provide a facility to exclude the status codes for which you do not want to send alert notifications.

NetBackup Recovery API

The NetBackup Recovery API provides the capability of recovering from VMware backup images. It supports the recovery of full VMs to the original or to alternate location.

NetBackup Security API

The NetBackup Security API provides access to the security resources of NetBackup. The API can manage authorization tokens, host ID-based certificates, security configuration options and auditing.

NetBackup Storage API

The NetBackup Storage API provides details of backup storage consumption. The API returns the total consumption of backup storage for all the master servers or the current master server. It also supports filtering backup storage consumption based on client name.

NetBackup Licensing API

The NetBackup Licensing API provides details of FEDS consumption. The Front-end Terabytes (FETBs) consumption is provided for a single master server or for multiple trusted master servers. Details include consumption by policy type and the trend of capacity consumption.


NetBackup Authentication API

Overview

The NetBackup Authentication API provides authentication by means of a JSON Web Token (JWT) that is used when making the API requests.

Version information

Version : 2.0

URI scheme

Host : <masterserver>:1556
BasePath : /netbackup
Schemes : HTTPS

Paths

GET /appdetails

Description

Gets the web service application details. The application names and status are returned.

Requires Permission: []

Responses

HTTP Code Description Schema

200

Web service application details returned successfully.

appdetailsResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

GET /authorization-context

Description

Lists the JWT claims.

Requires Permission: []

Responses

HTTP Code Description Schema

200

Successful response.

authorizationContextResource

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

Resource not found.

errorResponse

500

An unexpected system error occurred.

errorResponse

503

Server busy. Try again later.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

POST /login

Description

Logs in with the username and password and receives a JSON Web Token (JWT) that is used on all subsequent API requests. Requires Permission: []

Parameters

Type Name Schema

Body

login
required

userPassLoginRequest

Responses

HTTP Code Description Schema

201

Successfully logged in.
Headers :
Location (string) : The URI that contains the authentication token.

loginResponse

400

Bad request

errorResponse

401

Wrong username or password.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Produces

  • application/vnd.netbackup+json;version=2.0

POST /logout

Description

Removes the current access token (JWT), which invalidates that token for future API calls.

Requires Permission: []

Responses

HTTP Code Description Schema

200

Logout successful.

No Content

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

Security

Type Name

apiKey

rbacSecurity

GET /ping

Description

Test the connection with the master server.

Requires Permission: []

Responses

HTTP Code Description Schema

200

Ping successful. Master server time in milliseconds.
Headers :
X-NetBackup-API-Version (string) : The current API version of this server.

string

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

string

Produces

  • text/vnd.netbackup+plain;version=2.0

Example HTTP response

Response 200
"1519397648169"

GET /tokenkey

Description

Gets the public key that can be used to validate the JSON Web Token (JWT).

Requires Permission: []

Responses

HTTP Code Description Schema

200

Successfully retrieved the token key.

string

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

string

Produces

  • text/vnd.netbackup+html;version=2.0

GET /user-sessions

Description

Obtains the details for all active user sessions.

Requires Permission: [Manage Certificates]

Responses

HTTP Code Description Schema

200

Successfully returned the details for all active user sessions.

getActiveUsers

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

DELETE /user-sessions

Description

Logs out all users. Removes the current access tokens (JWT) issued to all users, which invalidates them for all future API calls.

Requires Permission: [Manage Certificates]

Responses

HTTP Code Description Schema

204

Successfully logged out all users.

No Content

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

Security

Type Name

apiKey

rbacSecurity

Definitions

appdetailsResponse

Type : < appdetailsResponse > array

appdetailsResponse

Name Description Schema

appName
required

Web services application name.

string

status
required

Current run-time status of the application.

string

authorizationContext

Name Schema

attributes
optional

attributes

id
optional

string

links
optional

object

meta
optional

object

type
required

string

attributes

Name Description Schema

authToken
optional

The internal NetBackup authorization token issued by the gateway.

string

expireDate
optional

Expiration date of the JWT.

string (date-time)

isAdmin
optional

Indicate if the subject of the JWT is an admin user.

boolean

isMachine
optional

Indicate if the subject of the JWT is a machine.

boolean

issuedAt
optional

The date of the JWT was issued.

string (date-time)

issuer
optional

JWT issuer.

string

permissions
optional

The mapping of API permissions to object collection IDs.

< permissions > array

subject
optional

Contain domain name, username, and domain type.

string

permissions

Name Description Schema

collections
optional

Array of object collection IDs for which the user had this permission.

< string > array

permission
optional

string

authorizationContextResource

Details of JWT claims.

Name Schema

data
optional

authorizationContext

errorResponse

Name Description Schema

details
optional

A map containing error field and error field message to provide more context to nature of the error.

object

errorCode
required

The NetBackup error code.

integer (int64)

errorMessage
required

The NetBackup error code description.

string

getActiveUsers

Details for active user session.

Name Schema

data
optional

< data > array

links
optional

links

meta
optional

meta

data

Name Schema

attributes
optional

attributes

id
optional

string

type
optional

enum (user-session)

attributes

Name Schema

expiresAt
optional

string (date-time)

subject
optional

string

Name Schema

first
optional

first

last
optional

last

next
optional

next

previous
optional

previous

self
optional

self

first

Name Schema

href
optional

string

last

Name Schema

href
optional

string

next

Name Schema

href
optional

string

previous

Name Schema

href
optional

string

self

Name Schema

href
optional

string

meta

Name Schema

pagination
optional

pagination

pagination

Name Schema

count
optional

integer

first
optional

integer

last
optional

integer

limit
optional

integer

next
optional

integer

offset
optional

integer

page
optional

integer

pages
optional

integer

prev
optional

integer

loginResponse

Name Description Schema

token
required

The token to use for subsequent API requests.

string

tokenType
required

The token type for the token that is returned.

string

validity
required

The time in seconds that this token will be valid.

integer

userPassLoginRequest

Name Description Schema

domainName
optional

The domain name for the user.

string

domainType
optional

The domain type for the user.

enum (NT, vx, unixpwd, ldap)

password
required

The user password.

string

userName
required

The user account name.

string

Security

rbacSecurity

Type : apiKey
Name : Authorization
In : HEADER

NetBackup Administration API

Overview

The NetBackup Administration API provides access to administrative operations in NetBackup.

Version information

Version : 2.0

URI scheme

Host : <masterserver>:1556
BasePath : /netbackup
Schemes : HTTPS

Paths

GET /admin/jobs

Description

Gets the list of jobs based on specified filters. If no filters are specified, information for 10 jobs sorted in descending order by job start time is retrieved. All the filters are based on OData standards, and filtering on the following attributes is supported. To avoid sending large set of jobs data, API returns only subset of data (default size 10). To fetch additional results, take advantage of pagination using "page[Offset]" & "page[limit]" which allows for subsequent requests to "page" through the rest of the results until the end is reached.

Name Supported Operators Description Schema

jobId

eq ne lt gt le ge

The job identifier.

integer(int64)

parentJobId

eq ne lt gt le ge

The parent job identifier.

integer(int64)

clientName

eq ne contains, startswith, endswith

The name of the client to protect. If the client name contains a space or “%”, encode these characters as '%20' or '%25', respectively.

string

endTime

eq ne lt gt le ge

Specifies the time when the job finished.

date-time

startTime

eq ne lt gt le ge

Specifies the time when the job started.

date-time

state

eq ne

Specifies the state of the job. Possible values: QUEUED, ACTIVE, REQUEUED, DONE, SUSPENDED, INCOMPLETE

string

status

eq ne lt gt le ge

Specifies the final job status code.

integer(int64)

jobType

eq ne

Specifies the type of the job. Possible values: BACKUP, ARCHIVE, RESTORE, VERIFY, DUPLICATE, IMPORT, DBBACKUP, VAULT, LABEL, ERASE, TPREQ, TPCLEAN, TPFORMAT, VMPHYSINV, DQTS, DBRECOVER, MCONTENTS, IMAGEDELETE, LIVEUPDATE, GENERIC, REPLICATE, REPLICA_IMPORT, SNAPDUPE, SNAPREPLICATE, SNAPIMPORT, APP_STATE_CAPTURE, INDEXING, INDEXCLEANUP, SNAPINDEX, ACTIVATE_IR, DEACTIVATE_IR, REACTIVATE_IR, STOP_IR, INSTANT_RECOVERY, RMAN_CATALOG, LOCKVM

string

policyName

contains, startswith, endswith

The name of the policy used by this job.

string

policyType

eq ne

Specifies the type of the policy. Possible values: STANDARD, PROXY, NONSTANDARD, APOLLO_WBAK, OBACKUP, ANY, INFORMIX, SYBASE, SHAREPOINT, WINDOWS, NETWARE, BACKTRACK, AUSPEX_FASTBACK, WINDOWS_NT, OS2, SQL_SERVER, EXCHANGE, SAP, DB2, NDMP, FLASHBACKUP, SPLITMIRROR, AFS, DFS, DATASTORE, LOTUS_NOTES, NCR_TERADATA, VAX_VMS, HP3000_MPE, FBU_WINDOWS, VAULT, BE_SQL_SERVER, BE_EXCHANGE, MAC, DS, NBU_CATALOG, GENERIC, CMS_DB, PUREDISK_EXPORT, ENTERPRISE_VAULT, VMWARE, HYPERV, BIGDATA, HYPERSCALE, NBU_SEARCHSERVER

string

restoreBackupIDs

eq, ne, contains, startswith, endswith

Specifies the backup images used for restore. If the client name contains a space or “%”, encode these characters as '%20' or '%25', respectively.

string

initiatorId

eq, ne, contains, startswith, endswith

Specifies the initiator of the job.

string

Requires Permission: [View Jobs, Manage Jobs]

A given principal can also view the jobs that they initiate even if they are not granted the View Jobs permission.

Parameters

Type Name Description Schema

Query

filter
optional

Specifies filters according to OData standards.

string

Query

page[limit]
optional

The number of records on one page after the offset.

integer (int64)

Query

page[offset]
optional

The job record number offset.

integer (int64)

Query

sort
optional

Sorts in ascending order on the specified property. Prefix with '-' for descending order.

string

Responses

HTTP Code Description Schema

200

Successfully retrieved the list of jobs based on the specified filters. No data is returned if no jobs are found.

getJobsResponse

400

Bad request.

errorResponse

405

Method not allowed. The specified HTTP operation is invalid.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

An unexpected system error occurred.

errorResponse

503

The server is busy.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

Example HTTP response

Response 200
{
  "data" : [ {
    "links" : {
      "self" : {
        "href" : "/admin/jobs/1"
      },
      "file-lists" : {
        "href" : "https://dummyHost:1556/netbackup/admin/jobs/1/file-lists"
      },
      "try-logs" : {
        "href" : "https://dummyHost:1556/netbackup/admin/jobs/1/try-logs"
      }
    },
    "type" : "job",
    "id" : 1,
    "attributes" : {
      "jobId" : 1,
      "parentJobId" : 0,
      "activeProcessId" : 8624,
      "mainProcessId" : 0,
      "productType" : 0,
      "jobType" : "IMAGEDELETE",
      "jobSubType" : "IMMEDIATE",
      "policyName" : "",
      "scheduleType" : "FULL",
      "scheduleName" : "",
      "clientName" : "",
      "controlHost" : "",
      "jobOwner" : "user",
      "jobGroup" : "",
      "backupId" : "",
      "sourceMediaId" : "",
      "sourceStorageUnitName" : "",
      "sourceMediaServerName" : "",
      "destinationMediaId" : "",
      "destinationStorageUnitName" : "",
      "destinationMediaServerName" : "",
      "dataMovement" : "STANDARD",
      "streamNumber" : 0,
      "copyNumber" : 0,
      "priority" : 0,
      "retentionLevel" : 0,
      "compression" : 0,
      "status" : 0,
      "state" : "DONE",
      "done" : 1,
      "numberOfFiles" : 0,
      "estimatedFiles" : 0,
      "kilobytesTransferred" : 0,
      "kilobytesToTransfer" : 0,
      "transferRate" : 0,
      "percentComplete" : 100,
      "restartable" : 0,
      "suspendable" : 0,
      "resumable" : 0,
      "killable" : 1,
      "frozenImage" : 0,
      "transportType" : "LAN",
      "currentOperation" : 0,
      "jobQueueReason" : 0,
      "jobQueueResource" : "",
      "robotName" : "",
      "vaultName" : "",
      "profileName" : "",
      "sessionId" : 0,
      "numberOfTapeToEject" : 0,
      "submissionType" : 0,
      "dumpHost" : "",
      "instanceDatabaseName" : "",
      "auditUserName" : "",
      "auditDomainName" : "",
      "auditDomainType" : 0,
      "restoreBackupIDs" : "",
      "startTime" : "2018-06-25T19:00:32.000Z",
      "endTime" : "2018-06-25T19:00:38.000Z",
      "activeTryStartTime" : "2018-06-25T19:00:32.000Z",
      "lastUpdateTime" : "2018-06-25T19:00:38.407Z",
      "kilobytesDataTransferred" : 0,
      "initiatorId" : "",
      "try" : 1
    }
  }, {
    "links" : {
      "self" : {
        "href" : "/admin/jobs/2"
      },
      "file-lists" : {
        "href" : "https://dummyHost:1556/netbackup/admin/jobs/2/file-lists"
      },
      "try-logs" : {
        "href" : "https://dummyHost:1556/netbackup/admin/jobs/2/try-logs"
      }
    },
    "type" : "job",
    "id" : 2,
    "attributes" : {
      "jobId" : 2,
      "parentJobId" : 0,
      "activeProcessId" : 8625,
      "mainProcessId" : 0,
      "productType" : 0,
      "jobType" : "IMAGEDELETE",
      "jobSubType" : "IMMEDIATE",
      "policyName" : "",
      "scheduleType" : "FULL",
      "scheduleName" : "",
      "clientName" : "",
      "controlHost" : "",
      "jobOwner" : "user",
      "jobGroup" : "",
      "backupId" : "",
      "sourceMediaId" : "",
      "sourceStorageUnitName" : "",
      "sourceMediaServerName" : "",
      "destinationMediaId" : "",
      "destinationStorageUnitName" : "",
      "destinationMediaServerName" : "",
      "dataMovement" : "STANDARD",
      "streamNumber" : 0,
      "copyNumber" : 0,
      "priority" : 0,
      "retentionLevel" : 0,
      "compression" : 0,
      "status" : 0,
      "state" : "DONE",
      "done" : 1,
      "numberOfFiles" : 0,
      "estimatedFiles" : 0,
      "kilobytesTransferred" : 0,
      "kilobytesToTransfer" : 0,
      "transferRate" : 0,
      "percentComplete" : 100,
      "restartable" : 0,
      "suspendable" : 0,
      "resumable" : 0,
      "killable" : 1,
      "frozenImage" : 0,
      "transportType" : "LAN",
      "currentOperation" : 0,
      "jobQueueReason" : 0,
      "jobQueueResource" : "",
      "robotName" : "",
      "vaultName" : "",
      "profileName" : "",
      "sessionId" : 0,
      "numberOfTapeToEject" : 0,
      "submissionType" : 0,
      "dumpHost" : "",
      "instanceDatabaseName" : "",
      "auditUserName" : "",
      "auditDomainName" : "",
      "auditDomainType" : 0,
      "restoreBackupIDs" : "",
      "startTime" : "2018-06-25T19:00:32.000Z",
      "endTime" : "2018-06-25T19:00:38.000Z",
      "activeTryStartTime" : "2018-06-25T19:00:32.000Z",
      "lastUpdateTime" : "2018-06-25T19:00:38.407Z",
      "kilobytesDataTransferred" : 0,
      "initiatorId" : "",
      "try" : 1
    }
  } ]
}

GET /admin/jobs/{jobId}

Description

Gets the job details for the specified job.

Requires Permission: [View Jobs, Manage Jobs]

A given principal can also view the jobs that they initiate even if they are not granted the View Jobs permission.

Parameters

Type Name Description Schema

Path

jobId
required

The job identifier.

integer (int64)

Responses

HTTP Code Description Schema

200

Successfully retrieved the job details for the specified job.

getJobResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No entity found.

errorResponse

405

Method not allowed. The specified HTTP operation is invalid.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

An unexpected system error occurred.

errorResponse

503

The server is busy.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

DELETE /admin/jobs/{jobId}

Description

Deletes the specified job.

Requires Permission: [Manage Jobs]

A given principal can also manage the jobs that they initiate even if they are not granted the Manage Jobs permission.

Parameters

Type Name Description Schema

Header

X-NetBackup-Audit-Reason
optional

The audit reason for deleting the job.

string

Path

jobId
required

The job identifier.

integer (int64)

Responses

HTTP Code Description Schema

202

Request accepted.

No Content

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No entity found.

errorResponse

405

Method not allowed. The specified HTTP operation is invalid.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

An unexpected system error occurred.

errorResponse

503

The server is busy.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

POST /admin/jobs/{jobId}/cancel

Description

Cancels the specified job.

Requires Permission: [Manage Jobs]

A given principal can also manage the jobs that they initiate even if they are not granted the Manage Jobs permission.

Parameters

Type Name Description Schema

Header

X-NetBackup-Audit-Reason
optional

The audit reason for cancelling the job.

string

Path

jobId
required

The job identifier.

integer (int64)

Responses

HTTP Code Description Schema

202

Request accepted.

No Content

400

Bad request.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No entity found.

errorResponse

405

Method not allowed. The specified HTTP operation is invalid.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

An unexpected system error occurred.

errorResponse

503

The server is busy.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

GET /admin/jobs/{jobId}/file-lists

Description

Gets the file list for the specified job.

Requires Permission: [View Jobs, Manage Jobs]

A given principal can also view the related file-lists for the jobs that they initiate even if they are not granted the View Jobs permission.

Parameters

Type Name Description Schema

Path

jobId
required

The job identifier.

integer (int64)

Responses

HTTP Code Description Schema

200

Successfully retrieved the file list for the specified job.

getJobFileListResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No entity found.

errorResponse

405

Method not allowed. The specified HTTP operation is invalid.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

An unexpected system error occurred.

errorResponse

503

The server is busy.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

Example HTTP response

Response 200
{
  "data" : {
    "links" : {
      "self" : {
        "href" : "/admin/jobs/1/file-lists"
      }
    },
    "type" : "file-lists",
    "id" : 1,
    "attributes" : {
      "fileList" : [ "C:\\BackupSource\\MyFolder" ]
    }
  }
}

POST /admin/jobs/{jobId}/restart

Description

Restarts the specified job.

Requires Permission: [Manage Jobs]

A given principal can also manage the jobs that they initiate even if they are not granted the Manage Jobs permission.

Parameters

Type Name Description Schema

Header

X-NetBackup-Audit-Reason
optional

The audit reason for restarting the job.

string

Path

jobId
required

The job identifier.

integer (int64)

Responses

HTTP Code Description Schema

202

Request accepted.

No Content

400

Bad request.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No entity found.

errorResponse

405

Method not allowed. The specified HTTP operation is invalid.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

An unexpected system error occurred.

errorResponse

503

The server is busy.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

POST /admin/jobs/{jobId}/resume

Description

Resumes the specified job.

Requires Permission: [Manage Jobs]

A given principal can also manage the jobs that they initiate even if they are not granted the Manage Jobs permission.

Parameters

Type Name Description Schema

Header

X-NetBackup-Audit-Reason
optional

The audit reason for resuming the job.

string

Path

jobId
required

The job identifier.

integer (int64)

Responses

HTTP Code Description Schema

202

Request accepted.

No Content

400

Bad request.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No entity found.

errorResponse

405

Method not allowed. The specified HTTP operation is invalid.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

An unexpected system error occurred.

errorResponse

503

The server is busy.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

POST /admin/jobs/{jobId}/suspend

Description

Suspends the specified job.

Requires Permission: [Manage Jobs]

A given principal can also manage the jobs that they initiate even if they are not granted Manage Jobs permission.

Parameters

Type Name Description Schema

Header

X-NetBackup-Audit-Reason
optional

The audit reason for suspending the job.

string

Path

jobId
required

The job identifier.

integer (int64)

Responses

HTTP Code Description Schema

202

Request accepted.

No Content

400

Bad request.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No entity found.

errorResponse

405

Method not allowed. The specified HTTP operation is invalid.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

An unexpected system error occurred.

errorResponse

503

The server is busy.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

GET /admin/jobs/{jobId}/try-logs

Description

Gets logs for the specified job.

Requires Permission: [View Jobs, Manage Jobs]

A given principal can also view the related try-logs for the jobs that they initiate even if they are not granted the View Jobs permission.

Parameters

Type Name Description Schema

Path

jobId
required

The job identifier.

integer (int64)

Responses

HTTP Code Description Schema

200

Successfully retrieved the try-logs for the specified job.

getJobTryLogsResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No entity found.

errorResponse

405

Method not allowed. The specified HTTP operation is invalid.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

An unexpected system error occurred.

errorResponse

503

The server is busy.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

Example HTTP response

Response 200
{
  "data" : {
    "links" : {
      "self" : {
        "href" : "/admin/jobs/1/try-logs"
      }
    },
    "type" : "try-logs",
    "id" : 1,
    "attributes" : {
      "log" : [ "Try 1", "LOG 1529953232 4 bpdbm 8624 image catalog cleanup", "LOG 1529953232 4 bpdbm 8624 Cleaning up tables in the relational database", "LOG 1529953232 4 bpdbm 8624 deleting images which expire before Mon Jun 25 12:00:21 2018 (1529953221)", "LOG 1529953238 4 bpdbm 8624 deleted 0 expired records, compressed 0, tir removed 0, deleted 0 expired copies", "Started 1529953232", "ActivePid 8624", "Status 0", "Ended 1529953238" ]
    }
  }
}

Definitions

errorResponse

Name Description Schema

details
optional

A map containing error field and error field message to provide more context to nature of the error.

object

errorCode
required

The NetBackup error code.

integer (int64)

errorMessage
required

The NetBackup error code description.

string

getJobDetailsResponse

Name Schema

attributes
optional

attributes

id
optional

string

links
optional

links

type
optional

string

attributes

Name Description Schema

acceleratorOptimization
optional

The percentage of optimization achieved if the job uses NetBackup Accelerator

integer (int64)

activeProcessId
optional

The process that is active now.

integer (int64)

activeTryStartTime
optional

A UTC timestamp of when the current try started.

string

auditDomainName
optional

The domain name for auditing.

string

auditDomainType
optional

The auditing domain type. 0=INVALID, 1=ACTIVE_DIRECTORY, 2=NIS_PLUS, 3=VXAT_PRIVATE, 4=UNIX_PASSWORD, 5=NIS, 6=LOCAL_HOST, 7=UNKNOWN_AUTH

integer (int64)

auditUserName
optional

The user name in the audit record.

string

backupId
optional

The backup ID or image ID.

string

clientName
optional

The name of the client to be protected.

string

compression
optional

Indicates if compression is enabled for the backup policy. 0=disabled, 1=enabled

integer (int64)

controlHost
optional

The host from which the job was initiated.

string

copyNumber
optional

The backup image copy number.

integer (int64)

currentFile
optional

The current file being protected.

string

currentOperation
optional

The current operation being performed. Negative values should be ignored. 0=MOUNTING, 1=POSITIONING, 2=CONNECTING, 3=WRITING, 4=VLT_INIT, 5=VLT_DUPIMG, 6=VLT_DUPCMP, 7=VLT_BK_NBCAT, 8=VLT_EJRPT, 9=VLT_COMPLETE, 10=READING, 11=DUPLICATE, 12=IMPORT, 13=VERIFY, 14=RESTORE, 15=BACKUPDB, 16=VAULT, 17=LABEL, 18=ERASE, 19=SYNTH_DBQUERY, 20=SYNTH_PROCESS_EXTENTS, 21=SYNTH_PLAN, 22=CREATE_SNAPSHOT, 23=DELETE_SNAPSHOT, 24=RECOVERDB, 25=MCONTENTS, 26=SYNTH_REQUERESOURCES, 27=PARENT_JOB, 28=INDEXING, 29=REPLICATE, 30=RUNNING, 31=ASSEMBLING_FILE_LIST, 32=ALLOCATING_MEDIA

integer (int64)

dataMovement
optional

The type of data movement used for this job.

enum (STANDARD, INSTANTRECOVERYDISK, INSTANTRECOVERYDISKANDTAPE, SYNTHETIC, DISKSTAGING, SNAPSHOT)

dedupRatio
optional

The deduplication rate achieved.

number (float)

destinationMediaId
optional

The destination media server. Used for deduplication jobs.

string

destinationMediaServerName
optional

The destination media server name. Used for deduplication jobs.

string

destinationStorageUnitName
optional

The destination storage unit. Used for deduplication jobs.

string

done
optional

Indicates if the job is complete.

integer (int64)

dumpHost
optional

The recovery appliance host name for Copilot.

string

endTime
optional

The job end time.

string (date-time)

estimatedFiles
optional

The estimated number of files to be protected.

integer (int64)

frozenImage
optional

Used internally to flag snapshots. Also used to determine if the job type is snapshot.

integer (int64)

initiatorId
optional

The initiator of the job.

string

instanceDatabaseName
optional

The database instance and/or database name itself.

string

jobGroup
optional

The group name of the job initiator.

string

jobId
optional

The job identifier.

integer (int64)

jobOwner
optional

The user name of the job initiator.

string

jobQueueReason
optional

The reason the job is queued. A value of -99 indicates that an invalid value was returned. 1=MEDIA_IN_USE, 2=DRIVES_IN_USE, 3=MEDIA_SERVER_OFFLINE, 4=ROBOT_DOWN, 5=MAX_STORAGE_UNIT_JOBS, 6=MEDIA_REQUEST_DELAY, 7=LOCAL_DRIVES_DOWN, 8=MEDIA_IN_DRIVE_IN_USE, 9=PHYSICAL_DRIVE_UNAVAILABLE, 10=CLEANING_MEDIA_UNAVAILABLE, 11=DRIVE_SCAN_HOST_OFFLINE, 12=DISK_MEDIA_SERVER_OFFLINE, 13=NO_MASTER_MEDIA_CONNECTIVITY, 14=MEDIA_SERVER_NON_ACTIVE_MODE, 15=STORAGEUNIT_JOB_COUNTS_THROTTLED, 16=JOB_HISTORY_DRIVES_IN_USE, 17=DISK_VOLUME_UNAVAILABLE, 18=MAX_CONCURRENT_VOLUME_READERS, 19=DISK_GROUP_UNAVAILABLE, 20=FAT_PIPE_IN_USE, 21=DISK_VOLUME_UNMOUNTING, 22=DISK_VOLUME_IN_USE, 23=MAX_PARTIAL_MEDIA, 24=LOGICAL_RESOURCE, 25=DRIVES_IN_STORAGE_UNIT_IN_USE, 26=STOP_DRIVE_SCAN, 27=DISK_VOLUME_MOUNTING, 28=MOUNT_FILE_EXISTS, 29=PENDING_ACTION, 30=DISK_VOLUME_STREAM_LIMIT

integer (int64)

jobQueueResource
optional

The name of the resource for which the queued job is waiting.

string

jobSubType
optional

The job sub-type.

enum (IMMEDIATE, SCHEDULED, USERBACKUP, ERASETYPE_QUICK, ERASETYPE_LONG, DBBACKUP_STAGING, DBBACKUP_COLD, RMAN_CATALOG)

jobType
optional

The job type.

enum (BACKUP, ARCHIVE, RESTORE, VERIFY, DUPLICATE, IMPORT, DBBACKUP, VAULT, LABEL, ERASE, TPREQ, TPCLEAN, TPFORMAT, VMPHYSINV, DQTS, DBRECOVER, MCONTENTS, IMAGEDELETE, LIVEUPDATE, GENERIC, REPLICATE, REPLICA_IMPORT, SNAPDUPE, SNAPREPLICATE, SNAPIMPORT, APP_STATE_CAPTURE, INDEXING, INDEXCLEANUP, SNAPSHOT, SNAPINDEX, ACTIVATE_IR, DEACTIVATE_IR, REACTIVATE_IR, STOP_IR, INSTANT_RECOVERY, RMAN_CATALOG, LOCKVM)

killable
optional

Indicates if the job can be stopped.

integer (int64)

kilobytesDataTransferred
optional

The actual data transferred in kilobytes. For some jobs, data transferred is different than the final image size.

integer (int64)

kilobytesToTransfer
optional

The remaining kilobytes to be transferred.

integer (int64)

kilobytesTransferred
optional

The estimated amount of data transferred in kilobytes.

integer (int64)

lastUpdateTime
optional

The UTC timestamp when the job was modified.

string (date-time)

mainProcessId
optional

The process ID of the main controlling process for restore and image cleanup.

integer (int64)

numberOfFiles
optional

The actual number of files protected.

integer (int64)

numberOfTapeToEject
optional

For vault jobs, the total number of tape media to be ejected.

integer (int64)

parentJobId
optional

The parent job ID.

integer (int64)

percentComplete
optional

The estimated completion percentage of this job.

integer (int64)

policyName
optional

The name of the policy used by this job.

string

policyType
optional

The backup policy type used by the job.

enum (STANDARD, PROXY, NONSTANDARD, APOLLO_WBAK, OBACKUP, ANY, INFORMIX, SYBASE, SHAREPOINT, WINDOWS, NETWARE, BACKTRACK, AUSPEX_FASTBACK, WINDOWS_NT, OS2, SQL_SERVER, EXCHANGE, SAP, DB2, NDMP, FLASHBACKUP, SPLITMIRROR, AFS, DFS, DATASTORE, LOTUS_NOTES, NCR_TERADATA, VAX_VMS, HP3000_MPE, FBU_WINDOWS, VAULT, BE_SQL_SERVER, BE_EXCHANGE, MAC, DS, NBU_CATALOG, GENERIC, CMS_DB, PUREDISK_EXPORT, ENTERPRISE_VAULT, VMWARE, HYPERV, NBU_SEARCHSERVER, HYPERSCALE, BIGDATA)

priority
optional

The priority of this job.

integer (int64)

productType
optional

The product type number.

integer (int64)

profileName
optional

The name of the Vault profile.

string

restartable
optional

Indicates if the job can be restarted.

integer (int64)

restoreBackupIDs
optional

The list of backup IDs needed for the restore job.

string

resumable
optional

Indicates if the job can be resumed.

integer (int64)

retentionLevel
optional

The retention level of the backup image.

integer (int64)

robotName
optional

The name of the robot in the Vault job.

string

scheduleName
optional

The name of the backup schedule used by the backup job.

string

scheduleType
optional

The type of schedule used by the backup job.

enum (FULL, DIFFERENTIAL_INCREMENTAL, USER_BACKUP, USER_ARCHIVE, CUMULATIVE_INCREMENTAL, TRANSACTION_LOG)

sessionId
optional

The Vault session ID.

integer (int64)

sourceMediaId
optional

The source media ID for the duplication job.

string

sourceMediaServerName
optional

The source media server name for the duplication job.

string

sourceStorageUnitName
optional

The source storage unit.

string

startTime
optional

The UTC timestamp when the job was started.

string (date-time)

state
optional

The current state of the job.

enum (QUEUED, ACTIVE, REQUEUED, DONE, SUSPENDED, INCOMPLETE)

status
optional

The final job status code.

integer (int64)

streamNumber
optional

The job stream number.

integer (int64)

submissionType
optional

The job submission type.

integer (int64)

suspendable
optional

Indicates if the job can be suspended.

integer (int64)

transferRate
optional

The data transfer rate in kilobytes (KB) per second.

integer (int64)

transportType
optional

The data transport type used for the job.

enum (LAN, FAT)

try
optional

The current try number to execute this job.

integer (int64)

vaultName
optional

The Vault name used by the job.

string

Name Schema

file-lists
optional

file-lists

self
optional

self

try-logs
optional

try-logs

file-lists

Name Schema

href
optional

string

self

Name Schema

href
optional

string

try-logs

Name Schema

href
optional

string

getJobFileListResponse

Name Schema

data
optional

data

data

Name Schema

attributes
optional

attributes

id
optional

integer (int64)

links
optional

links

type
optional

string

attributes

Name Schema

fileList
optional

< string > array

Name Schema

self
optional

self

Name Schema

href
optional

string

getJobResponse

Name Schema

data
optional

getJobDetailsResponse

getJobTryLogsResponse

Name Schema

data
optional

data

data

Name Schema

attributes
optional

attributes

id
optional

integer (int64)

links
optional

links

type
optional

string

attributes

Name Schema

log
optional

< string > array

Name Schema

self
optional

self

Name Schema

href
optional

string

getJobsResponse

Name Schema

data
optional

< getJobDetailsResponse > array

links
optional

links

meta
optional

meta

Name Schema

first
optional

first

last
optional

last

next
optional

next

prev
optional

prev

self
optional

self

first

Name Schema

href
optional

string

last

Name Schema

href
optional

string

next

Name Schema

href
optional

string

prev

Name Schema

href
optional

string

self

Name Schema

href
optional

string

meta

Name Schema

pagination
optional

pagination

pagination

Name Schema

count
optional

integer (int64)

first
optional

integer (int64)

last
optional

integer (int64)

limit
optional

integer (int64)

next
optional

integer (int64)

offset
optional

integer (int64)

page
optional

integer (int64)

pages
optional

integer (int64)

prev
optional

integer (int64)

Security

rbacSecurity

Type : apiKey
Name : Authorization
In : HEADER

NetBackup Asset API

Overview

The NetBackup Asset API provides access to NetBackup asset information.

Version information

Version : 2.0

URI scheme

Host : <masterserver>:1556
BasePath : /netbackup
Schemes : HTTPS

Paths

POST /asset-groups

Description

Creates a new asset group. Currently the only workload type accepted by this API is VMware. When creating a filter for the asset group, asset filtering is supported for the following attributes:

Name Supported Operators Description Schema

extendedAttributes/instanceUuid

eq ne contains startswith endswith

The asset’s instance UUID.

string

extendedAttributes/vCenter

eq ne ge gt le lt contains startswith endswith

The vCenter name of the VMware asset.

string

extendedAttributes/hostName

eq ne ge gt le lt contains startswith endswith

The host name of the VMware asset.

string

extendedAttributes/vmFolder

eq ne ge gt le lt containts startswith endswith

The folder of the VMware asset.

string

extendedAttributes/dnsName

eq ne ge gt le lt contains startswith endswith

The DNS name of the asset.

string

extendedAttributes/tag

eq ne ge gt le lt contains startswith endswith

The VMware asset tag.

string

extendedAttributes/resourcepool

eq ne ge gt le lt contains startswith endswith

The VMware asset resource pool.

string

extendedAttributes/powerState

eq ne

The power state of the virtual machine.

string

extendedAttributes/host

eq ne ge gt le lt contains startswith endswith

The ESXi server.

string

extendedAttributes/displayName

eq ne ge gt le lt contains startswith endswith

The display name of the asset.

string

extendedAttributes/datastoreCluster

eq ne ge gt le lt contains startswith endswith

The datastore cluster of the VMware asset.

string

extendedAttributes/datastore

eq ne ge gt le lt contains startswith endswith

The datastore of the VMware asset.

string

extendedAttributes/datacenter

eq ne ge gt le lt contains startswith endswith

The datacenter of the VMware asset.

string

extendedAttributes/cluster

eq ne ge gt le lt contains startswith endswith

The cluster of the VMware asset.

string

Requires Permission: [Manage Appservers and Asset Groups]

Parameters

Type Name Description Schema

Body

newAssetGroupDetails
required

Specifies the JSON body that contains asset information. This request payload may not exceed 2 MB in size.

postAssetGroupRequest

Responses

HTTP Code Description Schema

201

Successfully created the group record in the asset database.

assetGroupDetail

400

The request body is not valid.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

409

The resource already exists.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

GET /asset-groups

Description

Retrieves the list of asset groups based on the specified filters. If no filters are specified, information for the newest 10 asset groups are retrieved, sorted in ascending order by their displayName. All the filters are based on OData standards. Filtering is supported for the following attributes:

Name Supported Operators Description Schema

id

eq ne

Specifies the asset group’s GUID.

string

displayName

eq ne ge gt le lt contains startswith endswith

Specifies the asset group’s display name.

string

description

eq ne ge gt le lt contains startswith endswith

Specifies the asset group’s description.

string

createdDateTime

eq ne ge gt le lt

The asset group’s creation time in ISO 8601 format.

date-time

lastModifiedDateTime

eq ne ge gt le lt

The asset group’s last modified time in ISO 8601 format.

date-time

assetType

eq ne ge gt le lt contains startswith endswith

Specifies the group’s asset type.

string

workloadType

eq ne ge gt le lt contains startswith endswith

Specifies the group’s workload type.

string

filterConstraint

eq ne ge gt le lt contains startswith endswith

Specifies the filter constraint.

string

Requires Permission: [Manage Assets, Manage Appservers and Asset Groups]

Parameters

Type Name Description Schema Default

Query

filter
optional

Specifies filters according to OData standards.

string

Query

page[limit]
optional

The maximum number of asset group records on one page.

integer

10

Query

page[offset]
optional

The asset group record number offset.

integer

0

Query

sort
optional

Sort in ascending order on the specified property. Prefix with '-' for descending order.

string

"displayName"

Responses

HTTP Code Description Schema

200

Retrieved the asset groups based on the applied filters.

getAssetGroupsResponse

400

Invalid filter criteria.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

GET /asset-groups/{assetGroupGuid}

Description

Retrieves the details of the asset group.

Requires Permission: [Manage Assets, Manage Appservers and Asset Groups]

Parameters

Type Name Description Schema

Path

assetGroupGuid
required

An asset group’s global unique identifier.

string

Responses

HTTP Code Description Schema

200

Request successful.

assetGroupDetail

400

Malformed asset group GUID.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No asset group was found based on the given GUID.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

DELETE /asset-groups/{assetGroupGuid}

Description

Deletes the asset group specified by the GUID.

Requires Permission: [Manage Appservers and Asset Groups]

Parameters

Type Name Description Schema

Path

assetGroupGuid
required

An asset group’s global unique identifier.

string

Responses

HTTP Code Description Schema

204

Successfully deleted the asset group.

No Content

400

Malformed asset group ID.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No asset group was found based on the given GUID.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

PATCH /asset-groups/{assetGroupGuid}

Description

Replaces all or some the details of the existing asset group with the specified details.

Requires Permission: [Manage Appservers and Asset Groups]

Parameters

Type Name Description Schema

Path

assetGroupGuid
required

An asset group’s global unique identifier.

string

Body

assetGroupDetails
required

Specifies the JSON body that contains the updated asset information. This request payload may not exceed 2 MB in size.

patchAssetGroupRequest

Responses

HTTP Code Description Schema

200

Successfully updated the asset group.

assetGroupDetail

400

Malformed asset group GUID, or the request body is not valid.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No asset group was found based on the given GUID.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

POST /assets

Description

Creates a new entry in the asset database. This operation is a batch request to store asset data, which is a result of auto-discovery for different workloads.

Requires Permission: [Manage NetBackup]

This API is used by NetBackup hosts to post discovered assets to the asset database.

Parameters

Type Name Description Schema

Body

body
required

Specifies the JSON body that contains asset information. This request payload may not exceed 2 MB.

postAssetsRequest

Responses

HTTP Code Description Schema

201

Successfully created the record in the asset database.

postAssetsResponse

400

The request body is not valid.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

GET /assets

Description

Retrieves the list of assets based on specified filters. If no filters are specified, information for 10 assets are retrieved, and sorted in descending order based on the time the assets were discovered. All the filters are based on OData standards. Filtering is supported for the following attributes:

Name Supported Operators Description Schema

providerGeneratedID

eq ne gt ge lt le and or not () contains endswith startswith

ID given to an asset by its workload.

string

displayName

eq ne gt ge lt le and or not () contains endswith startswith

Specifies an asset’s name.

string

description

eq ne gt ge lt le and or not () contains endswith startswith

Describes an asset.

string

version

eq ne gt ge lt le and or not () contains endswith startswith

Specifies version number.

string

firstDiscoveryTime

eq ne gt ge lt le and or not () contains endswith startswith

Specifies the first time an asset was discovered in ISO 8601 format.

date-time

lastDiscoveryTime

eq ne gt ge lt le and or not () contains endswith startswith

Specifies the most recent time an asset was discovered in ISO 8601 format.

date-time

assetType

eq ne gt ge lt le and or not () contains endswith startswith

Specifies asset type. Could be a VM, ESX Server, etc.

string

workloadType

eq ne gt ge lt le and or not () contains endswith startswith

Specifies the workload type. Possible values: CLOUD ORACLE SQL_SERVER VMWARE HYPER_V UNIX_FS WINDOWS_FS

string

extendedAttributes/{extendedAttributeName}

eq ne gt ge lt le and or not () contains endswith startswith

Specifies the dynamic extended attribute key and value.

object

Requires Permission: [View Assets, Manage Assets]

Parameters

Type Name Description Schema Default

Query

filter
optional

Specifies filters according to OData standards.

string

Query

include
optional

Appends a section in the response payload with details about the relationships that are specified in the include query.

enum (assetGroups)

Query

page[limit]
optional

The number of records on one page, after the offset.

integer

10

Query

page[offset]
optional

The asset record number offset.

integer

0

Query

sort
optional

Sort in ascending order on the specified property. Prefix with "-" for descending order.

string

"-lastDiscoveredTime"

Responses

HTTP Code Description Schema

200

Retrieved the assets based on the applied filters.

getAssetsResponse

400

Invalid filter criteria.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No assets were found based on the specified query or filters.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

POST /assets/asset-cleanup

Description

Cleans up assets from the database. This API cleans up assets from the given list whose lastDiscoveredTime is older than the given cleanupTime, do not have a backup status, and are not individually subscribed to a protection plan.

Requires Permission: [Manage NetBackup]

Parameters

Type Name Description Schema

Body

postAssetCleanupRequest
required

Specifies the JSON body that contains asset cleanup information.

postAssetCleanupRequest

Responses

HTTP Code Description Schema

204

Successfully cleaned up assets.

No Content

400

Malformed cleanup time.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

GET /assets/{GUID}

Description

Retrieves the details of the asset.

Requires Permission: [View Assets, Manage Assets]

Parameters

Type Name Description Schema

Path

GUID
required

An asset’s global unique identifier.

string

Query

include
optional

Appends a section in the response payload with details about the relationships that are specified in the include query.

enum (assetGroups)

Responses

HTTP Code Description Schema

200

Request successful.

assetDetail

400

Invalid asset ID.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No assets were found based on the specified query or filters.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

GET /assets/{GUID}/asset-groups

Description

Retrieves the asset groups to which the given asset belongs.

Requires Permission: [View Assets, Manage Assets]

Parameters

Type Name Schema

Path

GUID
required

string

Responses

HTTP Code Description Schema

200

Request successful.

relatedResources

400

Malformed asset GUID.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No asset was found based on the given GUID.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

POST /preview-asset-group

Description

Retrieves a list of assets that would be included in an asset group without actually creating one.

Requires Permission: [Manage Assets, Manage Appservers and Asset Groups]

Parameters

Type Name Description Schema

Body

previewDetails
required

Specifies the details needed to preview the list of assets for this asset group.

postAssetGroupPreviewRequest

Responses

HTTP Code Description Schema

200

Retrieved the assets based on the applied filters.

getAssetsResponse

400

Malformed filter.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

Definitions

Name Schema

first
optional

first

last
optional

last

next
optional

next

prev
optional

prev

self
optional

self

Name Schema

href
optional

string

Name Schema

href
optional

string

Name Schema

href
optional

string

Name Schema

href
optional

string

Name Schema

href
optional

string

assetAttributesRequest

Name Description Schema

assetType
required

The type of the asset that is provided by the workload.
Maximal length : 128

string

description
optional

The description of the asset.

string

discoveryHosts
optional

The list of NetBackup hosts that have discovered this asset. When an asset is updated with new discovery hosts, they will be appended to the existing list of discovery hosts.

< machine > array

displayName
optional

The display name of this asset in the NetBackup Web UI.
Maximal length : 1024

string

extendedAttributes
optional

The workload attributes that can be searched. Values are truncated if they exceed the character-length limit.

< string, AnyValue > map

firstDiscoveredTime
optional

The ISO 8601 formatted time at which the asset was first discovered.

string (date-time)

lastDiscoveredTime
required

The ISO 8601 formatted time at which the asset was last discovered.

string (date-time)

masters
required

The list of NetBackup master servers associated with this asset. When an asset is updated with new master servers, they will be appended to the existing list of master servers.

< machine > array

properties
optional

All the workload-specific data. This data cannot be searched.

string

protectionMethods
optional

The protection methods that are available for this asset.

< protectionMethods > array

providerGeneratedId
required

The provider identifier, which is unique within the workloadType context that is provided by the workload.
Maximal length : 1024

string

version
optional

The version of the asset.
Maximal length : 128

string

workloadType
required

The workload type to which this asset belongs.
Maximal length : 64

string

protectionMethods

Name Description Schema

protectionMethodName
optional

Maximal length : 128

string

assetAttributesResponse

Name Description Schema

assetLastBackupStatuses
optional

lastBackupStatusList

assetSubscriptions
optional

assetSubscriptionList

assetType
required

The type of the asset that is provided by the workload.
Maximal length : 128

string

description
optional

The description of the asset.

string

discoveryHosts
optional

The list of NetBackup hosts that have discovered this asset. When an asset is updated with new discovery hosts, they will be appended to the existing list of discovery hosts.

< machine > array

displayName
optional

The display name of this asset in the NetBackup Web UI.
Maximal length : 1024

string

extendedAttributes
optional

The workload attributes that can be searched. Values are truncated if they exceed the character-length limit.

< string, AnyValue > map

firstDiscoveredTime
optional

The ISO 8601 formatted time at which the asset was first discovered.

string (date-time)

lastDiscoveredTime
required

The ISO 8601 formatted time at which the asset was last discovered.

string (date-time)

masters
required

The list of NetBackup master servers associated with this asset. When an asset is updated with new master servers, they will be appended to the existing list of master servers.

< machine > array

properties
optional

All the workload-specific data. This data cannot be searched.

string

protectionMethods
optional

The protection methods that are available for this asset.

< protectionMethods > array

providerGeneratedId
required

The provider identifier, which is unique within the workloadType context that is provided by the workload.
Maximal length : 1024

string

version
optional

The version of the asset.
Maximal length : 128

string

workloadType
required

The workload type to which this asset belongs.
Maximal length : 64

string

protectionMethods

Name Description Schema

protectionMethodName
optional

Maximal length : 128

string

assetDetail

Name Schema

data
required

getAsset

included
optional

< includedAssetGroupInfo > array

assetGroup

Name Description Schema

attributes
required

assetGroupAttributes

id
required

The global unique identifier (GUID) of the asset group.

string

links
required

Contains links to related APIs.

links

type
required

The type of resource. This should always be "assetGroup".

string

Name Schema

self
optional

self

self

Name Schema

href
optional

string

assetGroupAttributes

Name Description Schema

assetGroupSubscriptions
optional

The list of protection plans this asset group is subscribed to.

< assetGroupSubscriptions > array

assetType
required

The name of the asset type contained within this asset group.

string

createdDateTime
required

The timestamp that indicates when the asset group was created, in ISO 8601 format.

string (date-time)

description
optional

The description of the asset group.

string

displayName
required

The display name of the asset group.

string

filterConstraint
required

The filter constraint. For VMware workloads, this indicates the vCenter or the ESXi host name.

string

lastModifiedDateTime
required

The timestamp that indicates when the asset group was last modified, in ISO 8601 format.

string (date-time)

oDataQueryFilter
required

The filter criteria in OData query format.

string

vipQueryFilter
optional

The filter criteria in VIP query format, converted from the oDataQueryFilter.

string

workloadType
required

The name of the workload type contained within this asset group.

enum (VMware)

assetGroupSubscriptions

Name Description Schema

policyName
required

The NetBackup policy that is used when the asset group is protected.

string

sloId
required

The unique ID of the protection plan protecting the asset group.

string

sloName
required

Name of the protection plan protecting the asset group.

string

subscriptionId
required

The unique ID of the asset group’s subscription to the protection plan.

string

assetGroupDetail

Name Schema

data
required

assetGroup

assetSubscription

Asset subscription details.

Name Description Schema

sloId
optional

The unique ID of the protection plan protecting the asset.

string

sloName
optional

Name of the protection plan protecting the asset.

string

subscriptionId
optional

The unique ID of the asset’s subscription to the protection plan.

string

assetSubscriptionList

List of asset subscriptions.

Type : < assetSubscription > array

createAssetGroupAttributes

Name Description Schema

assetType
required

The name of the asset type contained within this asset group.

string

description
optional

The description of the asset group. Maximum 1024 characters.

string

displayName
required

The display name of the asset group. Maximum 256 characters.

string

filterConstraint
required

The filter constraint. For VMware workloads, this indicates the vCenter or the ESXi host name.

string

oDataQueryFilter
optional

The filter criteria in OData query format. Maximum 4096 characters. If no filter is supplied, all assets matching the filter constraint will be included.

string

workloadType
required

The name of the workload type contained within this asset group.

enum (VMware)

errorResponse

Name Description Schema

details
optional

A map containing error field and error field message to provide more context to nature of the error.

object

errorCode
required

The NetBackup error code.

integer (int64)

errorMessage
required

The NetBackup error code description.

string

getAsset

Name Description Schema

attributes
optional

assetAttributesResponse

id
required

The global unique identifier (GUID) of the asset.

string

links
required

links

relationships
optional

relationships

type
required

Type as 'asset'

enum (asset)

Name Schema

self
optional

self

self

Name Schema

href
optional

string

relationships

Name Schema

assetGroups
optional

relatedResources

getAssetGroupsResponse

Name Schema

data
required

< assetGroup > array

links
required

allLinks

meta
required

meta

meta

Name Schema

pagination
optional

paginationAttributes

getAssetsResponse

Name Schema

data
required

< getAsset > array

included
optional

< includedAssetGroupInfo > array

links
required

allLinks

meta
optional

meta

meta

Name Schema

pagination
optional

paginationAttributes

includedAssetGroupInfo

Name Schema

attributes
required

attributes

id
required

string

type
required

string

attributes

Name Description Schema

displayName
required

The display name of the asset group.

string

lastBackupStatusAttributes

Name Description Schema

backupTime
required

The ISO 8601 formatted time when the asset was last backed up.

string (date-time)

jobId
required

The NetBackup job ID that last protected the asset.

integer

jobStatus
required

The status of the last job.

integer

masterUuid
required

The NetBackup master server UUID protecting the asset.

string

policyName
required

The NetBackup policy that is used when the asset is protected.

string

scheduleName
required

The NetBackup schedule name used when protecting the asset.

string

scheduleType
required

The NetBackup schedule type used when protecting the asset.

enum (FULL, DIFFERENTIAL_INCREMENTAL, CUMULATIVE_INCREMENTAL, USER_BACKUP, USER_ARCHIVE, TRANSACTION_LOG)

lastBackupStatusList

Type : < lastBackupStatusAttributes > array

machine

Name Description Schema

hostName
required

Maximal length : 1024

string

ipAddress
optional

Maximal length : 20

string

uuid
required

Maximal length : 1024

string

paginationAttributes

Name Schema

count
optional

integer

first
optional

integer

last
optional

integer

limit
optional

integer

next
optional

integer

offset
optional

integer

page
optional

integer

pages
optional

integer

prev
optional

integer

patchAssetGroupRequest

Specifies all or some fields of an asset group record in the database to be updated.

Name Schema

data
required

data

data

Name Schema

attributes
required

updateAssetGroupAttributes

postAssetCleanupRequest

Specifies the request body for cleaning up assets in the database.

Name Schema

data
required

data

data

Name Description Schema

attributes
required

attributes

type
required

The type of data being represented.

enum (assetCleanup)

attributes

Name Description Schema

assetIds
required

The list of global unique identifiers (GUID) of the assets to be deleted.

< string > array

cleanupTime
required

Specifies an ISO-8601 formatted time. Assets from the given list that were discovered before this time are eligible to be deleted.

string (date-time)

postAssetGroupPreviewRequest

Specifies the necessary information to preview the list of assets for an asset group before it is created.

Name Schema

data
required

data

data

Name Description Schema

attributes
required

attributes

type
required

The type of data being represented.

enum (assetGroupPreview)

attributes

Name Description Schema

filterConstraint
required

The filter constraint. For VMware workloads, this indicates the vCenter or the ESXi host name.

string

oDataQueryFilter
optional

The filter criteria in OData query format. Maximum 4096 characters. If no filter is supplied, all assets matching the filter constraint will be returned.

string

pageLimit
optional

The number of asset records on one page.

integer

pageOffset
optional

The page offset for pagination.

integer

sort
optional

Sort in ascending order on the specified property. Prefix with '-' for descending order.
Default : "-lastDiscoveredTime"

string

workloadType
required

The name of the workload type contained within this asset group.

enum (VMware)

postAssetGroupRequest

Creates a record in the database to store asset group details.

Name Schema

data
required

data

data

Name Description Schema

attributes
required

createAssetGroupAttributes

type
required

This should always be set to "assetGroup"

string

relatedResources

Name Schema

data
optional

< data > array

links
optional

links

meta
optional

meta

data

Name Schema

id
optional

string

type
optional

string

Name Schema

related
optional

related

self
optional

self

Name Schema

href
optional

string

self

Name Schema

href
optional

string

meta

Name Schema

pagination
optional

paginationAttributes

updateAssetGroupAttributes

Name Schema

description
optional

string

displayName
optional

string

odataFilterCriteria
optional

string

Security

rbacSecurity

Type : apiKey
Name : Authorization
In : HEADER

NetBackup Catalog API

Overview

The NetBackup Catalog API provides access to the NetBackup catalog.

Version information

Version : 2.0

URI scheme

Host : <masterserver>:1556
BasePath : /netbackup
Schemes : HTTPS

Paths

GET /catalog/images

Description

Returns the list of images based on the specified filters. All the filters are based on OData standards and filtering on the following attributes is supported.

Name Supported Operators Description Schema

backupId

eq

The identifier for the backup image.

string

backupTime

ge le

The backup time range in ISO 8601 format. By default, backupTime ge is set to 24 hours ago and backupTime le is set to the current time.

date-time

clientName

eq

The client name.

string

policyType

eq

The policy type.

string

policyName

eq

The policy name.

string

scheduleType

eq

The schedule type. Possible values: FULL DIFFERENTIAL_INCREMENTAL USER_BACKUP USER_ARCHIVE CUMULATIVE_INCREMENTAL

string

providerGeneratedId

eq

The provider generated id.

string

Requires Permission: [View Recovery Points, Recover/Restore, Instant Access, Download Files, Restore Files]

Parameters

Type Name Description Schema Default

Query

filter
optional

The filter criteria in OData format.

string

Query

page[limit]
optional

The number of images on one page.

integer

10

Query

page[offset]
optional

The image record number offset.

integer

0

Responses

HTTP Code Description Schema

200

Returned the list of catalog images based on the filter criteria.

imageList

400

Invalid filter criteria.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

GET /catalog/images/contents/{requestId}

Description

Gets the next page of file contents for the specified request ID. Continue to call this API with the same request ID to retrieve all files for the image specified with the request ID. When there are no more contents to retrieve, this API returns status 404, and the request ID is deleted automatically. The pagination values 'last' and 'first' are for informational purpose only. These values cannot be used to traverse to the last or the first page in the image contents array. Note that there is a timeout between calls of this API. Each successful call to this API resets the timeout. The timeout limit is 6 minutes.

Requires Permission: [Recover/Restore, Instant Access, Download Files, Restore Files]

Parameters

Type Name Schema

Path

requestId
required

string

Responses

HTTP Code Description Schema

200

Returned the next page of file contents successfully.

imageContents

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

The request ID was not found, or the user has already retrieved the last page of contents.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

DELETE /catalog/images/contents/{requestId}

Description

Deletes the specified request ID.

Requires Permission: [Recover/Restore, Instant Access, Download Files, Restore Files]

Parameters

Type Name Schema

Path

requestId
required

string

Responses

HTTP Code Description Schema

204

Request ID deleted successfully.

No Content

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

The request ID was not found.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

GET /catalog/images/{backupId}

Description

Requests the details of an image.

Requires Permission: [View Recovery Points, Recover/Restore, Instant Access, Download Files, Restore Files]

Parameters

Type Name Schema

Path

backupId
required

string

Responses

HTTP Code Description Schema

200

Image details were returned successfully.

imageDetail

400

The backup ID is invalid.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No images were found with the specified backup ID.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

GET /catalog/images/{backupId}/contents

Description

Gets a request ID that is used to retrieve the file contents of an image.

Requires Permission: [Recover/Restore, Instant Access, Download Files, Restore Files]

Parameters

Type Name Description Schema Default

Path

backupId
required

The backup ID of the specified image.

string

Query

page[limit]
optional

The number of file contents on one page rounded to the next highest multiple of 50.

integer

200

Responses

HTTP Code Description Schema

202

Generated a request ID for the search.

requestId

400

The format of the backup ID is invalid.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No images were found with the specified backup ID.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

GET /catalog/latest-vmware-images

Description

Gets the list of VMware images based on the specified filters, then only returns the latest backed up image per unique client. If no filters are specified, page[offset] defaults to 0 and page[limit] defaults to 10. All of the filters are based on OData standards. Filtering on the following attributes is supported:

Name Supported Operators Description Schema

vCenter

eq ge gt le lt contains startswith endswith

Specifies the vCenter Server that the machine belonged to.

string

instanceUUID

eq

Specifies the Instance UUID of the machine.

uuid

backupTime

eq ge gt le lt

The backup time range in ISO 8601 format. If one of backupTime eq/ge/gt is not set, backupTime ge is set to 24 hours ago by default.

date-time

vmDisplayName

eq ge gt le lt contains startswith endswith

Specifies the virtual machine display name.

string

vmHostName

eq ge gt le lt contains startswith endswith

Specifies the virtual machine host name.

string

biosUUID

eq ge gt le lt contains startswith endswith

Specifies the virtual machine BIOS UUID.

uuid

vmDNSName

eq ge gt le lt contains startswith endswith

Specifies the virtual machine DNS name.

string

client

eq ge gt le lt contains startswith endswith

Specifies client machine name of the virtual machine.

string

Requires Permission: [View Recovery Points, Recover/Restore, Instant Access, Download Files, Restore Files]

Parameters

Type Name Description Schema Default

Query

filter
optional

The filter criteria in OData format.

string

Query

page[limit]
optional

The number of images on one page.

integer

10

Query

page[offset]
optional

The image record number offset.

integer

0

Responses

HTTP Code Description Schema

200

The list of catalog VMware images was returned successfully.

vmwareImageList

400

Invalid filter criteria.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

GET /catalog/vmware-images

Description

Gets the list of VMWare images based on the specified filters. If no filters are specified, page[offset] defaults to 0 and page[limit] defaults to 10. All of the filters are based on OData standards. Filtering on the following attributes is supported:

Name Supported Operators Description Schema

vCenter

eq ge gt le lt contains startswith endswith

Specifies the vCenter Server that the machine belonged to.

string

instanceUUID

eq

Specifies the Instance UUID of the machine.

uuid

backupTime

eq ge gt le lt

The backup time range in ISO 8601 format. If one of backupTime eq/ge/gt is not set, backupTime ge is set to 24 hours ago by default.

date-time

vmDisplayName

eq ge gt le lt contains startswith endswith

Specifies the virtual machine display name.

string

vmHostName

eq ge gt le lt contains startswith endswith

Specifies the virtual machine host name.

string

biosUUID

eq

Specifies the virtual machine BIOS UUID.

uuid

vmDNSName

eq ge gt le lt contains startswith endswith

Specifies the virtual machine DNS name.

string

client

eq ge gt le lt contains startswith endswith

Specifies client machine name of the virtual machine.

string

Requires Permission: [View Recovery Points, Recover/Restore, Instant Access, Download Files, Restore Files]

Parameters

Type Name Description Schema Default

Query

filter
optional

The filter criteria in OData format.

string

Query

page[limit]
optional

The number of images on one page.

integer

10

Query

page[offset]
optional

The image record number offset.

integer

0

Responses

HTTP Code Description Schema

200

The list of catalog VMWare images was returned successfully.

vmwareImageList

400

Invalid filter criteria.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

GET /catalog/vmware-images/{backupId}

Description

Requests the details of a VMware image. The following relationship may be used in the include parameter:

Name Description

optionalVmwareInfo

Currently includes vmNetworks and vmDisks

Requires Permission: [View Recovery Points, Recover/Restore, Instant Access, Download Files, Restore Files]

Parameters

Type Name Description Schema

Path

backupId
required

The backup ID of the specified VMware image.

string

Query

include
optional

Optional relationships to include.

string

Responses

HTTP Code Description Schema

200

VMware image details returned successfully.

vmwareImageDetail

400

The backup ID is invalid.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

The VMware image was not found.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacSecurity

Definitions

diskInfo

Name Description Schema

filePath
required

The path at which the disk file resides.

string

fileSize
required

The uncompressed size in bytes.

integer (int64)

lastModifiedTime
optional

The ISO 8601 timestamp that indicates when the disk file was last modified.

string (date-time)

errorResponse

Name Description Schema

details
optional

A map containing error field and error field message to provide more context to nature of the error.

object

errorCode
required

The NetBackup error code.

integer (int64)

errorMessage
required

The NetBackup error code description.

string

fragment

Name Description Schema

blockSize
optional

The block size used when writing the backup.

integer

checkpoint
optional

Internal use.

integer

copyDate
optional

For the first fragment of each copy in NetBackup 6.5 and later, the ISO-8601 timestamp on which the copy was written. The value is 0 for versions before NetBackup 6.5.

string (date-time)

copyNumber
optional

The copy number for this record.

integer

dataFormat
optional

The backup data format. These enums are the same as the "data format types" in NetBackup (for example, DF_TAR, DF_SNAPSHOT and DF_NDMP).

enum (TAR, SNAPSHOT, NDMP_DUMP)

density
optional

The NetBackup density of the media written to.

integer

deviceWrittenOn
optional

The device that the copy was written on. This is the tape drive index, or -1 for non-tape media based backups.

integer

expiration
optional

The ISO 8601 timestamp of the expiration date of this copy.

string (date-time)

fileNumber
optional

The file number. This number is a numeric value that indicates the file number on the media. This number is displayed in the Activity Monitor under the Job Detailed Status as "positioning to file".

integer

firstBlock
optional

Internal use.

integer

fragmentFlags
optional

Internal use.

integer

fragmentNumber
optional

The fragment number of this record within this copy.

integer

host
optional

The name of the host that wrote this image copy to media.

string

kbytes64
optional

The size of the fragment in kilobytes.

integer

lastBlock
optional

Internal use.

integer

mediaDate
optional

The ISO-8601 formatted timestamp for the tape media.

string (date-time)

mediaDesc
optional

Internal use.

string

mediaId
optional

The media ID or path this fragment is written to.

string

mediaSequenceNumber
optional

Internal use.

integer

mediaSubtype
optional

Internal use.

integer

mediaType
optional

Internal use.

integer

multiplex
optional

Internal use.

integer

offset
optional

Internal use.

integer

remainder
optional

Internal use.

integer

resumeNumber
optional

Internal use.

integer

retentionLevel
optional

Internal use.

integer

slpTryToKeepDate
optional

Internal use.

integer

image

Name Schema

attributes
required

imageAttributes

id
required

string

links
required

links

relationships
optional

imageRelationships

type
required

string

Name Schema

self
required

self

self

Name Schema

href
required

string

imageAttributes

Name Description Schema

backupCopyType
required

The type of backup copy. These enums are the same as the "backup copy constants" in NetBackup, for example, BC_DEFAULT, BC_TPC, etc.

enum (DEFAULT, TPC, MEDIA_SERVER, NAS, SNAPSHOT, NDMP)

backupStatus
required

The NetBackup exit status of the backup job.

integer

backupTime
required

The ISO 8601 timestamp used for backup image ID.

string (date-time)

blockIncrementalFullTime
required

The time used for Block Level Incremental Backups (BLIB). A non-zero value indicates the current backup time if BLIB is performed.

integer

clientCharset
required

Integer representation of the character set used when the client calls bpcd.

integer

clientName
required

The name of the client protected by this image.

string

compression
required

Indicates whether software compression is used.

boolean

contentFile
required

The filename of the content (*.f) file.

string

contentFileCompressed
required

Type of compression used on the content file (*.f).

enum (UNKNOWN, NOT, LEGACY, SCRIPT_OLD, SCRIPT_NEW, ZLIB)

contentFileSize
required

The size of content file.

string

creator
required

The user name of backup initiator.

string

dataClassification
required

The data class specified in the policy.

string

drMediaList
required

A list of tape media IDs required for DR.

< string > array

elapsedTimeSeconds
required

The amount of time (in seconds) that the backup took to run to completion.

integer

encryption
required

The type of encryption used.

enum (NONE, LEGACY, CIPHER)

expiration
required

The ISO 8601 timestamp format for the expiration of this image.

string (date-time)

extendedSecurityInfo
required

True if extended security information was used.

boolean

fileSystemOnly
required

This is a type of recovery option.

boolean

fragments
optional

The fragment list for all copies of the image.

< fragment > array

imageDumpLevel
required

The NDMP dump level.

integer

imageType
required

Identifies the image as one of the following types: 0 = REGULAR or normal backup, 1 = PRE_IMPORT or Phase 1 import of this image is completed, 2 = IT_IMPORTED or Phase 2 import of this image is completed; this value also means that an imported image was backed up.

enum (NORMAL, PRE_IMPORT, IMPORTED)

jobId
required

The backup job ID.

integer

kbytes
required

The number of kilobytes (KB) backed up.

integer

kbytesDataTransferred
required

The number of bytes transferred.

integer

keyword
required

The backup policy keyword.

string

mpx
required

Indicates if the image is multiplexed on tape.

boolean

numCopies
required

The number of copies of this image.

integer

numFiles
required

The number of files backed up.

integer

numberFragments
required

The total number of fragments including all copies, that is, the length of the "fragments" array.

integer

originMasterServer
required

The name of the origin master server.

string

policyName
required

The name of the backup policy.

string

policyType
required

This value describes which agent generated the image. "Standard", "Oracle", "MS-Windows", "VMware", "Hyper-V", "MS-SQL-Server", "MS-Exchange-Server", etc.

string

primaryCopy
required

The default copy to use for restores and duplications.

integer

providerGeneratedId
required

The identifier assigned by the asset’s provider, if any. Prepended with the asset type.

string

proxyClient
required

The host name of the proxy client used for the backup.

string

remoteExpiration
required

The UTC timestamp for the REMOTE expiration of this image. See "Auto Image Replication".

integer

retentionLevel
required

The retention level of the image.

integer

scheduleName
required

The name of the schedule used to create the backup.

string

scheduleType
required

The type of schedule. These enums are the same as the "schedule types" in NetBackup, for example, ST_FULL, ST_DINC, ST_UBACKUP, ST_UARCHIVE and ST_CINC.

enum (FULL, DIFFERENTIAL_INCREMENTAL, USER_BACKUP, USER_ARCHIVE, CUMULATIVE_INCREMENTAL)

slpCompleted
required

Indicates that the storage lifecycle policy (SLP) has satisfied all its operations on this image.

integer

slpName
required

The name of the SLP that manages this image.

string

slpVersion
required

The version number of the SLP that manages this image.

integer

snapshotTime
optional

The time in ISO-8601 format when the snapshot was taken.

string (date-time)

tirExpiration
required

The UTC timestamp for the expiration of the True Image Restore (TIR) data.

integer

version
required

The image format version.

integer

vmType
required

The type of virtual machine backed up by this image.

integer

imageContents

Name Schema

data
required

< imageContentsAttributes > array

links
required

links

meta
required

meta

Name Description Schema

next
required

Contains a link to the next page of values.

next

next

Name Description Schema

href
required

The URL to obtain the next page of values. For this API, this link should be identical to the current URL.

string

meta

Name Schema

pagination
required

paginationValues

imageContentsAttributes

Name Schema

attributes
required

imageFileContentEntry

id
required

string

type
required

string

imageDetail

Name Schema

data
required

image

imageFileContentEntry

Name Description Schema

blockNumber
required

The block number on which the file resides.

integer (int64)

compressedFileSize
required

The compressed size in bytes. This values is 0 if the file is not compressed.

integer (int64)

deviceNumber
required

The device number of the file or directory.

integer

filePath
required

The path at which the disk file resides.

string

fileSize
required

The actual size in bytes. Directories are reported as 0 bytes.

integer (int64)

group
optional

The group to which the file record belongs.

string

inImageFlag
required

Detects if the file is in the image. Is Set to 0 if file is not in the image. Is Set to 1 if file is in the image. Is Set to 2 if the image contains only True Image Restore data.

integer

inodeLastModified
optional

The ISO 8601 timestamp that indicates when the file’s inode was last modified.

string (date-time)

lastAccessTime
optional

The ISO 8601 timestamp that indicates when the file record was last accessed.

string (date-time)

lastModifiedTime
optional

The ISO 8601 timestamp that indicates when the file record was last modified.

string (date-time)

pathMode
optional

File/directory mode bits in decimal.

integer

rawPartitionSize
required

The size of the raw partition. This value is a non-zero number if the file is a raw partition.

integer

user
optional

The owner of the file record.

string

imageList

Name Schema

data
required

< image > array

meta
required

meta

meta

Name Schema

pagination
required

paginationValues

imageRelationships

Name Schema

vmwareImage
optional

vmwareImage

vmwareImage

Name Schema

data
required

data

links
required

links

data

Name Schema

id
required

string

type
required

string

Name Schema

related
required

related

Name Schema

href
required

string

optionalVmwareInfo

Name Schema

attributes
required

attributes

id
required

string

type
required

string

attributes

Name Description Schema

vmDisks
required

A list of disks on the image.

< diskInfo > array

vmNetworks
required

A list of the networks to which the machine belongs.

< string > array

vmTemplate
optional

True if the virtual machine is a template.

boolean

vmVersion
required

The version of virtual machine.

string

paginationValues

Name Schema

count
optional

integer

first
optional

integer

last
optional

integer

limit
optional

integer

next
optional

integer

offset
optional

integer

prev
optional

integer

requestId

Name Description Schema

requestId
required

The ID for subsequent requests.

string

vmwareImage

Name Schema

attributes
required

attributes

id
required

string

links
required

links

relationships
required

relationships

type
required

string

attributes

Name Description Schema

backupTime
required

The ISO 8601 timestamp used for backup image ID in ISO-8601 format.

string (date-time)

biosUUID
required

The BIOS UUID of the virtual machine.

string

client
required

The name of the client protected by this image.

string

cluster
required

The cluster that the virtual machine belongs to.

string

clusterPath
required

The data center path of the cluster that the virtual machine belongs to.

string

datacenter
required

The data center of the virtual machine.

string

esxiServer
required

The ESX server name of the virtual machine.

string

instanceUUID
required

The Instance UUID of the virtual machine.

string

ipAddress
required

The IP address of the client that is protected by this image.

string

policyName
required

The name of the backup policy.

string

resourcePoolOrVapp
required

The name of the resource pool or a vApp that was assigned to the VM when it was backed up. A resource pool is a way of controlling resources. A VM is always in a resource pool.

string

scheduleType
required

The type of schedule. These enums are the same as the "schedule types" in NetBackup, for example, ST_FULL, ST_DINC, ST_UBACKUP, ST_UARCHIVE and ST_CINC.

enum (FULL, DIFFERENTIAL_INCREMENTAL, USER_BACKUP, USER_ARCHIVE, CUMULATIVE_INCREMENTAL)

vCDOrg
required

The name of the vCloud Director Organization or tenant that a VM belonged to if the backup was a vCloud Director backup.

string

vCDOrgVDC
required

The name of the Virtual DataCenter the VM resided in if the backup was a vCloud Director backup.

string

vCDServer
required

The name of the vCloud Director server if the backup was a vCloud Director backup.

string

vCDVApp
required

The name of the vApp that the VM is part of if the backup was a vCloud Director backup.

string

vCDVmName
required

The logical name of the VM inside the vApp if the backup was a vCloud Director backup.

string

vCenter
required

The name of the vCenter hosting the virtual machine.

string

vmDNSName
required

The DNS name of the virtual machine.

string

vmDisplayName
required

The display name of the virtual machine.

string

vmFolder
required

The datastore path where the virtual machine is stored.

string

vmHostName
required

The host name of the virtual machine.

string

vmxDatastore
required

The name of the datastore where the VM configuration files were located.

string

Name Schema

self
required

self

self

Name Schema

href
required

string

relationships

Name Schema

image
required

image

optionalVmwareInfo
optional

optionalVmwareInfo

image

Name Schema

data
required

data

links
required

links

data

Name Schema

id
required

string

type
required

string

Name Schema

related
required

related

Name Schema

href
required

string

optionalVmwareInfo

Name Schema

data
required

data

data

Name Schema

id
required

string

type
required

string

vmwareImageDetail

Name Schema

data
required

vmwareImage

included
optional

< optionalVmwareInfo > array

vmwareImageList

Name Schema

data
required

< vmwareImage > array

meta
required

meta

meta

Name Schema

pagination
required

paginationValues

Security

rbacSecurity

Type : apiKey
Name : Authorization
In : HEADER

NetBackup Configuration API

Overview

The NetBackup Configuration API provides access to NetBackup configuration.

Version information

Version : 2.0

URI scheme

Host : <masterserver>:1556
BasePath : /netbackup
Schemes : HTTPS

Paths

POST /config/hosts

Description

Creates a host entry in database.

Requires Permission: [Manage Hosts]

Parameters

Type Name Description Schema

Header

X-NetBackup-Audit-Reason
optional

The audit reason for creating the host.

string

Body

Host Data
required

The properties of the host to be added in the database.

postCreateHostRequest

Responses

HTTP Code Description Schema

201

Successfully created a host database entry.
Headers :
Location (string) : The URI of the created host entry.

No Content

400

Bad or invalid request.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

409

The server already exists in the database.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/hosts

Description

Gets all hosts information.

Requires Permission: [Manage Hosts]

Responses

HTTP Code Description Schema

200

Successfully fetched all hosts information.

hostsResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/hosts/hostmappings

Description

Fetches a list of hosts and the details of their host ID-to-host name mappings. The results depend on one or more parameters or conditions, such as isapproved, isconflict, isshared, and isaddedmanually. The result set is determined, if all specified conditions are true.

Requires Permission: [Manage Hosts]

Parameters

Type Name Description Schema

Query

isaddedmanually
optional

Fetches a list of hosts and the details of their host ID-to-hostname mappings based on the value of the isaddedmanually parameter.

boolean

Query

isapproved
optional

Fetches a list of hosts and the details of their host ID-to-host name mappings based on the value of the isapproved parameter.

boolean

Query

isconflict
optional

Fetches a list of hosts and the details of their host ID-to-hostname mappings based on the value of the isconflict parameter.

boolean

Query

isshared
optional

Fetches a list of hosts and the details of their host ID-to-hostname mappings based on the value of the isshared parameter.

boolean

Query

mappedHostName
optional

Fetches a list of hosts and the details of their host ID-to-host name mappings based on the value of the mappedhostname parameter.

string

Responses

HTTP Code Description Schema

200

Successfully fetched host information.

hostsResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/hosts/{hostId}

Description

Gets information for the specified host ID.

Requires Permission: [Manage Hosts]

Parameters

Type Name Description Schema

Path

hostId
required

The host ID of the host.

string

Responses

HTTP Code Description Schema

200

Successfully retrieved host information.

hostResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No host exists with host ID.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

PATCH /config/hosts/{hostId}

Description

Updates information for a host with the specified host ID. Only the NetBackup security administrator can update the 'autoReissue' parameter.

Requires Permission: [Manage Hosts]

Parameters

Type Name Description Schema

Header

X-NetBackup-Audit-Reason
optional

The audit reason for updating the host properties.

string

Path

hostId
required

Host ID of the host.

string

Body

Host Properties
required

Properties of the host to be updated.

patchHostProperties

Responses

HTTP Code Description Schema

204

Host information is successfully updated.

No Content

400

Bad or Invalid Request.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No host associated with the specified host ID.

errorResponse

409

The host already exists.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

An unexpected system error occurred.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

PUT /config/hosts/{hostId}/comment

Description

Updates comment for the host that is associated with the specified host ID.

Requires Permission: [Manage Hosts]

Parameters

Type Name Description Schema

Path

hostId
required

The host ID of the host.

string

Body

HostCommentDetails
required

Host-specific comment to be updated.

putHostCommentDetails

Responses

HTTP Code Description Schema

200

Successfully updated the host information.

No Content

400

Bad or invalid request.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No host associated with the specified host ID exists.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/hosts/{hostId}/hostmappings

Description

Fetches the details of the host ID-to-host name mappings that are associated with the specified host ID.

Requires Permission: [Manage Hosts]

Parameters

Type Name Description Schema

Path

hostId
required

Specifies the host ID for which you want to add mappings.

string

Query

isapproved
optional

Provides a list of approved or pending mappings of the host ID based on the specified parameter value.

boolean

Responses

HTTP Code Description Schema

200

Successfully retrieved host information.

hostMappingsDetails

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No host exists with specified host ID.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

PUT /config/hosts/{hostId}/hostmappings/{mappedHostName}

Description

Adds mappings for the specified host ID.

Requires Permission: [Manage Hosts]

Parameters

Type Name Description Schema

Header

X-NetBackup-Audit-Reason
optional

Specifies the audit reason for adding the host ID-to-host name mapping.

string

Path

hostId
required

Specifies the host ID for which you want to add mappings.

string

Path

mappedHostName
required

Host ID-to-host name mapping to be added.

string

Body

HostMappingDetails
required

The properties of the host to be mapped.

putAddHostMapping

Responses

HTTP Code Description Schema

200

Successfully updated the host mapping properties for the specified host ID.

No Content

201

Successfully added the host mapping to the specified host ID.

No Content

400

Invalid parameter with request payload.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

409

A conflict in the host ID-to-host name mapping was detected.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

DELETE /config/hosts/{hostId}/hostmappings/{mappedHostName}

Description

Deletes host mappings that are associated with the specified host ID.

Requires Permission: [Manage Hosts]

Parameters

Type Name Description Schema

Header

X-NetBackup-Audit-Reason
optional

Specifies the reason for deleting the host ID-to-host name mapping.

string

Path

hostId
required

Specifies the host ID that is associated with the mapping that you want to delete.

string

Path

mappedHostName
required

Specifies the host ID-to-host name mapping that you want to delete.

string

Responses

HTTP Code Description Schema

204

Successfully deleted the host mapping for the specified host ID.

No Content

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

The specified host mapping was not found.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

PUT /config/hosts/{hostId}/reset

Description

Resets the host information that is associated with the specified host ID.

Requires Permission: [Manaage Hosts]

Parameters

Type Name Description Schema

Header

X-NetBackup-Audit-Reason
optional

The audit reason for resetting the host.

string

Path

hostId
required

The host ID of the host.

string

Responses

HTTP Code Description Schema

200

Successfully reset the host entry.

No Content

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No host exists with the specified host ID.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

500

An unexpected system error occurred.

errorResponse

Security

Type Name

apiKey

rbacUserSecurity

GET /config/hosts?name={hostName}

Description

Gets information for a host with name specified.

Requires Permission: [Manage Hosts]

Parameters

Type Name Description Schema

Query

hostName
required

The name of the host.

string

Responses

HTTP Code Description Schema

200

Successfully retrieved host information.

hostResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No host exists with the specified host name.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

POST /config/policies/

Description

Creates the policy. Cloud, Oracle, MS SQL Server, and VMware policy types are supported with the policy type specific schemas. For other policy types, the Generic schema can be used with the request header specified below. The Generic schema exposes all possible values of a policy and depends on the user to provide all values that are relevant to the workload type. Requires Permission: [Manage Policies]

Parameters

Type Name Description Schema

Header

X-NetBackup-Audit-Reason
optional

The audit reason for creating the policy.

string

Header

X-NetBackup-Policy-Use-Generic-Schema
optional

Indicates whether the Generic policy schema is used.

boolean

Body

policyDetails
required

The details of the policy to be created.

policyRequest

Responses

HTTP Code Description Schema

204

Successfully created the policy.
Headers :
ETag (integer) : The current generation ID of the policy.
Location (string (url)) : A link to the created policy.

No Content

400

Failed to parse the JSON body.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

409

The policy already exists.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

An unexpected system error occurred.

errorResponse

501

Not implemented for policies other than Cloud, Oracle, MS SQL Server, and VMware. For other policy types, the Generic schema can be used with the request header X-NetBackup-Policy-Use-Generic-Schema set to true.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/policies/

Description

Lists all of the NetBackup policies.

Requires Permission: [Manage Policies]

Responses

HTTP Code Description Schema

200

Successfully retrieved the list of policies.

listPoliciesResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

500

An unexpected system error.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/policies/{policyName}

Description

Get the details for a specified policy. Cloud, Oracle, MS SQL Server, and VMware policy types are supported with the policy type specific schemas. For other policy types, the Generic schema will be used. The Generic schema gets all the possible fields of a policy that are not specific to policy type.

Requires Permission: [Manage Policies]

Parameters

Type Name Description Schema

Header

X-NetBackup-Policy-Use-Generic-Schema
optional

Indicates whether the Generic policy schema is used.

boolean

Path

policyName
required

The name of the policy.

string

Responses

HTTP Code Description Schema

200

Successfully retrieved the policy details.
Headers :
ETag (integer) : The current generation ID of the policy.

policyResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

The specified policy was not found.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

500

An unexpected system error.

errorResponse

501

Not implemented for policies other than Cloud, Oracle, MS SQL Server, and VMware. For other policy types, the Generic schema can be used with the request header X-NetBackup-Policy-Use-Generic-Schema set to true.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

PUT /config/policies/{policyName}

Description

Updates the policy details with specified policy name. Cloud, Oracle, MS SQL Server, and VMware policy types are supported with the policy type specific schemas. For other policy types, the Generic schema can be used with the request header specified below. The Generic schema exposes all the possible values of a policy and depends on user to provide all values relevant to policy type. Requires Permission: [Manage Policies]

Parameters

Type Name Description Schema

Header

If-Match
optional

The current generation ID of the policy.

string

Header

X-NetBackup-Audit-Reason
optional

The audit reason for updating the policy.

string

Header

X-NetBackup-Policy-Use-Generic-Schema
optional

Indicates whether the Generic policy schema is used.

boolean

Path

policyName
required

The name of the policy.

string

Body

policyDetails
required

The details of the policy to be updated.

policyRequest

Responses

HTTP Code Description Schema

204

Successfully updated the policy.
Headers :
ETag (integer) : The current generation ID of the policy.

No Content

400

Failed to parse the JSON body.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No policy exists with the specified policy name.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

An unexpected system error occurred.

errorResponse

501

Not implemented for policies other than Cloud, Oracle, MS SQL Server, and VMware. For other policy types, the Generic schema can be used with the request header X-NetBackup-Policy-Use-Generic-Schema set to true.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

DELETE /config/policies/{policyName}

Description

Deletes a specified policy.

Requires Permission: [Manage Policies]

Parameters

Type Name Description Schema

Path

policyName
required

The name of the policy.

string

Responses

HTTP Code Description Schema

204

Successfully deleted the policy.

No Content

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No policy exists with the specified policy name.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

500

An unexpected system error occurred.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

Unknown

rbacSecurity

PUT /config/policies/{policyName}/backupselections

Description

Replaces the existing backup selections with the specified list of backup selections.

Requires Permission: [Manage Policies]

Parameters

Type Name Description Schema

Header

If-Match
optional

The generation ID of the policy.

string

Header

X-NetBackup-Audit-Reason
optional

The audit reason for changing the policy.

string

Path

policyName
required

The name of the policy.

string

Body

backupSelections
required

The list of paths for the policy backup.

putIncludeRequest

Responses

HTTP Code Description Schema

204

Successfully updated the backup selections.

No Content

400

Failed to parse the JSON body.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

The specified policy was not found.

errorResponse

412

A conditional update failed because of mismatched generation IDs.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

Unexpected system error.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

DELETE /config/policies/{policyName}/backupselections

Description

Removes the existing backup selections for the specified policy.

Requires Permission: [Manage Policies]

Parameters

Type Name Description Schema

Header

If-Match
optional

The generation ID of the policy.

string

Header

X-NetBackup-Audit-Reason
optional

The audit reason for changing the policy.

string

Path

policyName
required

The name of the policy.

string

Responses

HTTP Code Description Schema

204

Successfully removed the backup selection.

No Content

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

The specified policy was not found.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

412

A conditional update failed because of mismatched generation IDs.

errorResponse

500

Unexpected system error.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

PUT /config/policies/{policyName}/clients/{clientName}

Description

Adds or modifies a client for the specified policy. It can also modify an instance group, instance, or database for the specified policy.

Requires Permission: [Manage Policies]

Parameters

Type Name Description Schema

Header

If-Match
optional

The generation ID of the policy.

string

Header

X-NetBackup-Audit-Reason
optional

The audit reason for changing the policy.

string

Path

clientName
required

The host name of the client.

string

Path

policyName
required

The name of the policy.

string

Body

client
required

The client to be backed up.

putClientRequest

Responses

HTTP Code Description Schema

201

Successfully added a client, instance group, instance, or database for the specified policy.
Headers :
ETag (integer) : The current generation ID of the policy.

No Content

204

Successfully updated the specified client in the policy.

No Content

400

Failed to parse the JSON body.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

The specified policy was not found.

errorResponse

412

A conditional update failed because of mismatched generation IDs.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

Unexpected system error.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

DELETE /config/policies/{policyName}/clients/{clientName}

Description

Removes the existing client for the specified policy.

Requires Permission: [Manage Policies]

Parameters

Type Name Description Schema

Header

If-Match
optional

The generation ID of the policy.

string

Header

X-NetBackup-Audit-Reason
optional

The audit reason for changing the policy.

string

Path

clientName
required

The host name of the client.

string

Path

policyName
required

The name of the policy.

string

Responses

HTTP Code Description Schema

204

Successfully removed the client.

No Content

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

The specified policy or client was not found.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

412

A conditional update failed because of mismatched generation IDs.

errorResponse

500

Unexpected system error.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

PUT /config/policies/{policyName}/schedules/{scheduleName}

Description

Adds or updates a schedule in the specified policy.

Requires Permission: [Manage Policies]

Parameters

Type Name Description Schema

Header

If-Match
optional

The generation ID of the policy.

string

Header

X-NetBackup-Audit-Reason
optional

The audit reason for changing the policy.

string

Path

policyName
required

The name of the policy.

string

Path

scheduleName
required

The name of the schedule.

string

Body

schedule
required

The policy schedule to add or update.

putScheduleRequest

Responses

HTTP Code Description Schema

201

Successfully created the schedule.
Headers :
ETag (integer) : The current generation ID of the policy.

No Content

204

Successfully updated the schedule.

No Content

400

Failed to parse the JSON body.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

The specified policy was not found.

errorResponse

412

A conditional update failed because of mismatched generation IDs.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

Unexpected system error.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

DELETE /config/policies/{policyName}/schedules/{scheduleName}

Description

Removes a schedule from the specified policy.

Requires Permission: [Manage Policies]

Parameters

Type Name Description Schema

Header

If-Match
optional

The generation ID of the policy.

string

Header

X-NetBackup-Audit-Reason
optional

The audit reason for changing the policy.

string

Path

policyName
required

The name of the policy.

string

Path

scheduleName
required

The name of the schedule.

string

Responses

HTTP Code Description Schema

204

Successfully deleted the schedule.

No Content

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

The specified policy or schedule was not found.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

412

A conditional update failed because of mismatched generation IDs.

errorResponse

500

Unexpected system error.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/retentionlevels

Description

Get all retention levels.

Requires Permission: [Manage NetBackup]

Responses

HTTP Code Description Schema

200

Successfully fetched all retention levels.

retentionLevelResponseArray

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

Cannot get retention levels.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/servers/trusted-master-servers

Description

Gets the list of all trusted master servers.

Requires Permission: [Manage Hosts]

Responses

HTTP Code Description Schema

200

Successfully returned the list of all trusted master servers.

getTrustedMasterServersResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

POST /config/servers/vmservers

Description

Creates VM server credentials.

Requires Permission: [Manage Appservers and Asset Groups]

Parameters

Type Name Schema

Body

vmserver
required

vmserver

Responses

HTTP Code Description Schema

201

Successfully added the VM server credentials.

No Content

400

Failed to parse the JSON body, or the entity already exists.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

An unexpected system error occurred.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/servers/vmservers

Description

Retrieves the list of VM server credentials based on the specified filters. If no filters are specified, information for all the VM server credentials are retrieved. All the filters are based on OData standards. Filtering is supported for the following attributes:

Name Supported Operators Description Schema

serverName

eq ne ge gt le lt contains startswith endswith

Specifies the VM server name.

string

serverType

eq ne

Specifies the VM server’s server type.

string

Requires Permission: [Manage Assets, Manage Appservers and Asset Groups]

Parameters

Type Name Description Schema

Query

filter
optional

Specifies filters according to OData standards.

string

Responses

HTTP Code Description Schema

200

Successfully retrieved the list of VM server credentials.

vmserverResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/servers/vmservers/{serverName}

Description

Lists the VM server credentials.

Requires Permission: [Manage Assets, Manage Appservers and Asset Groups]

Parameters

Type Name Schema

Path

serverName
required

string

Responses

HTTP Code Description Schema

200

VM server credentials found.

vmserverResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No VM server credentials found.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/servers/wssendpoints

Description

Lists all the hosts that serve as NetBackup WebSocket servers.

Requires Permission: [Manage NetBackup]

Responses

HTTP Code Description Schema

200

List of available hosts.

hostGenericSchemaArray

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

POST /config/servers/wssendpoints/save

Description

Adds the host to the list of NetBackup WebSocket Servers. Note: VALIDATEHOST or VALIDATEURL API needs to be called before the SAVE endpoint is called.

Requires Permission: [Manage NetBackup]

Parameters

Type Name Description Schema

Body

Host configuration
required

The details for the host.

hostGenericSchema

Responses

HTTP Code Description Schema

201

The host was added successfully to the list of NetBackup WebSocket Servers.

emptyResponse

400

Bad request.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

The certificate did not match with the one accepted by the user.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

POST /config/servers/wssendpoints/update

Description

Updates the state of the specified host in the WebSocket Servers list. Note: SAVE API needs to be called before the update API is called.

Requires Permission: [Manage NetBackup]

Parameters

Type Name Description Schema

Body

Host configuration
required

The hostname and state to update.

updateHostSchema

Responses

HTTP Code Description Schema

200

Host details saved successfully.

emptyResponse

400

Bad request.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

An unexpected system error occurred.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

POST /config/servers/wssendpoints/validatehost

Description

Checks if the host is valid using the information provided in the JSON file.

Requires Permission: [Manage NetBackup]

Parameters

Type Name Description Schema

Body

Host configuration
required

The details for the host.

hostGenericSchema

Responses

HTTP Code Description Schema

200

Host validation successful.

hostGenericSchema

400

Bad request.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

Unable to establish a connection to the specified URL.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

POST /config/servers/wssendpoints/validateurl

Description

Checks if the host is valid using the URL provided.

Requires Permission: [Manage NetBackup]

Parameters

Type Name Description Schema

Body

URL
required

The NetBackup WebSocket Service (WSS) endpoint URL.

urlSchema

Responses

HTTP Code Description Schema

200

Host validation successful.

hostGenericSchema

400

Bad request.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

406

Invalid Accept type. Make sure your Accept header matches what this API produces.

errorResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

500

An unexpected system error occurred.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

DELETE /config/servers/wssendpoints/{hostName}

Description

Deletes the specified host name from the NetBackup WebSocket servers list.

Requires Permission: [Manage NetBackup]

Parameters

Type Name Description Schema

Path

hostName
required

The host name of the host to delete.

string

Responses

HTTP Code Description Schema

200

The host name was deleted successfully.

emptyResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

The host name could not be found.

emptyResponse

415

Unsupported Media Type. The media type specified in the Content-Type header is not supported by this API.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

POST /config/slps

Description

Create a new storage lifecycle policy (SLP).

Requires Permission: [Manage SLPs]

Parameters

Type Name Description Schema

Header

X-NetBackup-Audit-Reason
optional

The audit reason for creating the storage lifecycle policy (SLP).

string

Body

body
required

The storage lifecycle policy (SLP) definition to add.

postCreateSlpRequest

Responses

HTTP Code Description Schema

201

Successfully created the storage lifecycle policy (SLP).
Headers :
Location (string) : URI of the created storage lifecycle policy (SLP) entry.

postCreateSlpRequest

400

Bad Request.

createSLPErrorResponse

401

Authentication failed.

errorResponse

409

A storage lifecycle policy (SLP) with the same name already exists.

errorResponse

500

Internal Server Error.

SLPInternalServerError

Consumes

  • application/vnd.netbackup+json;version=2.0

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/slps

Description

Obtains a list of all defined storage lifecycle policies (SLPs).

Requires Permission: [Manage SLPs]

Responses

HTTP Code Description Schema

200

Successfully returned the list of storage lifecycle policies (SLPs).

getSLPsResponse

401

Authentication failed.

errorResponse

500

Internal Server Error.

SLPInternalServerError

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/slps/{slpName}

Description

Returns the definition of the storage lifecycle policy (SLP). By default, the latest version is returned.

Requires Permission: [Manage SLPs]

Parameters

Type Name Description Schema

Path

slpName
required

The name of the storage lifecycle policy (SLP).

string

Responses

HTTP Code Description Schema

200

Successfully returned the details of the storage lifecycle policy (SLP).

getSLPResponse

401

Authentication failed.

errorResponse

404

A storage lifecycle policy with the specified name was not found.

errorResponse

500

Internal Server Error.

SLPInternalServerError

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

DELETE /config/slps/{slpName}

Description

Removes the storage lifecycle policy (SLP)

Requires Permission: [Manage SLPs]

Parameters

Type Name Description Schema

Path

slpName
required

The name of the storage lifecycle policy (SLP).

string

Responses

HTTP Code Description Schema

204

Successfully removed the storage lifecycle policy (SLP).

No Content

401

Authentication failed.

errorResponse

404

The specified storage lifecycle policy (SLP) was not found.

errorResponse

409

The specified storage lifecycle policy (SLP) is used in one or more backup policies, or the execution of the SLP is in progress.

errorResponse

500

Internal Server Error.

SLPInternalServerError

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

PATCH /config/slps/{slpName}

Description

Updates specified attributes of the storage lifecycle policy (SLP)

Requires Permission: [Manage SLPs]

Parameters

Type Name Description Schema

Header

X-NetBackup-Audit-Reason
optional

The audit reason for updating the storage lifecycle policy (SLP) attributes.

string

Path

slpName
required

The name of the storage lifecycle policy (SLP).

string

Body

body
required

The storage lifecycle policy (SLP) attributes to update.

patchSlpRequest

Responses

HTTP Code Description Schema

200

Successfully updated the storage lifecycle policy (SLP).

postCreateSlpRequest

400

Bad Request.

createSLPErrorResponse

401

Authentication failed.

createSLPErrorResponse

404

The specified storage lifecycle policy (SLP) was not found.

createSLPErrorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/slps/{slpName}/versions/{versionNumber}

Description

Returns the definition of the storage lifecycle policy (SLP) for the specified version.

Requires Permission: [Manage SLPs]

Parameters

Type Name Description Schema

Path

slpName
required

The name of the storage lifecycle policy (SLP).

string

Path

versionNumber
required

The version of the storage lifecycle policy (SLP).

integer

Responses

HTTP Code Description Schema

200

Successfully returned the details of the storage lifecycle policy (SLP).

getSLPResponse

404

A storage lifecycle policy with the specified name or version was not found.

errorResponse

500

Internal Server Error.

SLPInternalServerError

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/smtpserver

Description

Fetches the SMTP server configuration.

Requires Permission: [Manage NetBackup]

Responses

HTTP Code Description Schema

200

Successfully fetched the SMTP configuration details.

smtpConfigurationGetResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

Resource cannot be found.

errorResponse

500

System error occurred.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

PUT /config/smtpserver

Description

Creates a new SMTP server configuration or updates an existing configuration.

Requires Permission: [Manage NetBackup]

Parameters

Type Name Description Schema

Body

smtpConfigurationRecord
required

JSON object for the SMTP server configuration.

smtpConfigurationRequest

Responses

HTTP Code Description Schema

204

Successfully added or updated the SMTP server configuration.

No Content

400

Bad request, invalid parameter with request payload.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

500

System error occurred.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/snapshotproviders/configuredplugins

Description

Returns the list of configured plug-in types.

Requires Permission: [Manage Cloud Appservers]

Responses

HTTP Code Description Schema

200

Successfully returned the list of configured plug-in types.

pluginTypeResponseArray

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

405

Method not allowed. The specified HTTP operation is invalid.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

POST /config/snapshotproviders/configuredplugins/{pluginType}/instances

Description

Adds a new configuration instance for the plug-in for Integrated Snapshot Management.

Requires Permission: [Manage Cloud Appservers]

Parameters

Type Name Description Schema

Path

pluginType
required

The type of plug-in. This value can be retrieved from GET /config/snapshotproviders/supportedplugins API. For example, "aws" or "azure".

string

Body

configurationRequest
required

The details of the configuration instance for the plug-in.

configurationRequest

Responses

HTTP Code Description Schema

201

Successfully added the configuration instance.
Headers :
Location (string (url)) : A link to the configuration instance of the plug-in.

configurationResponse

400

Bad request. The body of the request is not valid.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

The specified plug-in type is not supported for the cloud vendor.

errorResponse

405

Method not allowed. The specified HTTP operation is invalid.

errorResponse

409

A configuration instance with the same configuration details already exists.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/snapshotproviders/configuredplugins/{pluginType}/instances

Description

Returns the details of the configuration instances added to the specified plug-in type.

Requires Permission: [Manage Cloud Appservers]

Parameters

Type Name Description Schema

Path

pluginType
required

The type of plug-in. This value can be retrieved from GET /config/snapshotproviders/supportedplugins API. For example, "aws" or "azure".

string

Responses

HTTP Code Description Schema

200

Successfully returned the details of the configuration instances added to the specified plug-in type.

configurationResponseArray

400

Bad request.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

The specified plug-in type is not supported for the cloud vendor.

errorResponse

405

Method not allowed. The specified HTTP operation is invalid.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/snapshotproviders/configuredplugins/{pluginType}/instances/{instanceName}

Description

Returns the details of the specified configuration instance.

Requires Permission: [Manage Cloud Appservers]

Parameters

Type Name Description Schema

Path

instanceName
required

The unique name that is specified by the NetBackup user for the configuration instance.

string

Path

pluginType
required

The type of plug-in. This value can be retrieved from GET /config/snapshotproviders/supportedplugins API. For example, "aws" or "azure".

string

Responses

HTTP Code Description Schema

200

Successfully returned the details of the specified configuration instance.

configurationResponse

400

Bad request.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

The specified plug-in type or configuration instance not found.

errorResponse

405

Method not allowed. The specified HTTP operation is invalid.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

PUT /config/snapshotproviders/configuredplugins/{pluginType}/instances/{instanceName}

Description

Updates the existing configuration instance of the plug-in.

Requires Permission: [Manage Cloud Appservers]

Parameters

Type Name Description Schema

Path

instanceName
required

The unique name that is specified by the NetBackup user for the configuration instance.

string

Path

pluginType
required

The type of plug-in. This value can be retrieved from GET /config/snapshotproviders/supportedplugins API. For example, "aws" or "azure".

string

Body

configurationRequest
required

The details of configuration instance for the plug-in.

configurationRequest

Responses

HTTP Code Description Schema

200

Successfully updated the existing configuration instance of the plug-in.
Headers :
Location (string (url)) : A link to the configuration instance of the plug-in.

configurationResponse

400

Bad request. The body of the request is not valid.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

The specified plug-in type or configuration instance not found.

errorResponse

405

Method not allowed. The specified HTTP operation is invalid.

errorResponse

409

A configuration instance with the same configuration details already exists.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

PATCH /config/snapshotproviders/configuredplugins/{pluginType}/instances/{instanceName}

Description

Updates few attributes of specified configuration instance.

Requires Permission: [Manage Cloud Appservers]

Parameters

Type Name Description Schema

Path

instanceName
required

The unique name that is specified by the NetBackup user for the configuration instance.

string

Path

pluginType
required

The type of plug-in. This value can be retrieved from GET /config/snapshotproviders/supportedplugins API. For example, "aws" or "azure".

string

Body

configurationPatchRequest
required

The details of configuration instance for the plug-in.

configurationPatchRequest

Responses

HTTP Code Description Schema

200

Successfully updated the existing configuration instance of the plug-in.
Headers :
Location (string (url)) : A link to the configuration instance of the plug-in.

configurationResponse

400

Bad request. The body of the request is not valid.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

The specified plug-in type or configuration instance not found.

errorResponse

405

Method not allowed. The specified HTTP operation is invalid.

errorResponse

Consumes

  • application/vnd.netbackup+json;version=2.0

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/snapshotproviders/supportedplugins

Description

Returns the list of all supported plug-in types.

Requires Permission: [Manage Cloud Appservers]

Responses

HTTP Code Description Schema

200

Successfully returned the list of supported plug-in types.

supportedPluginResponseArray

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/snapshotproviders/supportedplugins/{pluginType}

Description

Returns the configuration attributes of the specified plug-in type.

Requires Permission: [Manage Cloud Appservers]

Parameters

Type Name Description Schema

Path

pluginType
required

The type of plug-in. This value can be retrieved from GET /config/snapshotproviders/supportedplugins API. For example, "aws" or "azure".

string

Responses

HTTP Code Description Schema

200

Successfully returned the configuration attributes of the specified plug-in type.

supportedPluginResponse

400

Bad request.

errorResponse

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

The specified plug-in type is not supported for the cloud vendor.

errorResponse

405

Method not allowed. The specified HTTP operation is invalid.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

GET /config/workloads/vmware/vcenter-recovery-topologies/{vcenter-id}

Description

Gets the vCenter recovery topology information for the given vCenter ID.

Requires Permission: [Recover/Restore]

Parameters

Type Name Description Schema

Path

vcenter-id
required

The ID of the vCenter. This ID is the server name and must match the name (short name or fully qualified domain name) that was specified when the server was added.

string

Responses

HTTP Code Description Schema

200

Successfully returned the vCenter topology information for the specified vCenter ID.

workloadData

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No entity found.

errorResponse

500

An unexpected system error occurred.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

Example HTTP response

Response 200
{
  "data" : {
    "links" : {
      "self" : {
        "href" : "/config/workloads/vmware/vcenter-recovery-topologies/b3079apphp2b6.engba.veritas.com"
      }
    },
    "type" : "/vmware/vcenter-topologies",
    "id" : "b3079apphp2b6.engba.veritas.com",
    "attributes" : {
      "hierarchy" : {
        "type" : "VCENTER",
        "name" : "b3079apphp2b6.engba.veritas.com",
        "children" : [ {
          "type" : "DATACENTER",
          "name" : "ha-datacenter",
          "children" : [ {
            "type" : "HOST",
            "name" : "b3079apphp2b6.engba.veritas.com",
            "children" : [ ]
          } ]
        } ]
      }
    }
  }
}

GET /config/workloads/vmware/vcenter-topologies/{vcenter-id}

Description

Gets the vCenter topology information for the given vCenter ID.

Requires Permission: [Recover/Restore]

Parameters

Type Name Description Schema

Path

vcenter-id
required

The ID of the vCenter. This ID is the server name and must match the name (short name or fully qualified domain name) that was specified when the server was added.

string

Responses

HTTP Code Description Schema

200

Successfully returned the vCenter topology information for the specified vCenter ID.

workloadData

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No entity found.

errorResponse

500

An unexpected system error occurred.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

Example HTTP response

Response 200
{
  "data" : {
    "links" : {
      "self" : {
        "href" : "/config/workloads/vmware/vcenter-recovery-topologies/b3079apphp2b6.engba.veritas.com"
      }
    },
    "type" : "/vmware/vcenter-topologies",
    "id" : "b3079apphp2b6.engba.veritas.com",
    "attributes" : {
      "hierarchy" : {
        "type" : "VCENTER",
        "name" : "b3079apphp2b6.engba.veritas.com",
        "children" : [ {
          "type" : "DATACENTER",
          "name" : "ha-datacenter",
          "children" : [ {
            "type" : "HOST",
            "name" : "b3079apphp2b6.engba.veritas.com",
            "children" : [ ]
          } ]
        } ]
      }
    }
  }
}

GET /config/workloads/vmware/vcenters/{vcenter-id}/esxiservers/{esxiserver-id}/datastores

Description

Returns the list of datastores available for the given host or cluster on the specified vCenter.

Requires Permission: [Recover/Restore]

Parameters

Type Name Description Schema

Path

esxiserver-id
required

The name of the host or cluster exactly as configured in the VMware server topology view whether short or fully-qualified.

string

Path

vcenter-id
required

The ID of the vCenter. This ID is the server name and must match the name (short name or fully qualified domain name) that was specified when the server was added.

string

Responses

HTTP Code Description Schema

200

Successfully returned the list of datastores available for the given host or cluster on the specified vCenter.

datastoreResource

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No entity found.

errorResponse

500

An unexpected system error occurred.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

Example HTTP response

Response 200
{
  "data" : {
    "links" : {
      "self" : {
        "href" : "/config/workloads/vmware/vcenters/dummy.vcenter.server.com/esxiservers/dummy.esxi.server.com/datastores"
      }
    },
    "type" : "datastores",
    "id" : "dummy.vcenter.server.com_dummy.esxi.server.com",
    "attributes" : {
      "datastores" : [ {
        "name" : "hp2b12-ds1",
        "type" : "VMFS",
        "freeSpaceInBytes" : 34354676834,
        "physicalDevice" : "ds:///vmfs/volumes/57f6dc7d-83dd7f32-6849-0017a477049c",
        "children" : [ ]
      } ]
    }
  }
}

GET /config/workloads/vmware/vcenters/{vcenter-id}/esxiservers/{esxiserver-id}/networks

Description

Returns the list of networks available for the given host or cluster on the specified vCenter.

Requires Permission: [Recover/Restore]

Parameters

Type Name Description Schema

Path

esxiserver-id
required

The name of the host or cluster exactly as configured in the VMware server topology view whether short or fully-qualified.

string

Path

vcenter-id
required

The ID of the vCenter. This ID is the server name and must match the name (short name or fully qualified domain name) that was specified when the server was added.

string

Responses

HTTP Code Description Schema

200

Successfully returned the list of networks available for the given host or cluster on the specified vCenter.

networkResource

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No entity found.

errorResponse

500

An unexpected system error occurred.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

Example HTTP response

Response 200
{
  "data" : {
    "links" : {
      "self" : {
        "href" : "/config/workloads/vmware/vcenters/dummy.vcenter.server.com/esxiservers/dummy.esxi.server.com/networks"
      }
    },
    "type" : "networks",
    "id" : "dummy.vcenter.server.com_dummy.esxi.server.com",
    "attributes" : {
      "networks" : [ "VM Network1", "VM Network2", "VM Network3" ]
    }
  }
}

GET /config/workloads/vmware/vcenters/{vcenter-id}/esxiservers/{esxiserver-id}/resource-pools

Description

Returns the list of resource pools available for the given host or cluster on the specified vCenter.

Requires Permission: [Recover/Restore]

Parameters

Type Name Description Schema

Path

esxiserver-id
required

The name of the host or cluster exactly as configured in the VMware server topology view whether short or fully-qualified.

string

Path

vcenter-id
required

The ID of the vCenter. This ID is the server name and must match the name (short name or fully qualified domain name) that was specified when the server was added.

string

Responses

HTTP Code Description Schema

200

Successfully returned the list of resource pools available for the given host or cluster on the specified vCenter.

resourcePoolResource

401

The Authorization header is missing, the token is invalid, or you do not have permission for this action.

errorResponse

404

No entity found.

errorResponse

500

An unexpected system error occurred.

errorResponse

Produces

  • application/vnd.netbackup+json;version=2.0

Security

Type Name

apiKey

rbacUserSecurity

Example HTTP response

Response 200
{
  "data" : {
    "links" : {
      "self" : {
        "href" : "/config/workloads/vmware/vcenters/dummy.vcenter.server.com/esxiservers/dummy.esxi.server.com/resource-pools"
      }
    },
    "type" : "resourcepools",
    "id" : "dummy.vcenter.server.com_dummy.esxi.server.com",
    "attributes" : {
      "resourcePools" : [ {
        "name" : "MTV",
        "type" : "ResourcePool",
        "path" : "/Minions-DC/host/dummy.esxi.server.com/Resources/MTV",
        "children" : [ ]
      }, {
        "name" : "ROS",
        "type" : "ResourcePool",
        "path" : "/Minions-DC/host/dummy.esxi.server.com/Resources/ROS",
        "children" : [ ]
      } ]
    }
  }
}

Definitions

SLPInternalServerError

Name Description Schema

details
optional

A mapping of error code to error description to provide more context about the nature of the error.

object

errorCode
required

The NetBackup error code.

integer (int64)

errorMessage
required

The NetBackup error code description.

string

configAttributeList

Name Description Schema

multivalue
optional

< string > array

name
required

The name of the key for the key-value pair. For example, an access key or a list of regions. The value of this key can be either singlevalue or multivalue.

string

singlevalue
optional

The value of the key. For example, the user name for an access key or the password for a Secret Access Key.

string

configAttributes

Name Schema

configurationAttributes
required

< configAttributeList > array

configPatchAttribute

Name Description Schema

isDisable
required

Indicates whether asset discovery for this configuration instance is enabled.

boolean

configinstanceAttributes

Name Description Schema

attributeType
optional

The type of attribute.

string

attributeValue
optional

The list of possible values for the attribute. For example, valid names of the supported regions for a cloud provider.

< string > array

caseSensitive
optional

Indicates if this attribute is case-sensitive.

boolean

displayName
optional

The external (displayed on the interface) name of the attribute. For example, "Access Key" or "Secret Key".

string

isAttributeList
optional

Indicates if this attribute supports list operations.

boolean

isAttributeRequired
optional

Indicates if this attribute is mandatory.

boolean

name
optional

The internal name of the attribute. For example, "accesskey" or "secretkey".

string

configurationPatchRequest

Name Schema

data
required

configurationPatchRequestData

configurationPatchRequestData

Name Description Schema

attributes
required

configPatchAttribute

id
required

The unique name that is specified by the NetBackup user for the configuration instance.

string

type
required

The type of resource. For example, "plugininstance".

enum (plugininstance)

configurationRequest

Name Schema

data
required

configurationRequestData

configurationRequestData

Name Description Schema

attributes
required

configAttributes

id
required

The unique name that is specified by the NetBackup user for the configuration instance.

string

type
required

The type of resource. For example, "plugininstance".

enum (plugininstance)

configurationResponse

Name Schema

data
required

configurationResponseData

configurationResponseArray

Name Schema

data
required

< configurationResponse > array

configurationResponseData

Name Description Schema

attributes
required

instanceResponse

id
required

The unique name that is specified by the NetBackup user for the configuration instance.

string

links
required

links

type
required

The type of resource. For example, "plugininstance".

enum (plugininstance)

Name Schema

self
required

self

self

Name Schema

href
optional

string

configuredPluginMetadata

Name Description Schema

name
required

The valid name of the plug-in type. For example, for Amazon AWS the name value is "aws".

string

pluginInstanceCount
required

The configured instances count of the plug-in.

integer

configuredPluginType

Name Description Schema

attributes
optional

The metadata for the plug-in.

configuredPluginMetadata

id
required

The unique identifier (name) of the plug-in type. For example, the unique identifier for Amazon AWS is "aws".

string

links
required

links

type
optional

The type of resource. For example, "plugin".

enum (plugin)

Name Schema

self
required

self

self

Name Schema

href
optional

string

createSLPErrorResponse

Name Description Schema

details
optional

A mapping of error code to error description to provide more context about the nature of the error.

object

errorCode
required

The NetBackup error code.

integer (int64)

errorMessage
required

The NetBackup error code description.

string

operationErrors
optional

List of errors in POST storage lifecycle policy (SLP) operations.

< createSLPOperationError > array

createSLPOperationError

Name Description Schema

errorCode
required

The NetBackup error code.

integer (int64)

errorMessage
required

The NetBackup error code description for an invalid operation.

string

operationId
required

'The operation index that corresponds to the identified invalid operation. This index is generated based on the sequence of operations in input payload. A value of "0" indicates an error in the entire storage lifecycle policy (SLP).'

integer

datastoreNode

The properties of the datastore.

Name Description Schema

children
optional

< datastoreNode > array

freespace
optional

The size in Bytes.

integer (int64)

name
optional

string

physicalDevice
optional

string

type
optional

string

datastoreResource

The properties of the list of datastores available on the ESXi or Cluster server.

Name Schema

data
optional

data

data

Name Schema

attributes
optional

attributes

id
optional

string

links
optional

links

type
optional

string

attributes

Name Description Schema

datastores
optional

The list of datastores.

< datastoreNode > array

Name Schema

self
optional

self

Name Schema

href
optional

string

emptyResponse

Type : object

errorResponse

Name Description Schema

details
optional

A map containing error field and error field message to provide more context to nature of the error.

object

errorCode
required

The NetBackup error code.

integer (int64)

errorMessage
required

The NetBackup error code description.

string

getSLPResponse

Name Schema

data
optional

slpDefinition

getSLPsResponse

Name Schema

data
optional

< slpDefinition > array

links
optional

links

meta
optional

meta

Name Schema

first
optional

first

last
optional

last

next
optional

next

prev
optional

prev

self
optional

self

first

Name Schema

href
optional

string

last

Name Schema

href
optional

string

next

Name Schema

href
optional

string

prev

Name Schema

href
optional

string

self

Name Schema

href
optional

string

meta

Name Schema

pagination
optional

pagination

pagination

Name Schema

count
optional

integer

first
optional

integer

last
optional

integer

limit
optional

integer

next
optional

integer

offset
optional

integer

page
optional

integer

pages
optional

integer

prev
optional

integer

getTrustedMasterServersResponse

Name Schema

data
optional

< data > array

links
optional

links

data

Name Schema

attributes
optional

attributes

id
optional

string

type
optional

enum (trustedMasterServer)

attributes

Name Schema

trustedMasterServerName
optional

string

Name Schema

self
optional

self

self

Name Schema

href
optional

string

hostGenericSchema

Name Description Schema

certificate
required

The signing certificate that is provided by the master server to establish a secure connection.

string

connectionState
optional

Indicates whether or not the host is connected. Possible values are null, connected, and disconnected.

enum (CONNECTED, DISCONNECTED)

groupId
required

The group identifier of the host.

string

hostName
required

The host name for the communicating host.

string

priority
required

Specifies the order in which to attempt to connect to the host. NetBackup attempts to connect to the host that has the highest priority.

integer

state
optional

Indicates the state of the host. Possible values are null, activated, and deactivated.

enum (ACTIVATED, DEACTIVATED)

token
required

The authentication token that is required to make API calls.

string

url
required

The NetBackup WebSocket Service (WSS) endpoint URL.

string

hostGenericSchemaArray

Type : < hostGenericSchema > array

hostMappingsDetails

Name Description Schema

hostMappings
optional

The list of host mappings associated with the specified host.

< mappingDetails > array

timeToLiveInMin
optional

The time duration (in minutes) for which the response provided by the URI is valid.

integer

hostResponse

Name Description Schema

autoReissue
required

Specifies whether the host requires a reissue token to reissue a certificate or not.

boolean

autoReissueDuration
required

The time duration (in milliseconds) for which the certificate can be deployed on the host without requiring a reissue token.

number

comment
required

Comment provided for the host.

string

cpuArchitecture
required

The CPU architecture of the host.

string

createdDateTime
required

The time that the host entry was made, in UTC.

integer

hostMappings
required

The list of host mappings that are associated with the host.

< mappingDetails > array

hostName
required

The name of the host.

string

hwDescription
required

The hardware description of the host.

string

installedEEBs
required

The NetBackup EEBs that are installed on the host.

string

isSecureEnabled
required

Specifies whether the host can communicate securely or not.

boolean

lastUpdatedDateTime
required

The time when the host entry was last updated, in UTC.

integer

masterServer
required

The NetBackup master server that is associated with the host.

string

nbuVersion
required

The NetBackup version on the host.

string

osType
required

The operating system type of the host.

string

osVersion
required

The operating system of the host.

string

servers
required

A list of servers associated with the host.

< string > array

uuid
required

The unique ID of the host.

string

hostStatus

Name Description Schema

connectionDecision
required

Specifies whether the connection between the hosts should proceed or should be dropped. The master server sends either of the following connection decisions: CONTINUE, DROP

Communication between the hosts is proceeded or dropped depending on the connection decision.

enum (CONTINUE, DROP)

errorCode
required

The NetBackup error code.

integer

errorMessage
required

NetBackup error code string that describes the error code.

string

hostId
optional

The host ID of the peer host.

string

timeToLiveInMin
required

The time duration (in minutes) for which the response provided by the URI is valid.

integer

hostsResponse

Name Schema

hosts
optional

< hostResponse > array

instanceResponse

Name Description Schema

configID
optional

The unique configuration instance identifier.

string

configurationAttributes
optional

< configAttributeList > array

errMsg
optional

The error message to display if the configuration instance of the plug-in fails.

string

isDisable
optional

Indicates whether asset discovery for this configuration instance is enabled.

boolean

status
optional

The status of the configured instance of the plug-in.

string

listPoliciesResponse

Name Schema

data
optional

< data > array

data

Name Description Schema

attributes
optional

object

id
optional

The name of the policy.

string

links
optional

A list of URIs to get more information about each policy.

links

type
optional

The type of the policy.

string

Name Schema

self
optional

self

Name Description Schema

href
optional

A link to the policy details.

string

listVmserverResponse

Name Schema

data
optional

< data > array

data

Name Schema

attributes
optional

attributes

id
optional

string

links
optional

links

type
optional

string

attributes

Name Schema

vmServer
optional

vmserver

Name Schema

self
optional

self

Name Schema

href
optional

string

mappingDetails

Name Description Schema

createdOn
required

The time the host ID-to-host name mapping was created, in UTC.

integer (int64)

isAddedManually
required

Specifies whether the mapping was added manually or not.

boolean

isApproved
required

Specifies whether the new mapping is approved or not.

boolean

isConflicting
required

Specifies whether mapping already exists for another host ID.

boolean

isShared
required

Specifies whether the mapping is shared across hosts.

boolean

mappedHostName
required

The name of the mapped host that is associated with the mapping details.

string

origin
required

Specifies how the host ID-to-host name mapping was added.

enum (CERTIFICATE_DEPLOYMENT, USER_ADDED, HOST_DISCOVERY, COMMUNICATION_DISCOVERY, ADD_HOST)

updatedOn
required

Specifies the time when the host ID-to-host name mapping was last updated.

integer (int64)

msdpServerAttributes

Name Description Schema

caCertHash
required

SHA-1 hash of the associated CA certificate for the given host ID.

string

hostname
required

The MSDP machine name associated with the given host ID.

string

lastUpdateDateTimeUTC
required

The ISO 8601 formatted time when this record was last updated.

string (date-time)

msdpServerCredResponse

Name Description Schema

hostname
required

The MSDP host name that corresponds to the given host id.

string

password
optional

The encrypted password of MSDP.

string

username
optional

The username of MSDP.

string

msdpServerResponse

Name Schema

data
required

msdpServerResponseData

msdpServerResponseArray

Name Schema

data
required

< msdpServerResponseData > array

msdpServerResponseData

Name Description Schema

attributes
required

msdpServerAttributes

id
required

NetBackup host ID; used as unique ID to identify MSDP hosts.

string

type
required

enum (msdpServerCACertHash)

networkResource

The properties of the list of networks available on the ESXi or Cluster server.

Name Schema

data
optional

data

data

Name Schema

attributes
optional

attributes

id
optional

string

links
optional

links

type
optional

string

attributes

Name Description Schema

networks
optional

The list of networks.

< string > array

Name Schema

self
optional

self

Name Schema

href
optional

string

patchHostProperties

Name Description Schema

autoReissue
optional

Specifies whether or not an automatic reissue of the certificate is allowed. If this parameter is set and is valid, a certificate can be deployed on the host without requiring a reissue token.

boolean

clusterSharedNames
optional

A list of cluster shared names that are associated with the host. This is an optional field. Host Mappings only get ADDED if "clusterSharedNames" is specified. Administrator approval is required for the new cluster shared name.

< string > array

cpuArchitecture
optional

The CPU architecture of the host.

string

hostName
optional

The name of the host.

string

hwDescription
optional

The hardware description of the host.

string

installedEEBs
optional

The NetBackup EEBs installed on the host.

string

isSecureEnabled
optional

Specifies whether or not the host can communicate securely.

boolean

masterServer
optional

The NetBackup master server that is associated with the host.

string

nbuVersion
optional

The NetBackup version on the host.

string

osType
optional

The operating system type of the host.

string

osVersion
optional

The operating system of the host.

string

servers
optional

A list of servers associated with the host.

< string > array

patchSlpDefinition

Name Description Schema

attributes
optional

attributes

id
optional

The name of the storage lifecycle policy (SLP).

string

type
optional

Type of the object.

enum (slp)

attributes

Name Description Schema

operationList
optional

The operations that need to be updated.

< patchSlpOperationDefinition > array

patchSlpOperationDefinition

Name Description Schema

operationIndex
required

Indicates the execution order of the operations in the storage lifecycle policy (SLP), starting from index 1.

integer

storage
optional

storage

targetImportSLP
optional

The name of the storage lifecycle policy (SLP) created for the import operation to the target master server.

string

targetMasterServer
optional

The name of the target master server to replicate the image to.

string

storage

Name Description Schema

name
optional

The name of the storage unit or storage unit group to use for this operation.

string

patchSlpRequest

Name Schema

data
optional

patchSlpDefinition

peerHostInfo

Name Description Schema

hostId
optional

The host ID of the discovered peer host.

string

hostName
required

The name of the peer host that is used for the connection.

string

pluginInfoAttribute

Name Description Schema

configinstanceAttributesArray
optional

List the configuration instance attributes for the plug-in type.

< configinstanceAttributes > array

displayName
required

The external (displayed on the interface) name of the plug-in. For example, "Amazon AWS".

string

multipleConfigs
required

Indicates if multiple configuration instances for a plug-in are supported.

boolean

name
required

The valid name of the plug-in type. For example, for Amazon AWS the name value is "aws".

string

onHost
required

Indicates if the agent must reside on the host. For application-consistent snapshots, the agent must reside on the host. Crash-consistent snapshots require an off-host agent.

boolean

version
required

The version of the plug-in.

string

pluginTypeResponseArray

Name Schema

data
required

< configuredPluginType > array

policyCloud

Name Description Schema

backupSelections
optional

A string that identifies the elements within Cloud asset that will be protected.

backupSelections

clients
optional

For Cloud policy, it will be details of the details of asset to be protected.

< clients > array

policyAttributes
optional

The attributes of the policy.

policyAttributes

policyName
required

The name of the policy.

string

policyType
required

The type of the policy. For example, Cloud.

string

schedules
optional

The list of schedules information.

< schedules > array

backupSelections

Name Schema

selections
optional

< string > array

clients

Name Description Schema

OS
optional

The host’s operating system and the value for Cloud asset OS is CLOUD.

string

hardware
optional

The host’s hardware and the value for Clooud asset hardware is CLOUD.

string

hostName
optional

The asset ID of Cloud asset.

string

policyAttributes

Name Description Schema

active
optional

Indicates if the policy is active or disabled. For example, if you want to activate the policy set the flag to true.
Default : true

boolean

autoManagedLabel
optional

The label for automatically managed policy.

string

autoManagedType
optional

If non-zero, the policy is automatically managed. A value of 1 means managed by protection plan.
Minimum value : 0
Maximum value : 1

integer

dataClassification
optional

The data classification type such as Bronze, Silver, Gold, and Platinum. You can customize these values. This is an optional field.

string

effectiveDateUTC
optional

The date and time the policy goes into effect, in UTC format.

string (date-time)

jobLimit
optional

The maximum number of jobs that originate from this policy and can concurrently run at any given time. If the number of jobs is 0, maximum limit is not enforced.

integer

keyword
optional

An optional keyword phrase.

string

mediaOwner
optional

The media server or group that owns the media.
Default : "ANY"

string

priority
optional

The priority of jobs associated with this policy. The higher the number, the higher the priority (relative to other NetBackup jobs).
Minimum value : 0
Maximum value : 99999

integer

storage
optional

The name of the storage unit associated with the policy. For protecting Cloud asset set storage to ANY.

string

storageIsSLP
optional

Indicates if the storage unit is defined with a storage lifecycle policy (SLP).
Default : false

boolean

volumePool
optional

The volume pool that is associated with the policy.
Default : "NetBackup"

enum (NetBackup)

schedules

Name Description Schema

acceleratorForcedRescan
optional

Indicates if file checksums are stored to aid in change detection. This parameter applies only to to NetBackup Accelerator backups.

boolean

backupCopies
optional

The copy details for the policy. Entry 1 reflects the primary schedule copy, which is always enabled.

backupCopies

backupType
optional

The backup type of the schedule.

enum (Full Backup)

excludeDates
optional

The recurring days of the week, recurring days of the month, and exact dates on which this policy will not run. This parameter only applies to calendar-based schedules.

excludeDates

frequencySeconds
optional

For frequency schedule types, the frequency at which to perform the backup, in seconds.

integer

includeDates
optional

The recurring days of the week, recurring days of the month, and exact dates on which this policy will run. This is applicable only for calendar schedule types.

includeDates

mediaMultiplexing
optional

The maximum number of jobs from the schedule that NetBackup can multiplex onto any one drive. Valid values are 1 (no multiplexing) to 32.

integer

retriesAllowedAfterRunDay
optional

Specifies if the backups are retried on any day when there is an open backup window. This is applicable only for the calendar schedule type.

boolean

scheduleName
optional

The name of the schedule.

string

scheduleType
optional

The type of the schedule.

enum (Calendar, Frequency)

snapshotOnly
optional

Indicates if NetBackup should create only an Instant Recovery snapshot (leaving the storage unit unused). If disabled, NetBackup both creates a snapshot and copies the snapshot to a storage unit.
Default : false

boolean

startWindow
optional

The window during which the backup is allowed to start. Each day of the week is defined independently. Entry 1 is Sunday, entry 2 is Monday, and so on.

< startWindow > array

storageIsSLP
optional

Indicates if the storage unit is defined with a storage lifecycle policy (SLP).

boolean

syntheticBackup
optional

Specifies if a synthetic backup is performed.
Default : false

boolean

backupCopies

Name Description Schema

copies
optional

The list of copy information.

< copies > array

priority
optional

The priority of jobs that are associated with any additional copies that are specified. The higher the number, the higher the priority (relative to other NetBackup jobs). Note this has no impact on the primary copy.

integer

copies

Name Description Schema

failStrategy
optional

The approach taken if a particular image fails to copy.

enum (Fail All Copies)

mediaOwner
optional

The media server or group that owns this copy.

string

retentionPeriod
optional

The retention period for the copy to be specified in quantity and units.

retentionPeriod

storage
optional

The name of the storage unit that is associated with the copy.

string

volumePool
optional

The name of the volume pool that is associated with the copy.

string

retentionPeriod

Name Description Schema

unit
optional

The unit of the retention period in terms of time,for example,weeks,months,years and so on.

enum (SECONDS, MINUTES, HOURS, DAYS, WEEKS, MONTHS, YEARS, INFINITE)

value
optional

The value of the retention period in terms of unit defined.

integer

excludeDates

Name Description Schema

lastDayOfMonth
optional

Indicates if the last day of the month is included.

boolean

recurringDaysOfMonth
optional

The recurring days of the month.

< integer > array

recurringDaysOfWeek
optional

The recurring days of the week.

< string > array

specificDates
optional

A list of specific dates.

< string > array

includeDates

Name Description Schema

lastDayOfMonth
optional

Indicates if the last day of the month is included.

boolean

recurringDaysOfMonth
optional

The recurring days of the month.

< integer > array

recurringDaysOfWeek
optional

The recurring days of the week.

< string > array

specificDates
optional

A list of specific dates.

< string > array

startWindow

Name Description Schema

dayOfWeek
optional

The day of the week the backup window starts. Possible values for DAY are 1 (Sunday) through 7 (Saturday).

integer

durationSeconds
optional

The duration of the backup window, in seconds.

integer

startSeconds
optional

The start time of the backup window, expressed in seconds elapsed since the beginning of the day.

integer

policyGeneric

Name Description Schema

backupSelections
optional

The pathnames, VIP query and directives reflecting data to be backed up covered by this policy.

backupSelections

clients
optional

The list of client information.

< clients > array

policyAttributes
optional

The attributes of the policy.

policyAttributes

policyName
required

The name of the policy.

string

policyType
required

The type of the policy.

string

schedules
optional

The list of schedules information.

< schedules > array

backupSelections

Name Schema