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
Loading...