Skip to main content

Get Backup Destination details of ServerPlan​

Select

SaaS
Customer Managed

Get specific backup destination details for a server plan

Path Parameters
  • planId int32 required

    Id of the plan to retrieve backup destination

  • BackupDestinationId int32 required

    Id of the backup destination

Responses

Success

Schema
  • plan object
  • id int32
  • name string
  • planBackupDestination object
  • id int32
  • name string
  • configurable boolean

    Flag to specify whether backup destination is configurable (True when it belongs to a base plan or a derived plan with overriden storage pool)

  • region object
  • id int32
  • name string
  • displayName string
  • general object
  • storage object
  • id int32

    Id of Storage Pool

  • name string

    Name of Storage Pool

  • type

    Possible values: [DEDUPLICATION, SECONDARY_COPY, NON_DEDUPLICATION, SCALE_OUT]

    Type of Storage Pool

  • retentionPeriodDays int32

    Retention period of pool in days

  • wormStoragePoolFlag int32

    Bit flag indicating WORM configuration of storage pool. 0 means no lock, 1 means compliance lock, 2 means worm storage lock, 4 means Object worm lock and 8 means bucket worm lock.

  • deviceType object
  • id int32

    Device Type Id of the storage.

  • name string

    Possible values: [DEFAULT, MAGNETIC, AMAZON_S3, MICROSOFT_AZURE_STORAGE, NIRVANIX_MFS, RACKSPACE_CLOUD_FILES, IRON_MOUNTAIN_ARCHIVE, EMC_ATMOS, ATT_SYNAPTIC, CV_OBJECT_SERVER, HITACHI_CONTENT_PLATFORM, MEZEO_CS, OPENSTACK_OBJECT_STORAGE, AMPLIDATA, CHINA_MOBILE_ONEST, HDFS, VERIZON_CLOUD, GOOGLE_CLOUD_STORAGE, VMWARE_CLOUD, ORACLE_STORAGE_CLOUD_SERVICE, ORACLE_STORAGE_CLOUD_ARCHIVE_SERVICE, ALIBABA_CLOUD_OBJECT_STORAGE_SERVICE, HUAWEI_OBJECT_STORAGE, ORACLE_CLOUD_INFRASTRUCTURE_OBJECT_STORAGE_S3, ORACLE_CLOUD_INFRASTRUCTURE_OBJECT_STORAGE, TELEFONICA_OPEN_CLOUD_OBJECT_STORAGE, ORACLE_CLOUD_INFRASTRUCTURE_ARCHIVE_STORAGE, INSPUR_CLOUD, IBM_CLOUD, AZURE_DATA_LAKE_STORE, KINGSOFT_KS3, MICROSOFT_ONEDRIVE, IRON_MOUNTAIN_CLOUD, MICROSOFT_FILE_SHARE, AZURE_DATA_LAKE_STORE_GEN2, MICROSOFT_AZURE_COMPATIBLE, S3_COMPATIBLE_STORAGE, CARINGO_CASTOR, DELL_DX_OBJECTSTORAGE, AMAZON_GLACIER, DDN_WOS, GENERIC_HARDWARE_DEDUPE_DEVICE, BOOST_HARDWARE_DEDUPE_DEVICE, HPE_CATALYST_STORAGE, ISILON_ONEFS, LOCAL_FILE, LOCAL_FILE_WITH_PROP_S3, LOCAL_FILE_WITH_PROP_AZURE, CEPH_OBJECT_GATEWAY_S3, CLOUDIAN_HYPERSTORE, DELL_EMC_ECS_S3, FUJITSU_STORAGE_ETERNUS, HITACHI_CLOUD_PLATOFORM_CLOUD_SCALE, IBM_CLOUD_OBJECT_STORAGE_S3, NETAPP_STORAGEGRID, CCL_VAULT_V2, SCALITY_RING, WASABI_HOT_CLOUD_STORAGE, NUTANIX_OBJECTS, NETAPP_ONTAP_S3, HITACHI_CLOUD_SCALE, PURE_STORAGE_FLASHBLADE, VAST_DATA, METALLIC_RECOVERY_RESERVE, METALLIC_RECOVERY_RESERVE_AZURE_HOT, METALLIC_RECOVERY_RESERVE_AZURE_COOL, METALLIC_RECOVERY_RESERVE_OCI_STANDARD, METALLIC_RECOVERY_RESERVE_OCI_INFREQUENT_ACCESS, METALLIC_BUNDLED_STORAGE_O365, METALLIC_BUNDLED_STORAGE_ENDPOINT, METALLIC_BUNDLED_STORAGE__SALESFORCE, METALLIC_BUNDLED_STORAGE_D365, METALLIC_BUNDLED_STORAGE_AZURE_AD, METALLIC_BUNDLED_STORAGE_AZURE_MAAS, MICROSOFT_AZURE_MANAGEMENT, MICROSOFT_AZURE_MANAGEMENT_BLOB, MICROSOFT_AZURE_MANAGEMENT_FILE]

    Device type of the storage.

  • storageClass string

    Possible values: [DEFAULT, AWS_STANDARD, AWS_REDUNDANCY, AWS_SIA, AWS_ONEZONE_IA, AWS_IT, AWS_GLACIER, AWS_GLACIER_STANDARD, AWS_GLACIER_SIA, AWS_GLACIER_OZIA, AWS_GLACIER_IT, AWS_DEEP_ARCHIVE, AWS_DA_STANDARD, AWS_DA_SIA, AWS_DA_OZIA, AWS_DA_IT, AWS_GLACIER_IR, AWS_GLACIER_IR_STANDARD, AWS_GLACIER_IR_SIA, AWS_GLACIER_IR_OZIA, AWS_GLACIER_IR_IT, AZURE_DEFAULT, AZURE_HOT, AZURE_COOL, AZURE_ARCHIVE, AZURE_HOT_ARCHIVE, AZURE_COOL_ARCHIVE, AZURE_COLD, AZURE_HOT_COLD, AZURE_COOL_COLD, GOOGLE_STANDARD, GOOGLE_DR_AVAILABILITY, GOOGLE_NEARLINE, GOOGLE_COLDLINE, GOOGLE_ARCHIVE, GOOGLE_DEFAULT, ALI_DEFAULT, ALI_STANDARD, ALI_IA, ALI_ARCHIVE, ALI_ARCHIVE_STANDARD, ALI_ARCHIVE_IA, K3S_STANDARD, K3S_IA, ORACLE_STANDARD, ORACLE_IA, ORACLE_ARCHIVE, ORACLE_STANDARD_ARCHIVE, ORACLE_IA_ARCHIVE]

    Storage class of the Storage Pool

  • isArchiveStorage boolean

    Flag indicating whether the storage tier is archive.

  • region object
  • id int32
  • name string
  • displayName string
  • storageType StorageType

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

  • source object
  • id int32
  • name string
  • netAppCloudTarget boolean

    Only for snap copy. Tells if the snap copy supports SVM Mapping to NetApp cloud targets only.

  • isImmutableSnapCopy boolean

    Only for snap copy. Tells if the snap copy has immutable snap option enabled.

  • isDefault boolean

    Is this a default backup destination?

  • isActive boolean

    Is this an active backup destination?

  • isCopyInMaintenanceMode boolean

    Is this copy in Maintenance mode?

  • isCopyPromotionRequestSubmitted boolean

    Is copy promotion request submitted for this copy?

  • complianceLock boolean

    Is compliance lock enabled on backup destination?

  • isSnapCopy boolean

    Is this a snap copy?

  • isMirrorCopy boolean

    Is this a mirror copy?

  • isAirgapCopy boolean

    Set to true if this copy uses Airgap storage

  • copyType

    Possible values: [SYNCHRONOUS, SELECTIVE, PRIMARY]

  • snapCopyType

    Possible values: [DEFAULT_MIRROR, DEFAULT_VAULT_REPLICA, MIRROR, VAULT_REPLICA, SNAPSHOT_PRIMARY]

  • copyPrecedence int32

    Order of backup destinaion copy created in storage policy

  • backupType object
  • backupTypesToCopy string

    Possible 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 int32

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

  • retentionRules object
  • enableDataAging boolean

    Tells if this copy has data aging 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

    Retention period in days

  • snapRecoveryPoints int32

    Number of snap recovery points for snap copy for retention

  • useExtendedRetentionRules boolean

    Should 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 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]

    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]

    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]

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

  • fullBackupTypesToBeRetained 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.

  • 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

  • globalConfigInfo object

    Only applicable on Global CommCells

  • id string
  • name string
  • commcells object[]

    List of Service CommCells where the global configuration is applied

  • id int32
  • name string
  • guid string
  • scope string

    The entity level at which the config is applied.

  • scopeFilterQuery string

    CommCellEntityCache filter query string used for filtering the scope

  • applyOnAllCommCells boolean

    Decides whether the global configuration should be applied to all the Service commcells, including the newly created ones

  • isMarkedForDeletion boolean

    Indicates whether global configuration deletion has been started.

  • status string
  • snapOptions object
  • isSourceBackupCopy boolean

    Is this the source snap copy for backup copy operations?

GET /v5/serverplan/:planid/backupdestination/:backupdestinationid

Authorization

type: apiKeyname: Authtokenin: header

Request

Click Edit to configure Base URL
https://CommandCenterHostName/commandcenter/api
Security Scheme
token
planId — path required
BackupDestinationId — path required
curl -L -X GET 'https://CommandCenterHostName/commandcenter/api/V5/ServerPlan/:planId/BackupDestination/:BackupDestinationId' \
-H 'Accept: application/json' \
-H 'Authtoken: <API_KEY_VALUE>'