Update Backup Destination details of DR backup destination
Select
Modify Backup Destination details for CommServe DR backups
Path Parameters
- BackupDestinationId int32 required
Id of the backupDestination to be modified
- application/json
Request Body
- newName string
New name for backup destination
general object
source object
id int32name stringisActive booleanToggle to keep backup destination active
complianceLock booleanToggle to enable compliance lock on backup destination. One time operation, once enabled cannot be disabled and if it is enabled retention on backup destination cannot be lowered.
isImmutableSnapCopy booleanToggle to enable immutable snap for snap copy
backupType object
backupTypesToCopy stringPossible values: [
All_JOBS
,ALL_FULLS
,HOURLY_FULLS
,DAILY_FULLS
,WEEKLY_FULLS
,MONTHLY_FULLS
,QUARTERLY_FULLS
,HALF_YEARLY_FULLS
,YEARLY_FULLS
,ADVANCED
]All_JOBS means SYNCHRONOUS copy type, others are applicable for SELECTIVE copy Type only.
backupTypesCopiedFrom int32Tells what start date, backup types should be copied from. The date is provided in unix time format in number of seconds. -1 means initial backup date.
fullBackupTypesToCopy PlanFullBackupTypeToCopyPossible 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.
retentionRules object
enableDataAging booleanTells if this copy has data aging enabled
overrideRetentionSettings booleanTells 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 RententionRuleTypesPossible values: [
RETENTION_PERIOD
,SNAP_RECOVERY_POINTS
]Which type of retention rule should be used for the given backup destination
retentionPeriodDays int32Possible values:
>= 1
and<= 9999
Retention period in days
snapRecoveryPoints int32Number of snap recovery points for snap copy for retention
useExtendedRetentionRules booleanShould extended retention rules be used
extendedRetentionRules object
If you want to update, specify the whole object. Extended retention rules should be bigger than retention period.
firstExtendedRetentionRule object
isInfiniteRetention booleanIf this is set as true, no need to specify retentionPeriodDays.
retentionPeriodDays int32If this is set, no need to specify isInfiniteRetention as false.
type stringPossible values: [
All_JOBS
,ALL_FULLS
,HOURLY_FULLS
,DAILY_FULLS
,WEEKLY_FULLS
,MONTHLY_FULLS
,QUARTERLY_FULLS
,HALF_YEARLY_FULLS
,YEARLY_FULLS
,ADVANCED
]All_JOBS means SYNCHRONOUS copy type, others are applicable for SELECTIVE copy Type only.
secondExtendedRetentionRule object
isInfiniteRetention booleanIf this is set as true, no need to specify retentionPeriodDays.
retentionPeriodDays int32If this is set, no need to specify isInfiniteRetention as false.
type stringPossible values: [
All_JOBS
,ALL_FULLS
,HOURLY_FULLS
,DAILY_FULLS
,WEEKLY_FULLS
,MONTHLY_FULLS
,QUARTERLY_FULLS
,HALF_YEARLY_FULLS
,YEARLY_FULLS
,ADVANCED
]All_JOBS means SYNCHRONOUS copy type, others are applicable for SELECTIVE copy Type only.
thirdExtendedRetentionRule object
isInfiniteRetention booleanIf this is set as true, no need to specify retentionPeriodDays.
retentionPeriodDays int32If this is set, no need to specify isInfiniteRetention as false.
type stringPossible values: [
All_JOBS
,ALL_FULLS
,HOURLY_FULLS
,DAILY_FULLS
,WEEKLY_FULLS
,MONTHLY_FULLS
,QUARTERLY_FULLS
,HALF_YEARLY_FULLS
,YEARLY_FULLS
,ADVANCED
]All_JOBS means SYNCHRONOUS copy type, others are applicable for SELECTIVE copy Type only.
fullBackupTypesToBeRetained PlanFullBackupTypeToCopyPossible 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.
copyPromotionOptions object
immediate booleanTells if the copy has to be promoted immediately.
hours int32Tells the number of hours to wait before failing/killing jobs for copy promotion
waitForRunningJobs booleanTells if copy promotion needs to wait for running jobs
waitForSynchronize booleanTells if copy promotion needs to wait for synchronization of copies.
forceKill booleanTells if we need to force kill jobs and promote copy after waiting.
mappings object[]
vendorPossible values: [
NETAPP
,AMAZON
,PURE
,AZURE
]Snapshot vendors available for Snap Copy mappings
source object
id int32name stringtarget object
id int32name stringsourceVendor object
id int32name stringtargetVendor object
id int32name stringsubclients object[]
id int32name stringmappingTypePossible values: [
DEFAULT_MAPPING
,SUBCLIENT_MAPPING
]Mapping type for pure storage replicaton
snapOptions object
isSourceBackupCopy booleanIs this the source snap copy for backup copy operations?
- 200
- 404
- 500
Success
- application/json
- Schema
- Example (from schema)
Schema
planBackupDestination object[]
List of destinations effected or created
id int32name string- failedDestinations string[]
List of destinations for which the operation failed
error object
errorMessage stringerrorCode int32
{
"planBackupDestination": [
{
"id": 0,
"name": "string"
}
],
"failedDestinations": [
"string"
],
"error": {
"errorMessage": "string",
"errorCode": 0
}
}
Requested Details not found
Server Error
- application/json
- Schema
- Example (from schema)
Schema
- errorMessage string
- errorCode int32
{
"errorMessage": "string",
"errorCode": 0
}