This operation returns the properties associated with a subclient policy.
Request
Syntax
GET <webservice>/SubclientPolicies/{subClientPolicyId} HTTP/1.1
Host: <host name>
Accept: {application/xml | application/json}
Authtoken: <authentication token>
where <webservice> is the root path used to route the API requests to the Web Server.
For more information, see Available Web Services for REST API.
Request Parameters
Name |
Description |
---|---|
subclientPolicyId |
The subclient policy ID for the subclient policy. If the subclient policy ID is not known, use the GET Subclient Policies API to retrieve it. |
Request Headers
Name |
Description |
---|---|
Host |
The host name of the Web Server or Web Console used in the API request. |
Accept |
The format of the response. Valid values are: application/xml or application/json. |
Authtoken |
The authentication token received after successfully logging on. For details on receiving an authentication token, see Authentication. |
Response
Response Parameters
Name |
Description |
Elements |
---|---|---|
backupsetId |
The system-generated ID assigned to the backup set. |
backupSetEntity |
_type_ |
backupSetEntity |
|
backupsetName |
The name of the backup set. |
backupSetEntity |
clientName |
The name of the client. |
subClientEntity |
instanceName |
The name of the instance, for example: DefaultInstanceName. |
subClientEntity |
backupsetId |
The system-generated ID assigned to the backup set. |
subClientEntity |
_type_ |
subClientEntity |
|
instanceId |
The system-generated ID assigned to the instance. |
subClientEntity |
subclientGUID |
The GUID of the subclient. |
subClientEntity |
subclientId |
The system-generated ID assigned to the subclient. |
subClientEntity |
clientId |
The system-generated ID assigned to the client. |
subClientEntity |
appName |
The name of the application, for example, Windows File System. |
subClientEntity |
backupsetName |
The name of the backup set. |
subClientEntity |
applicationId |
The ID of the application. Valid value is .1030 |
subClientEntity |
subclientName |
The name of the subclient. |
subClientEntity |
catalogACL |
The option to catalog ACLs (Access Control Lists). Valid values are True/False. |
fsSubClientPro |
useGlobalFilters |
The option to enable global filters. |
fsSubClientProp |
checkArchiveBit |
The option to reset the archive bit of every file backed up during incremental and differential backups. Valid values are True/False. |
fsSubClientProp |
olderFileVersionsMode |
The option to specify a value for the time period for which you want to retain the older versions of the file. Valid values are ON/OFF. |
fsSubClientProp |
backupRetentionMode |
The option to specify job-based retention or object-based retention. |
fsSubClientProp |
unixCtime |
The option to determine which files are selected for incremental backup by changes in the ctime timestamp. |
fsSubClientProp |
keepVersions |
The option to specify a value for the number of older versions you want to retain, starting from the latest backup. |
fsSubClientProp |
backupRetention |
The option to specify object-based retention. |
fsSubClientProp |
scanOption |
The method used to scan files before performing a backup. |
fsSubClientProp |
afterDeletionKeepItemsForNDays |
The option to specify when storage policy retention must be applied to the deleted items. |
fsSubClientProp |
unixMtime |
The option to determine which files are selected for incremental backup by changes in the mtime timestamp. |
fsSubClientProp |
runTrueUpJobAfterJobsForFS |
The option to run Reconcile backup operations for file system subclients. |
fsSubClientProp |
catalogAdditional |
The option to collect file and system data. The data is used in the Build-Your-Own Reports feature and the File Level Analytics Report. Valid values are True/False. |
fsSubClientProp |
oneTouchSubclient |
The option to enable/disable 1-Touch Recovery on Linux file system agents. 1-Touch Recovery can be enabled on only one subclient within a backup set. Valid values are True/False. |
fsSubClientProp |
extendRetentionForNDays |
fsSubClientProp |
|
customSubclientFlag |
fsSubClientProp |
|
isTrueUpOptionEnabledForFS |
The option specifies if Reconcile backup is enabled for File System subclients. |
fsSubClientProp |
enableContentIndexing |
fsSubClientProp |
|
retentionPolicy |
fsSubClientProp |
|
contentIndexingPolicy |
fsSubClientProp |
|
archiverRetentionMode |
fsSubClientProp |
|
enableOnePass |
The option to enable OnePass. Valid values are True/False. |
fsSubClientProp |
runTrueUpJobAfterDaysForFS |
fsSubClientProp |
|
useVSS |
The option to enable/disable VSS (Volume Shadow Copy Service) to back up the file system data. Valid values are True/False. |
fsSubClientProp |
isSynthfullRunAfterOnePassEnabledOnSubclient |
fsSubClientProp |
|
extendStoragePolicyRetention |
The option to enable retention criteria for archive subclients. Valid values are True/False. |
fsSubClientProp |
keepOlderVersionsForNDays |
fsSubClientProp |
|
clientId |
oneTouchServer |
|
_type_ |
oneTouchServer |
|
_type_ |
backupFilesOnOrAfterDate |
|
fileModifiedTimeOlderThan |
The option to archive files whose modified time is older than the number of days specified. To ignore this rule, enter 0. Valid values are 0-1000. |
diskCleanupRules |
fileSizeGreaterThan |
The option to archive files whose size is greater than the kilobytes specified. To ignore this rule, enter 0. Valid values are 0 and greater. |
diskCleanupRules |
stubPruningOptions |
The option to prune stubs from the source disk based on certain criteria such as file access time, file modified time, and file created time. |
diskCleanupRules |
afterArchivingRule |
The option to replace the archived file with a stub or to delete the archived file. |
diskCleanupRules |
stubRetentionDaysOld |
diskCleanupRules |
|
fileCreatedTimeOlderThan |
For Windows file systems only, the option to archive files whose created time is older than the number of days specified. To ignore this rule, enter 0. Valid values are 0-1000. |
diskCleanupRules |
maximumFileSize |
The option to archive files whose size is lesser than or equal to the kilobytes specified. To ignore this rule, enter 0. Valid values are 0 and greater. |
diskCleanupRules |
fileAccessTimeOlderThan |
The option to archive files whose access time is older than the number of days specified. To ignore this rule, enter 0. Valid values are 0-1000. |
diskCleanupRules |
startCleaningIfLessThan |
The option to stop archiving files based on the percentage of available free space on the volume. To ignore this rule, enter 100. Valid values are 0-100. |
diskCleanupRules |
stopCleaningIfupto |
The option to archive files based on the percentage of available free space on the volume. To ignore this rule, enter 100. Valid values are 0-100. |
diskCleanupRules |
rulesToSatisfy |
The option to ensure all rules are satisfied for archiving files. The default value is USE_ALL_RULES and cannot be changed. |
diskCleanupRules |
diskCleanupFileTypes |
The option to archive files based on file extensions. |
diskCleanupRules |
path |
The location of the content to back up. |
content |
excludePath |
The location of the content to exclude from the backup. |
content |
numberOfBackupStreams |
The option to set the number of backup streams. |
commonProperties |
nextBackupTime |
commonProperties |
|
isTurboSubclient |
The option to indicate that the subclient is an archiver subclient. |
commonProperties |
idaType |
The option to archive files based on the client type. |
commonProperties |
isKeepItemPastExpiryTime |
Valid values are True/False. |
commonProperties |
runTrueUpJobAfterDays |
commonProperties |
|
totalBackupSize |
commonProperties |
|
isAdAppAwareSubclient |
commonProperties |
|
isDefaultSubclient |
commonProperties |
|
lastBackupTime |
commonProperties |
|
indexingBackupSubClient |
commonProperties |
|
isTrueUpOptionEnabled |
commonProperties |
|
subClientPropertiesFlag |
commonProperties |
|
lastBackupSize |
commonProperties |
|
allowVssForSnapbackup |
commonProperties |
|
enableBackupAfterDelay |
commonProperties |
|
runAs |
The option to specify the user name who has permission to run the pre-process and post-process scripts. |
commonProperties |
enableBackup |
The option to enable/disable backup. Valid values are True/False. |
commonProperties |
backupCopyInterface |
The backup copy interface. Valid values are:
|
snapCopyInfo |
IsOracleSposDriverEnabled |
snapCopyInfo |
|
isRMANEnableForTapeMovement |
The option to enable or disable using RMAN for the backup copy. Valid values are:
|
snapCopyInfo |
runPostScan |
prepostProcess |
|
runPostBackup |
The option to run a process after the backup completes. Valid values are 1/0. |
prepostProcess |
runPostLog |
prepostProcess |
|
userGroupId |
associatedUserGroups |
|
_type_ |
associatedUserGroups |
|
userGroupName |
associatedUserGroups |
|
networkAgents |
The option to specify the number of processes the subclient uses to transfer data over a network. Valid values are 1-4 on Windows computers or 1-2 on UNIX computers. |
storageDevice |
softwareCompression |
The option to enable compression on the client or the MediaAgent computer. |
storageDevice |
throttleNetworkBandwidth |
The maximum network bandwidth per network agent (in megabytes per hour). Valid values are 2-2147483647. |
storageDevice |
_type_ |
dataBackupStoragePolicy |
|
storagePolicyName |
The name of the storage policy associated with the subclient policy. |
dataBackupStoragePolicy |
storagePolicyId |
The system-generated ID assigned to the storage policy associated with the subclient policy. |
dataBackupStoragePolicy |
enableDeduplication |
The option to enable deduplication on the subclient. Valid values are True/False. |
deDuplicationOptions |
generateSignature |
A component of deduplication performed on the client or MediaAgent computer. |
deDuplicationOptions |
perfSPName |
performanceMode |
|
multiplexingValid |
Valid values are True/False. |
performanceMode |
enableMultiplexing |
The option to enable multiplexing on the storage policy copy. Valid values are True/False. |
performanceMode |
perfCopyName |
performanceMode |
|
perfClientName |
performanceMode |
|
streamsOverMux |
The option on the storage policy copy to copy data streams to available drives first and then fill the drives (spill and fill). Valid values are True/False. |
performanceMode |
pipelineBufferSize |
The pipeline buffer size. |
performanceMode |
numOfPipelineBuffers |
The number of pipeline buffers. |
performanceMode |
muxFactor |
When multiplexing is enabled, the number of data streams from a storage policy copy that are to be backed up concurrently to the same media. |
performanceMode |
lookAheadReaderSlots |
The option to improve the DASH copy and DASH full efficiency by performing more lookups on the destination deduplication databases (DDBs) for the deduplication block signatures. Valid values are 1 to 256. |
performanceMode |
crcOverMedia |
perfCRCDetails |
|
perfMaId |
perfCRCDetails |
|
crcOverNetwork |
perfCRCDetails |
|
perfMa |
perfCRCDetails |
|
idaType |
subclientPolicy |
|
modifiedTime |
subclientPolicy |
|
dissociateBackupsets |
subclientPolicy |
|
description |
subclientPolicy |
|
status |
subclientPolicy |
|
_type_ |
subclientPolicyEntity |
|
subclientPolicyId |
The system-generated ID assigned to the subclient policy. |
subclientPolicyEntity |
subclientPolicyName |
The name of the subclient policy. |
subclientPolicyEntity |
Examples
Sample Request
GET <webservice>/SubclientPolicies/8 HTTP/1.1
Host: client.mydomain.com
Accept: application/json
Authtoken: QSDK 38568012f4d1e8ee1841d283a47aa3ba78e124ea58354b5fc6
0f4dab8a63347d05cf5552484dafda3bfa4c5db84e580b1cb37bcf8e65b39f7f
8549a443e6f78a2c7be3f31b3d845e24776c835e498e8e883bb40c46bd15af4f
40ca94e823acedcdd4e9659e74b34a07a85c4586cd2ed914b6dce015874783ef7
68fda78183a4208930954a377f66eb56c8b92cexampl4s437a19317ca6ce7f323
3d5a01aca35dbad93468b833f2cf71010809006a937670adce711ca8be46638e8
Sample Response
{ "idatype": 3, "subClientPoliciesInfo": { "subClientPolicy": { "backupSetEntity": { "backupsetId": 8, "_type_": 6, "backupsetName": "Laptop plan Linux subclient policy" }, "subClientList": [ { "hcSubclientProp": {}, "impersonateUser": {}, "proxyClient": {}, "subClientEntity": { "clientName": "winter", "instanceName": "DefaultInstanceName", "backupsetId": 8, "_type_": 7, "instanceId": 1, "subclientGUID": "DB0B4B17-5C83-4C9A-80A3-73ED27F4065A", "subclientId": 8, "clientId": 2, "appName": "Subclient Policy", "backupsetName": "Laptop plan Linux subclient policy", "applicationId": 1030, "subclientName": "default" }, "dfsSubClientPropp": { "distributedDataAccessNodes": {} }, "fsSubClientProp": { "catalogACL": true, "useGlobalFilters": 2, "forcedArchiving": false, "checkArchiveBit": false, "olderFileVersionsMode": 2, "backupRetentionMode": 1, "unixCtime": true, "keepVersions": 5, "backupRetention": true, "scanOption": 1, "afterDeletionKeepItemsForNDays": 730, "unixMtime": true, "runTrueUpJobAfterJobsForFS": 0, "catalogAdditional": false, "oneTouchSubclient": false, "extendRetentionForNDays": -1, "customSubclientFlag": true, "isTrueUpOptionEnabledForFS": false, "enableContentIndexing": false, "retentionPolicy": 0, "contentIndexingPolicy": 0, "archiverRetentionMode": 2, "enableOnePass": false, "runTrueUpJobAfterDaysForFS": 30, "useVSS": true, "isSynthfullRunAfterOnePassEnabledOnSubclient": false, "extendStoragePolicyRetention": false, "keepOlderVersionsForNDays": 0, "ibmiSubclientprop": {}, "backupConfiguration": {}, "oneTouchServer": { "clientId": 0, "_type_": 3 }, "backupFilesOnOrAfterDate": { "_type_": 55 }, "diskCleanupRules": { "fileModifiedTimeOlderThan": 90, "fileSizeGreaterThan": 1024, "stubPruningOptions": 0, "afterArchivingRule": 1, "stubRetentionDaysOld": 0, "fileCreatedTimeOlderThan": 0, "maximumFileSize": 0, "fileAccessTimeOlderThan": 90, "startCleaningIfLessThan": 50, "patternMatch": "", "stopCleaningIfupto": 80, "rulesToSatisfy": 1, "entityMatch": "", "diskCleanupFileTypes": {} }, "ocsUserName": {} }, "planEntity": {}, "cassandraProps": {}, "content": [ { "path": "/%Desktop%" }, { "path": "/%Documents%" }, { "path": "/%Office%" }, { "path": "/%Music%" }, { "path": "/%Pictures%" }, { "path": "/%Videos%" }, { "excludePath": "*.vdi" }, { "excludePath": "/%Temporary Files%" } ], "commonProperties": { "numberOfBackupStreams": 1, "nextBackupTime": 0, "isTurboSubclient": false, "idaType": 3, "isKeepItemPastExpiryTime": true, "runTrueUpJobAfterDays": 30, "totalBackupSize": 0, "isAdAppAwareSubclient": false, "isDefaultSubclient": true, "lastBackupTime": 0, "indexingBackupSubClient": false, "isTrueUpOptionEnabled": false, "subClientPropertiesFlag": 0, "lastBackupSize": 0, "allowVssForSnapbackup": false, "enableBackupAfterDelay": false, "runAs": 0, "enableBackup": true, "securityAssociations": { "ownerAssociations": {} }, "enableBackupAtDateTime": { "TimeZoneID": 0, "time": 0 }, "turboNASClient": { "clientId": 0, "_type_": 3 }, "associatedSnapShotSCId": { "_type_": 7 }, "snapCopyInfo": { "backupCopyInterface": 0, "IsOracleSposDriverEnabled": false, "isRMANEnableForTapeMovement": false, "useProxyForSQLIntegrity": {}, "sybaseUser": {}, "snapToTapeSelectedEngine": { "_type_": 110 }, "sqlUser": {}, "vmApplicationUser": {}, "snapToTapeProxyToUse": { "_type_": 3 }, "quiesceImpersonateUser": {}, "separateProxyForSnapToTape": { "_type_": 3 }, "sshKey": {}, "configuredSybaseInstance": { "_type_": 5 } }, "prepostProcess": { "runPostScan": 0, "runPostBackup": 0, "runPostLog": 0, "prepostUserName": {} }, "security": { "clientOwners": [ "admin" ], "associatedUserGroups": [ { "userGroupId": 1, "_type_": 15, "userGroupName": "master" }, { "userGroupId": 3, "_type_": 15, "userGroupName": "View All" } ], "ownerCapabilities": {} }, "storageDevice": { "networkAgents": 1, "softwareCompression": 2, "throttleNetworkBandwidth": 0, "dataBackupStoragePolicy": { "_type_": 17, "storagePolicyName": "Laptop plan", "storagePolicyId": 5 }, "deDuplicationOptions": { "enableDeduplication": true, "generateSignature": 1 }, "logBackupStoragePolicy": { "_type_": 17 }, "performanceMode": { "perfSPName": "Laptop plan", "multiplexingValid": false, "enableMultiplexing": false, "perfCopyName": "Primary", "perfClientName": "winter", "streamsOverMux": false, "pipelineBufferSize": 64, "numOfPipelineBuffers": 90, "muxFactor": 0, "lookAheadReaderSlots": 4, "perfCRCDetails": [ { "crcOverMedia": true, "perfMaId": 3, "crcOverNetwork": true, "perfMa": "winterma" } ] } }, "prepostCredentialinfo": { "credentialId": 0, "credentialName": "" }, "associatedPolicy": { "subclientPolicyId": 8 }, "impersonateUserCredentialinfo": { "credentialId": 0, "credentialName": "" } }, "analyticsSubclientProp": {} } ] } }, "subclientPolicy": { "idaType": 3, "modifiedTime": 1522950999, "dissociateBackupsets": false, "description": "", "status": 128, "securityAssociations": { "ownerAssociations": {} }, "subclientPolicyEntity": { "_type_": 65, "subclientPolicyId": 8, "subclientPolicyName": "Laptop plan Linux subclient policy" } }, "error": { "errorMessage": "", "errorCode": 0 }
}