Backup Task API

Deleting a Backup Task

To delete a Backup Task, you can use the following Policy API calls:

• deletePolicy
• deletePolicyById

Follow the instructions below to delete a Backup Task using API samples.

Note The following instructions are valid for the Linux CentOS operating system.

1. Log in by shell or remote shell (Local or SSH) to the machine where the CDP API samples are located.

Notice Make sure the API server is enabled on a known port on the target CDP Server. Make sure you have Super-User credentials for the target CDP Server. Make sure one or more policies have been created already.

2. Launch the console and run the following command:

This will install the packages needed for working with .php files.

3. Change the working directory to:

If you use the ls command, you will see a list of all available api samples.

4. To delete a specific Policy, execute the "deletePolicy.php" sample. You will need to provide the following parameters:

• hostname/IP
• (API) port
• user
• password
• Policy ID.
  

To find the Policy IDs, use the "getPolicyIDs.php" sample.

5. The Policy will be deleted.

Displaying Information about Backup Task Scheduling

The Policy commands below provide details about Backup Task scheduling:

• getPolicyIDs
• getPolicies
• getPolicyById

1. Log in by shell or remote shell (Local or SSH) to the machine where the CDP API samples are located.

Notice Make sure the API server is enabled on a known port on the target CDP Server. Make sure you have Super-User credentials for the target CDP Server. Make sure one or more policies have been created already.

2. Launch the console.

Notice You should already have php-cli and php-soap packages installed.

3. Change the working directory to:

If you use the ls command, you will see a list of all available api samples.

4. Execute any of the following samples to retrieve information about existing Policies, providing appropriate values for accessing the CDP server:

• hostname/IP
• (API) port
• user
• password
• Policy ID (where required).

The results are shown below:

Parameters:

• scheduledTaskID - The ID of the Scheduled Task to edit.
• enabled - Whether the Task should be enabled when created.
• description - The description for the Scheduled Task.
• recoveryPointsToKeep - The number of Recovery Points to keep ("Retention Policy").
• runVerifyTask - Whether to launch a Verify Task when the Backup finishes.
• runDefragmentTask - Whether to launch a Defragment Task when Backup finishes.
• backupAllActiveDevices - Whether to Backup all active devices.

  Note If true, diskDevicePaths and partitionDevicePaths are ignored.

• diskDevicePaths - An array of strings specifying the device paths of the Disks to be backed up.
• partitionDevicePaths - An array of strings specifying the device paths of the partitions to be backed up.
• frequency - The frequency (MINUTELY, HOURLY, DAILY, WEEKLY, MONTHLY, NO_RECURRENCE) for the schedule.

  Note MINUTELY = 1, HOURLY = 2, DAILY = 3, WEEKLY = 4, MONTHLY = 5, NO_RECURRENCE = 7