Skip to main content

Create CDM Plan​

Select

SaaS
Customer Managed

Create a CDM Plan

Request Body
  • planName string required

    Name of the new plan

  • backupDestinations object[] required

    Copy destinations for the plan. Specify where you want to store your data.

  • backupDestinationName string required

    Backup destination details. Enter the name during creation.

  • storagePool object
  • id int32
  • name string
  • storageTemplateTags object[]

    It is used in Global config template plan creation. Needs in plan creation on global commcell

  • id int32
  • name string
  • value string
  • storageType StorageType

    Possible values: [ALL, DISK, CLOUD, HYPERSCALE, TAPE]

  • netAppCloudTarget boolean

    Only for snap copy. Enabling this changes SVM Mapping to NetApp cloud targets only.

  • isConfiguredForReplication boolean

    Used if the copy is used for replication group

  • isSnapCopy boolean

    Is this a snap copy? If isMirrorCopy is not set, then default is Vault/Replica.

  • isMirrorCopy boolean

    Is this a mirror copy? Only considered when isSnapCopy is true.

  • region object
  • id int32
  • GUID string
  • name string
  • sourceCopy object
  • id int32
  • name string
  • backupsToCopy string

    Possible values: [All_JOBS, ALL_FULLS, HOURLY_FULLS, DAILY_FULLS, WEEKLY_FULLS, MONTHLY_FULLS, QUARTERLY_FULLS, HALF_YEARLY_FULLS, YEARLY_FULLS, ADVANCED, MANUAL_JOBS]

    All_JOBS means SYNCHRONOUS copy type, others are applicable for SELECTIVE copy Type only.

  • fullBackupTypesToCopy PlanFullBackupTypeToCopy

    Possible values: [FIRST, LAST]

    Which type of backup type should be copied for the given backup destination when backup type is not all jobs. Default is LAST while adding new backup destination.

  • backupStartTime int32

    Backup start time in seconds. The time is provided in unix time format.

  • optimizeForInstantClone boolean

    Flag to specify if primary storage is copy data management enabled.

  • overrideRetentionSettings boolean

    Tells if this copy should use storage pool retention period days or the retention defined for this copy. Set as true to use retention defined on this copy.

  • retentionRuleType RententionRuleTypes

    Possible values: [RETENTION_PERIOD, SNAP_RECOVERY_POINTS]

    Which type of retention rule should be used for the given backup destination

  • retentionPeriodDays int32

    Possible values: >= 1 and <= 9999

    Default value: 30

    Retention period in days. -1 can be specified for infinite retention. If this and snapRecoveryPoints both are not specified, this takes precedence.

  • snapRecoveryPoints int32

    Possible values: >= 1

    Number of snap recovery points for snap copy for retention. Can be specified instead of retention period in Days for snap copy.

  • useExtendedRetentionRules boolean

    Use extended retention rules

  • extendedRetentionRules object

    If you want to update, specify the whole object. Extended retention rules should be bigger than retention period.

  • firstExtendedRetentionRule object
  • isInfiniteRetention boolean

    If this is set as true, no need to specify retentionPeriodDays.

  • retentionPeriodDays int32

    If this is set, no need to specify isInfiniteRetention as false.

  • type string

    Possible values: [All_JOBS, ALL_FULLS, HOURLY_FULLS, DAILY_FULLS, WEEKLY_FULLS, MONTHLY_FULLS, QUARTERLY_FULLS, HALF_YEARLY_FULLS, YEARLY_FULLS, ADVANCED, MANUAL_JOBS]

    All_JOBS means SYNCHRONOUS copy type, others are applicable for SELECTIVE copy Type only.

  • secondExtendedRetentionRule object
  • isInfiniteRetention boolean

    If this is set as true, no need to specify retentionPeriodDays.

  • retentionPeriodDays int32

    If this is set, no need to specify isInfiniteRetention as false.

  • type string

    Possible values: [All_JOBS, ALL_FULLS, HOURLY_FULLS, DAILY_FULLS, WEEKLY_FULLS, MONTHLY_FULLS, QUARTERLY_FULLS, HALF_YEARLY_FULLS, YEARLY_FULLS, ADVANCED, MANUAL_JOBS]

    All_JOBS means SYNCHRONOUS copy type, others are applicable for SELECTIVE copy Type only.

  • thirdExtendedRetentionRule object
  • isInfiniteRetention boolean

    If this is set as true, no need to specify retentionPeriodDays.

  • retentionPeriodDays int32

    If this is set, no need to specify isInfiniteRetention as false.

  • type string

    Possible values: [All_JOBS, ALL_FULLS, HOURLY_FULLS, DAILY_FULLS, WEEKLY_FULLS, MONTHLY_FULLS, QUARTERLY_FULLS, HALF_YEARLY_FULLS, YEARLY_FULLS, ADVANCED, MANUAL_JOBS]

    All_JOBS means SYNCHRONOUS copy type, others are applicable for SELECTIVE copy Type only.

  • mappings object[]
  • vendor

    Possible values: [NETAPP, AMAZON, PURE, AZURE]

    Snapshot vendors available for Snap Copy mappings

  • source object
  • id int32
  • name string
  • target object
  • id int32
  • name string
  • sourceVendor object
  • id int32
  • name string
  • targetVendor object
  • id int32
  • name string
  • subclients object[]
  • id int32
  • name string
  • mappingType

    Possible values: [DEFAULT_MAPPING, SUBCLIENT_MAPPING]

    Mapping type for pure storage replicaton

  • rpo object

    Recovery Point Objective (RPO) is the maximum amount of time that data can be lost during a service disruption. Your RPO determines the frequency of your backup jobs.

  • backupFrequency object
  • schedules object[]
  • scheduleId int32

    Id of the schedule if available, required for modifying, deleting schedule

  • scheduleName string

    Name of the schedule, for modify

  • policyId int32

    Schedule policy Id to which the schedule belongs

  • scheduleOperation string

    Possible values: [ADD, DELETE, MODIFY]

    Default value: MODIFY

    Operation being performed on schedule

  • vmOperationType string

    Possible values: [PLANNED_FAILOVER, TEST_BOOT]

    Type of DR operation (only applicable for Failover groups)

  • backupType string required

    Possible values: [FULL, INCREMENTAL, DIFFERENTIAL, SYNTHETICFULL, TRANSACTIONLOG, SNAPSHOT]

    Schedule Backup level

  • forDatabasesOnly boolean

    Default value: false

    Boolean to indicate if schedule is for database agents

  • isRetentionBasedSyntheticFull boolean

    Default value: false

    Boolean to indicate if synthetic full schedule is based on retention rules

  • isAuxCopySchedule boolean

    Default value: false

    Boolean to indicate if schedule is aux copy schedule.

  • schedulePattern object required

    Used to describe when the schedule runs

  • scheduleFrequencyType string required

    Possible values: [MINUTES, DAILY, WEEKLY, MONTHLY, YEARLY, AUTOMATIC]

    schedule frequency type

  • frequency int32

    Possible values: >= 1

    Frequency of the schedule based on schedule frequency type eg. for Hours, value 2 is 2 hours, for Minutes, 30 is 30 minutes, for Daily, 2 is 2 days. for Monthly 2 is it repeats every 2 months

  • weeklyDays string[]

    Possible values: [SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY]

    Days of the week for weekly frequency

  • dayOfMonth int32

    Possible values: >= 1 and <= 31

    Day on which to run the schedule, applicable for monthly, yearly

  • weekOfMonth string

    Possible values: [FIRST, SECOND, THIRD, FOURTH, LAST]

    Specific week of a month

  • dayOfWeek string

    Possible values: [SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, DAY, WEEKDAY, WEEKEND_DAYS]

  • monthOfYear string

    Possible values: [JANUARY, FEBRUARY, MARCH, APRIL, MAY, JUNE, JULY, AUGUST, SEPTEMBER, OCTOBER, NOVEMBER, DECEMBER]

  • repeatIntervalInMinutes int32

    Possible values: >= 1

    How often in minutes in a day the schedule runs, applicable for daily, weekly, monthly and yearly frequency types.

  • repeatUntilTime int32

    Until what time to repeat the schedule in a day, requires repeatIntervalInMinutes

  • timezone object
  • id int32
  • name string
  • startTime int32

    Default value: 75600

    start time of schedule in seconds

  • startDate int32

    start date of schedule in epoch format

  • endDate int32

    Schedule end date in epoch format

  • noOfTimes int32

    The number of times you want the schedule to run.

  • exceptions object[]

    Exceptions to when a schedule should not run, either in dates or week of month and days

  • onDates int32[]

    Possible values: >= 1 and <= 31

    list of dates in a month. For ex: 1, 20

  • onWeekOfTheMonth string[]

    Possible values: [FIRST, SECOND, THIRD, FOURTH, LAST]

    On which week of month, for ex: FIRST, LAST

  • onDayOfTheWeek string[]

    Possible values: [SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY, DAY, WEEKDAY, WEEKEND_DAYS]

    On which days, for ex: MONDAY, FRIDAY

  • daysBetweenSyntheticFulls int32

    Possible values: >= 6

    No of days between two synthetic full jobs

  • maxBackupIntervalInMins int32

    Default value: 240

    The number of mins to force a backup on automatic schedule.

  • calendarId int32

    Default value: 1

    Custom Calendar Id for the schedule

  • calendarName string

    Custom Calendar name for the schedule

  • jobStaggerDurationInMins int32

    Specifies the duration in minutes of how long scheduled jobs can be spread. Applicable for daily, weekly, monthly and yearly frequency types. Value of 0 means job staggering is disabled.

  • scheduleOption object

    Specific options to be set on schedules

  • useDiskCacheForLogBackups boolean

    Used to enable disk caching feature on databases for automatic schedules on server plan

  • commitFrequencyInHours int32

    Commit frequency in hours for disk cache backups from automatic schedules

  • daysBetweenAutoConvert int32

    Number of days between auto conversion of backup level applicable for databases on incremental and differential schedules of server plan

  • o365ItemSelectionOption string

    Possible values: [SELECT_ALL, SELECT_NEVER_PROCESSED, SELECT_MEETING_SLA, SELECT_NOT_MEETING_SLA_PROCESSED_ATLEAST_ONCE, SELECT_FAILED_LAST_ATTEMPT, SELECT_PROCESSED_ATLEAST_ONCE, SELECT_NOT_MEETING_SLA, SELECT_MEETING_SLA_NOT_RECENTLY_BACKED_UP]

    item backup option for O365 V2 backup jobs

  • jobRunningTimeInMins int32

    total job running time in minutes

  • minBackupIntervalInMins int32

    Default value: 15

    The min number of mins to check for file activity on automatic schedule.

  • logFilesThreshold int32

    Default value: 50

    The min number of archived log files before a backup job should start

  • logsDiskUtilizationPercent int32

    Default value: 80

    The min log destination disk threshold percentage

  • deleteLogsByAppLvlConfig boolean

    Delete backedup log files by Instance/BackupSet/Subclient settings

  • additionalInfo string
  • taskOperationType string

    Possible values: [BACKUP, SNAPSHOT]

    Schedule operation type

  • operationType string

    Possible values: [ADD, MODIFY, DELETE, NONE, OVERWRITE]

    Operation type for the list

  • backupWindow object[]

    Backup window for incremental backup

  • dayOfWeek string[]

    Possible values: [SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY]

  • startTime int64

    Time in seconds since the beginning of the day

  • endTime int64

    Time in seconds since the beginning of the day

  • fullBackupWindow object[]

    Backup window for full backup

  • dayOfWeek string[]

    Possible values: [SUNDAY, MONDAY, TUESDAY, WEDNESDAY, THURSDAY, FRIDAY, SATURDAY]

  • startTime int64

    Time in seconds since the beginning of the day

  • endTime int64

    Time in seconds since the beginning of the day

  • doNotSubmitJobForBackupWindow boolean

    Do not submit job option for incremental backup window.

  • doNotSubmitJobForFullBackupWindow boolean

    Do not submit job option for full backup window.

  • snapshotOptions object

    This feature applies only to File System Agents

  • snapRecoveryPoints int32

    Possible values: >= 1

    Number of snap recovery points for default snap copy for retention. Can be specified instead of retention period in Days for default snap copy.

  • retentionPeriodDays int32

    Default value: 30

    Retention period in days. -1 can be specified for infinite retention. If this and snapRecoveryPoints both are not specified, this takes precedence.

  • enableBackupCopy boolean

    Flag to enable backup copy

  • backupCopyRPOMins int32

    Default value: 240

    Backup copy RPO in minutes

  • enableSnapCatalog boolean

    Flag to enable deferred snapshot cataloging

  • backupCopyOptions object

    Options for snap management with backup copy

  • backupTypeToCopy BackupCopyFullBackupType

    Possible values: [All_JOBS, ALL_FULLS, HOURLY_FULLS, DAILY_FULLS, WEEKLY_FULLS, MONTHLY_FULLS, QUARTERLY_FULLS, HALF_YEARLY_FULLS, YEARLY_FULLS, MANUAL_JOBS]

    Backup type to copy for backup copy operation and deferred cataloging.

  • backupFullToCopy PlanFullBackupTypeToCopy

    Possible values: [FIRST, LAST]

    Which type of backup type should be copied for the given backup destination when backup type is not all jobs. Default is LAST while adding new backup destination.

  • startTime int32

    Snapshots to be copied from a particular time in unix time format. By default, 0 means since the inception of the snap copy.

  • enableAlert boolean

    Flag to enable backup copy fallen behind alert

  • alertInHours int32

    Default value: 48

    Alert to throw when backup copy falls behind in hours

  • action backupCopyFallenBehindAction

    Possible values: [BASED_ON_RETENTION, SKIP_IF_PENDING, WAIT_FOR_COMPLETION]

    Which type of action should be followed if backup copy falls behind

  • skipAfterThresholdDays int32

    Default value: 14

    The allowable delay in days before a backup copy job is considered overdue

  • databaseOptions object

    This feature applies only to database agents

  • logBackupRPOMins int32

    Log backup RPO in minutes

  • useDiskCacheForLogBackups boolean

    Use disk cache for log backups

  • commitFrequencyInHours int32

    Commit frequency in hours

Responses

Success

Schema
  • plan object
  • id int32
  • GUID string
  • name string
  • errors object[]
  • component string

    Plan Entity for which error occured

  • errorCode int32

    Error Code for plan

  • errorMessage string

    Error message for plan

POST /v4/cdmplan

Authorization

type: apiKeyname: Authtokenin: header

Request

Click Edit to configure Base URL
https://CommandCenterHostName/commandcenter/api
Security Scheme
token
Body
{

  "planName": "string",

  "backupDestinations": [

    null,

    null

  ],

  "rpo": {

    "backupFrequency": {

      "schedules": [

        {

          "scheduleId": 0,

          "scheduleName": "string",

          "policyId": 0,

          "scheduleOperation": "MODIFY",

          "vmOperationType": "PLANNED_FAILOVER",

          "backupType": "FULL",

          "forDatabasesOnly": false,

          "isRetentionBasedSyntheticFull": false,

          "isAuxCopySchedule": false,

          "schedulePattern": {

            "scheduleFrequencyType": "MINUTES",

            "frequency": 0,

            "weeklyDays": [

              "SUNDAY"

            ],

            "dayOfMonth": 0,

            "weekOfMonth": "FIRST",

            "dayOfWeek": "SUNDAY",

            "monthOfYear": "JANUARY",

            "repeatIntervalInMinutes": 0,

            "repeatUntilTime": 0,

            "timezone": {

              "id": 0,

              "name": "string"

            },

            "startTime": 75600,

            "startDate": 0,

            "endDate": 0,

            "noOfTimes": 0,

            "exceptions": [

              {

                "onDates": [

                  0

                ],

                "onWeekOfTheMonth": [

                  "FIRST"

                ],

                "onDayOfTheWeek": [

                  "SUNDAY"

                ]

              }

            ],

            "daysBetweenSyntheticFulls": 0,

            "maxBackupIntervalInMins": 240,

            "calendarId": 1,

            "calendarName": "string",

            "jobStaggerDurationInMins": 0

          },

          "scheduleOption": {

            "useDiskCacheForLogBackups": true,

            "commitFrequencyInHours": 0,

            "daysBetweenAutoConvert": 0,

            "o365ItemSelectionOption": "SELECT_ALL",

            "jobRunningTimeInMins": 0,

            "minBackupIntervalInMins": 15,

            "logFilesThreshold": 50,

            "logsDiskUtilizationPercent": 80,

            "deleteLogsByAppLvlConfig": true

          },

          "additionalInfo": "string",

          "taskOperationType": "BACKUP"

        }

      ],

      "operationType": "ADD"

    },

    "backupWindow": [

      {

        "dayOfWeek": [

          "SUNDAY"

        ],

        "startTime": 0,

        "endTime": 0

      }

    ],

    "fullBackupWindow": [

      {

        "dayOfWeek": [

          "SUNDAY"

        ],

        "startTime": 0,

        "endTime": 0

      }

    ],

    "doNotSubmitJobForBackupWindow": true,

    "doNotSubmitJobForFullBackupWindow": true

  },

  "snapshotOptions": {

    "snapRecoveryPoints": 0,

    "retentionPeriodDays": 30,

    "enableBackupCopy": true,

    "backupCopyRPOMins": 240,

    "enableSnapCatalog": true,

    "backupCopyOptions": {

      "backupTypeToCopy": "All_JOBS",

      "backupFullToCopy": "FIRST",

      "startTime": 1706110498,

      "enableAlert": true,

      "alertInHours": 48,

      "action": "BASED_ON_RETENTION",

      "skipAfterThresholdDays": 14

    }

  },

  "databaseOptions": {

    "logBackupRPOMins": 0,

    "useDiskCacheForLogBackups": true,

    "commitFrequencyInHours": 0

  }

}

curl -L -X POST 'https://CommandCenterHostName/commandcenter/api/V4/CDMPlan' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authtoken: <API_KEY_VALUE>' \
--data-raw '{
  "planName": "string",
  "backupDestinations": [
    null,
    null
  ],
  "rpo": {
    "backupFrequency": {
      "schedules": [
        {
          "scheduleId": 0,
          "scheduleName": "string",
          "policyId": 0,
          "scheduleOperation": "MODIFY",
          "vmOperationType": "PLANNED_FAILOVER",
          "backupType": "FULL",
          "forDatabasesOnly": false,
          "isRetentionBasedSyntheticFull": false,
          "isAuxCopySchedule": false,
          "schedulePattern": {
            "scheduleFrequencyType": "MINUTES",
            "frequency": 0,
            "weeklyDays": [
              "SUNDAY"
            ],
            "dayOfMonth": 0,
            "weekOfMonth": "FIRST",
            "dayOfWeek": "SUNDAY",
            "monthOfYear": "JANUARY",
            "repeatIntervalInMinutes": 0,
            "repeatUntilTime": 0,
            "timezone": {
              "id": 0,
              "name": "string"
            },
            "startTime": 75600,
            "startDate": 0,
            "endDate": 0,
            "noOfTimes": 0,
            "exceptions": [
              {
                "onDates": [
                  0
                ],
                "onWeekOfTheMonth": [
                  "FIRST"
                ],
                "onDayOfTheWeek": [
                  "SUNDAY"
                ]
              }
            ],
            "daysBetweenSyntheticFulls": 0,
            "maxBackupIntervalInMins": 240,
            "calendarId": 1,
            "calendarName": "string",
            "jobStaggerDurationInMins": 0
          },
          "scheduleOption": {
            "useDiskCacheForLogBackups": true,
            "commitFrequencyInHours": 0,
            "daysBetweenAutoConvert": 0,
            "o365ItemSelectionOption": "SELECT_ALL",
            "jobRunningTimeInMins": 0,
            "minBackupIntervalInMins": 15,
            "logFilesThreshold": 50,
            "logsDiskUtilizationPercent": 80,
            "deleteLogsByAppLvlConfig": true
          },
          "additionalInfo": "string",
          "taskOperationType": "BACKUP"
        }
      ],
      "operationType": "ADD"
    },
    "backupWindow": [
      {
        "dayOfWeek": [
          "SUNDAY"
        ],
        "startTime": 0,
        "endTime": 0
      }
    ],
    "fullBackupWindow": [
      {
        "dayOfWeek": [
          "SUNDAY"
        ],
        "startTime": 0,
        "endTime": 0
      }
    ],
    "doNotSubmitJobForBackupWindow": true,
    "doNotSubmitJobForFullBackupWindow": true
  },
  "snapshotOptions": {
    "snapRecoveryPoints": 0,
    "retentionPeriodDays": 30,
    "enableBackupCopy": true,
    "backupCopyRPOMins": 240,
    "enableSnapCatalog": true,
    "backupCopyOptions": {
      "backupTypeToCopy": "All_JOBS",
      "backupFullToCopy": "FIRST",
      "startTime": 1706110498,
      "enableAlert": true,
      "alertInHours": 48,
      "action": "BASED_ON_RETENTION",
      "skipAfterThresholdDays": 14
    }
  },
  "databaseOptions": {
    "logBackupRPOMins": 0,
    "useDiskCacheForLogBackups": true,
    "commitFrequencyInHours": 0
  }
}'