Skip to main content

Create Backup Destination for Server Plan​

Select

SaaS
Customer Managed

Create a Backup Destination for a Plan

Path Parameters
  • planId int32 required

    Id of the Plan to modify

Request Body
  • destinations object[] required

    List of backup destinations to create

  • 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

  • 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

  • region object
  • id int32
  • GUID string
  • name string
Responses

Success

Schema
  • planBackupDestination object[]

    List of destinations effected or created

  • id int32
  • name string
  • failedDestinations string[]

    List of destinations for which the operation failed

  • error object
  • errorMessage string
  • errorCode int32
POST /v4/serverplan/:planid/backupdestination

Authorization

type: apiKeyname: Authtokenin: header

Request

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

  "destinations": [

    null,

    null

  ],

  "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

    }

  },

  "region": {

    "id": 0,

    "GUID": "string",

    "name": "string"

  }

}

curl -L -X POST 'https://CommandCenterHostName/commandcenter/api/V4/ServerPlan/:planId/BackupDestination' \
-H 'Content-Type: application/json' \
-H 'Accept: application/json' \
-H 'Authtoken: <API_KEY_VALUE>' \
--data-raw '{
  "destinations": [
    null,
    null
  ],
  "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
    }
  },
  "region": {
    "id": 0,
    "GUID": "string",
    "name": "string"
  }
}'