Get details for recovery group
Select
Get details for recovery group
Path Parameters
- recoveryGroupId integer required
Recovery group Id
Query Parameters
- getEntityDetails boolean
Get the entity details with recovery group details
- 200
- 404
OK
- application/json
- Schema
- Example (from schema)
Schema
recoveryGroup object
Model to provide basic detail of recovery group
id int32Id of the recovery group
name stringName of the recovery group
target object
id int32name stringpostRecoveryActions object[]
path stringThe path of the script to be executed. Can be local path on VM or UNC path accessible by access node
type stringPossible values: [
UNC
,LOCAL
]The type of path being used for DR operation script
scriptCredentials object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
guestCredentials object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
guid stringUnique script identifier string
scriptContent stringContent of the script to be executed
scriptName stringName of the script
reset booleanOn set to true, resets the script to empty
osType stringPossible values: [
WINDOWS
,UNIX
]OS types
delayBetweenPriorityMachines int32The delay between machines in different priorities in minutes
continueOnFailure booleanDefault value:
false
Set to true to continue to the next priority machines on failure
action RecoveryActionPossible values: [
CREATE
,UPDATE
,DELETE
]Recovery Action
recoveryPointDetails object
Contains the information regarding the recovery group level recoveryPoint selection
recoveryPoint int32Timestamp for group restore in case of disaster
recoveryPointCategory stringPossible values: [
LATEST
,POINT_IN_TIME
,AUTOMATIC
]Default value:
LATEST
Type of recovery point category
recoveryPoint int32Timestamp for group restore in case of disaster
recoveryExpirationOptions object
enableExpirationOption booleanDefault value:
true
If true, cleans up recovered VMs after the set daysToExpire value
daysToExpire int32Default value:
7
Number of days after which recovered VMs are automatically cleaned up
isRescuedCommServe booleanWhether the CommServe is rescued or not
expirationTime int32Timestamp when the clean up of all recovered VMs happens on the rescued CommServe. It happens 4 hours before the CommServe expiration time
entities object[]
id int32Id of the recovery entity
name stringName of the recovery entity
entity object
id int32name stringrecoveryGroup object
id int32name stringworkload stringPossible values: [
GENERIC
,O365
,SALESFORCE
,EXCHANGE
,SHAREPOINT
,ONEDRIVE
,TEAMS
,DYNAMICS_365
,VSA
,FILESYSTEM
,KUBERNETES
,AZURE_AD
,CLOUD_LAPTOP
,FILE_STORAGE_OPTIMIZATION
,DATA_GOVERNANCE
,E_DISCOVERY
,SQL_SERVER
,ORACLEDB
,DB2
,ACTIVE_DIRECTORY
,DATABASE
]client object
id int32name stringbackupSet object
id int32name stringvmGroup object
id int32name stringvirtualMachine object
GUID stringname stringrecoveryConfiguration object
advancedOptions object
azure object
Advanced options for Azure replication group
unconditionalOverwrite booleanDefault value:
false
This will replace the instance at the destination if the instance with the same name already exists.
deployVmOnlyDuringfailover booleanDefault value:
true
Select this option to deploy a VM only when a failover operation is requested
configuration object
azure object
Replication configuration for Azure
sourceVM stringSource VM
destinationVM stringDestination VM
resourceGroup stringResource group in which the converted virtual machine should be created.
storageAccount stringAzure Standard or Premium general-purpose storage account.
vmSize stringVM size
createPublicIP booleanCreate a public IP.
restoreAsManagedVm booleanRestore the VM as a managed disk for the destination VMs.
overrideReplicationOptions object
Replication options for Azure
availabilityZone stringVM availability zone
securityGroup object
The id and the name of the security group
id stringSecurity group id
name stringsecurity group name
testFailoverVirtualNetwork object
Network interface for the destination instances
networkId stringNetwork unique identifier
networkDisplayName stringDisplay Name of network
subnetId stringsubnet id of network
networkName stringName of the network
networkAddressDetails object
Azure nic info for restore
networkId stringAzure network ID. Format: /subscriptions/{Subscription ID}/resourceGroups/{Resource Group Name}/providers/Microsoft.Network/virtualNetworks/{Network Name}.
subnetId stringAzure subnet ID. Format: /subscriptions/{Subscription ID}/resourceGroups/{Resource Group Name}/providers/Microsoft.Network/virtualNetworks/{Network Name}/subnets/{Subnet Name}.
privateIpAddress ipv4Azure private IP address.
publicIpAddress ipv4Azure publice IP address.
publicIpAddressId stringAzure public IP address ID. Format: /subscriptions/{Subscription ID}/resourceGroups/{Resource Group Name}/providers/Microsoft.Network/publicIPAddresses/{Public IP Address Name}.
privateIPaddress stringPrivate IP address of the network
publicIPAddress stringPublic IP address of the network
publicIPaddressID stringAzure public IP address ID. Format: /subscriptions/{Subscription ID}/resourceGroups/{Resource Group Name}/providers/Microsoft.Network/publicIPAddresses/{Public IP Address Name}.
virtualNetwork object
Network interface for the destination instances
networkId stringNetwork unique identifier
networkDisplayName stringDisplay Name of network
subnetId stringsubnet id of network
networkName stringName of the network
networkAddressDetails object
Azure nic info for restore
networkId stringAzure network ID. Format: /subscriptions/{Subscription ID}/resourceGroups/{Resource Group Name}/providers/Microsoft.Network/virtualNetworks/{Network Name}.
subnetId stringAzure subnet ID. Format: /subscriptions/{Subscription ID}/resourceGroups/{Resource Group Name}/providers/Microsoft.Network/virtualNetworks/{Network Name}/subnets/{Subnet Name}.
privateIpAddress ipv4Azure private IP address.
publicIpAddress ipv4Azure publice IP address.
publicIpAddressId stringAzure public IP address ID. Format: /subscriptions/{Subscription ID}/resourceGroups/{Resource Group Name}/providers/Microsoft.Network/publicIPAddresses/{Public IP Address Name}.
privateIPaddress stringPrivate IP address of the network
publicIPAddress stringPublic IP address of the network
publicIPaddressID stringAzure public IP address ID. Format: /subscriptions/{Subscription ID}/resourceGroups/{Resource Group Name}/providers/Microsoft.Network/publicIPAddresses/{Public IP Address Name}.
diskType stringType of the disk
sourceVMGuid stringGUID of the source VM
region stringregion of the VM
testFailoverVmSize stringVm size to be used during the test failover operation
dbConfig object
server object
id int32name stringinstance object
id int32name stringdatabases object[]
id int64ID of the source database
sourceName stringName of the source database
destinationName stringName of the destination database
fileMappings object[]
source object
logicalName stringLogical name of the file
physicalPath stringPhysical path of the file
destination object
logicalName stringLogical name of the file
physicalPath stringPhysical path of the file
imageDetails object
vmCreds object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
vmTemplate object
GUID stringname stringskipOSDisk booleanDefault value:
false
Determine if OS disk should be attached to new VM during the disk attach restore
mediaAgent object
id int32name stringcopyPrecedence int32Copy precedence for the copy used for the restore
hardwareConfiguration object
dataDiskConfiguration object[]
name stringName of the disk
provisioningType stringPossible values: [
THIN
,THICK
]Disk provisioning type
diskSize int64Disk size in bytes
diskType stringPossible values: [
ISCSI
,IDE
]Type of disk controller
volumeConfiguration object[]
name stringName of the volume
totalSize int64Size for volume in bytes
enabled booleanDetermine if volume is enabled or not
disks object[]
name stringName of the disk
provisioningType stringPossible values: [
THIN
,THICK
]Disk provisioning type
diskSize int64Disk size in bytes
diskType stringPossible values: [
ISCSI
,IDE
]Type of disk controller
systemDiskConfiguration object
name stringName of the disk
provisioningType stringPossible values: [
THIN
,THICK
]Disk provisioning type
diskSize int64Disk size in bytes
diskType stringPossible values: [
ISCSI
,IDE
]Type of disk controller
credentials object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
instance object
id int32name stringpreRecoveryActions object[]
path stringThe path of the script to be executed. Can be local path on VM or UNC path accessible by access node
type stringPossible values: [
UNC
,LOCAL
]The type of path being used for DR operation script
scriptCredentials object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
guestCredentials object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
guid stringUnique script identifier string
scriptContent stringContent of the script to be executed
scriptName stringName of the script
reset booleanOn set to true, resets the script to empty
osType stringPossible values: [
WINDOWS
,UNIX
]OS types
postRecoveryActions object[]
path stringThe path of the script to be executed. Can be local path on VM or UNC path accessible by access node
type stringPossible values: [
UNC
,LOCAL
]The type of path being used for DR operation script
scriptCredentials object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
guestCredentials object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
guid stringUnique script identifier string
scriptContent stringContent of the script to be executed
scriptName stringName of the script
reset booleanOn set to true, resets the script to empty
osType stringPossible values: [
WINDOWS
,UNIX
]OS types
target object
id int32name stringrecoveryPointDetails object
Contains the information regarding the recovery entity level recoveryPoint selection
entityRecoveryPoint int32Timestamp for entity restore in case of disaster, default value is 0 as latest recovery point
entityRecoveryPointCategory stringPossible values: [
LATEST
,POINT_IN_TIME
,AUTOMATIC
]Default value:
LATEST
Type of recovery point category
inheritedFrom stringPossible values: [
RECOVERY_GROUP
,RECOVERY_ENTITY
]Default value:
RECOVERY_GROUP
Describes from where the recovery point is inherited from. If not provided, recovery point will be used as if it is set at recovery group level
timeZoneId int32TimeZone Id of the CS
recoveryPoint int32Timestamp for entity restore in case of disaster, default value is 0 as latest recovery point
executionOrder object
priority int32Decides the priority of group execution
order int32Decides the priority of entites within a group
group int32Group ID to group similar entities together
connectionDetails object
guestCreds object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
csCreds object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
topologyDetails object
serverGroups object[]
id int32name stringnetworkGateway object[]
hostname stringGateway machine hostname
port int32Possible values:
>= 1
and<= 65535
vmHostName stringVM host name
vmClientName stringVM client name
domainCreds object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
blockSysrepForRecovery booleanrecoveryStatus stringPossible values: [
NO_STATUS
,NOT_READY
,READY
,RECOVERED
,FAILED
,RECOVERED_WITH_ERRORS
,IN_PROGRESS
,CLEANED_UP
,MARK_AS_FAILED
,CLEANUP_FAILED
]Status of recovery entity
validationStatus stringPossible values: [
NO_STATUS
,IN_PROGRESS
,SUCCESS
,FAILED
]Validation status of recovery entity
validationResults object[]
output stringOutput of the script executed
name stringName of the script executed
validationStatus stringPossible values: [
NO_STATUS
,IN_PROGRESS
,SUCCESS
,FAILED
]Validation status of recovery entity
failureReason stringScript validation failure reason
recoveryFailureReason stringReason for last recovery job failure
validationFailureReason stringReason for last validation failure
recoveryStatusNotReadyReason stringRecovery status not ready reason
recoveryStatusNotReadyCategory stringPossible values: [
NONE = 0
,INVALID_VM_NAME = 1
,INVALID_COPY = 2
,MARK_AS_FAILED = 4
,INVALID_SMART_FOLDER = 8
,MANAGED_IDENTITY_ENABLED = 16
]Recovery status not ready category
lastRecoveryJobId int32Last recovery job Id of the entity
osType stringPossible values: [
WINDOWS
,UNIX
]OS types
copyAvailableTime int32Timestamp of the latest backup job start time present in the copy that would be used for recovery. Value would be -1 if no valid copy is present for recovery.
installedWorkloads string[]Possible values: [
GENERIC
,O365
,SALESFORCE
,EXCHANGE
,SHAREPOINT
,ONEDRIVE
,TEAMS
,DYNAMICS_365
,VSA
,FILESYSTEM
,KUBERNETES
,AZURE_AD
,CLOUD_LAPTOP
,FILE_STORAGE_OPTIMIZATION
,DATA_GOVERNANCE
,E_DISCOVERY
,SQL_SERVER
,ORACLEDB
,DB2
,ACTIVE_DIRECTORY
,DATABASE
]sourceVendor stringPossible values: [
NONE
,VMW
,MICROSOFT
,XEN_SERVER
,AMAZON
,AZURE
,REDHAT
,AZURE_V2
,SCVMM
,NUTANIX
,ORACLE_VM
,DOCKER
,OPENSTACK
,ORACLE_CLOUD
,FUSIONCOMPUTE
,VCLOUD
,GOOGLE_CLOUD
,AZURE_STACK
,ALIBABA_CLOUD
,ORACLE_CLOUD_INFRASTRUCTURE
,KUBERNETES
,REDHAT_OPENSHIFT
,MONGODB_ATLAS
,PROXMOX
,KUBERNETES_AKS
,AZURE_STACK_HCI
]
{
"recoveryGroup": {
"id": 0,
"name": "string",
"target": {
"id": 0,
"name": "string"
},
"postRecoveryActions": [
{
"path": "string",
"type": "UNC",
"scriptCredentials": {
"savedCredentials": {
"id": 0,
"name": "string"
},
"credentials": {
"name": "string",
"password": "string"
}
},
"guestCredentials": {
"savedCredentials": {
"id": 0,
"name": "string"
},
"credentials": {
"name": "string",
"password": "string"
}
},
"guid": "string",
"scriptContent": "string",
"scriptName": "string",
"reset": true,
"osType": "WINDOWS"
}
],
"delayBetweenPriorityMachines": 0,
"continueOnFailure": false,
"recoveryPointDetails": {
"recoveryPoint": 0,
"recoveryPointCategory": "LATEST"
},
"recoveryPoint": 0,
"recoveryExpirationOptions": {
"enableExpirationOption": true,
"daysToExpire": 7,
"isRescuedCommServe": true,
"expirationTime": 0
}
},
"entities": [
{
"id": 0,
"name": "string",
"entity": {
"id": 0,
"name": "string"
},
"recoveryGroup": {
"id": 0,
"name": "string"
},
"workload": "GENERIC",
"client": {
"id": 0,
"name": "string"
},
"backupSet": {
"id": 0,
"name": "string"
},
"vmGroup": {
"id": 0,
"name": "string"
},
"virtualMachine": {
"GUID": "string",
"name": "string"
},
"recoveryConfiguration": {
"advancedOptions": {
"azure": {
"unconditionalOverwrite": false,
"deployVmOnlyDuringfailover": true
}
},
"configuration": {
"azure": {
"sourceVM": "string",
"destinationVM": "string",
"resourceGroup": "string",
"storageAccount": "string",
"vmSize": "string",
"createPublicIP": true,
"restoreAsManagedVm": true,
"overrideReplicationOptions": {
"availabilityZone": "string",
"securityGroup": {
"id": "string",
"name": "string"
},
"testFailoverVirtualNetwork": {
"networkId": "string",
"networkDisplayName": "string",
"subnetId": "string",
"networkName": "string",
"networkAddressDetails": {
"networkId": "string",
"subnetId": "string",
"privateIpAddress": "198.51.100.42",
"publicIpAddress": "198.51.100.42",
"publicIpAddressId": "string"
},
"privateIPaddress": "string",
"publicIPAddress": "string",
"publicIPaddressID": "string"
},
"virtualNetwork": {
"networkId": "string",
"networkDisplayName": "string",
"subnetId": "string",
"networkName": "string",
"networkAddressDetails": {
"networkId": "string",
"subnetId": "string",
"privateIpAddress": "198.51.100.42",
"publicIpAddress": "198.51.100.42",
"publicIpAddressId": "string"
},
"privateIPaddress": "string",
"publicIPAddress": "string",
"publicIPaddressID": "string"
}
},
"diskType": "string",
"sourceVMGuid": "string",
"region": "string",
"testFailoverVmSize": "string"
}
},
"dbConfig": {
"server": {
"id": 0,
"name": "string"
},
"instance": {
"id": 0,
"name": "string"
},
"databases": [
{
"id": 0,
"sourceName": "string",
"destinationName": "string",
"fileMappings": [
{
"source": {
"logicalName": "string",
"physicalPath": "string"
},
"destination": {
"logicalName": "string",
"physicalPath": "string"
}
}
]
}
]
},
"imageDetails": {
"vmCreds": {
"savedCredentials": {
"id": 0,
"name": "string"
},
"credentials": {
"name": "string",
"password": "string"
}
},
"vmTemplate": {
"GUID": "string",
"name": "string"
},
"skipOSDisk": false
},
"mediaAgent": {
"id": 0,
"name": "string"
},
"copyPrecedence": 0,
"hardwareConfiguration": {
"dataDiskConfiguration": [
{
"name": "string",
"provisioningType": "THIN",
"diskSize": 0,
"diskType": "ISCSI"
}
],
"volumeConfiguration": [
{
"name": "string",
"totalSize": 0,
"enabled": true,
"disks": [
{
"name": "string",
"provisioningType": "THIN",
"diskSize": 0,
"diskType": "ISCSI"
}
]
}
],
"systemDiskConfiguration": {
"name": "string",
"provisioningType": "THIN",
"diskSize": 0,
"diskType": "ISCSI"
}
},
"credentials": {
"savedCredentials": {
"id": 0,
"name": "string"
},
"credentials": {
"name": "string",
"password": "string"
}
}
},
"instance": {
"id": 0,
"name": "string"
},
"preRecoveryActions": [
{
"path": "string",
"type": "UNC",
"scriptCredentials": {
"savedCredentials": {
"id": 0,
"name": "string"
},
"credentials": {
"name": "string",
"password": "string"
}
},
"guestCredentials": {
"savedCredentials": {
"id": 0,
"name": "string"
},
"credentials": {
"name": "string",
"password": "string"
}
},
"guid": "string",
"scriptContent": "string",
"scriptName": "string",
"reset": true,
"osType": "WINDOWS"
}
],
"postRecoveryActions": [
{
"path": "string",
"type": "UNC",
"scriptCredentials": {
"savedCredentials": {
"id": 0,
"name": "string"
},
"credentials": {
"name": "string",
"password": "string"
}
},
"guestCredentials": {
"savedCredentials": {
"id": 0,
"name": "string"
},
"credentials": {
"name": "string",
"password": "string"
}
},
"guid": "string",
"scriptContent": "string",
"scriptName": "string",
"reset": true,
"osType": "WINDOWS"
}
],
"target": {
"id": 0,
"name": "string"
},
"recoveryPointDetails": {
"entityRecoveryPoint": 0,
"entityRecoveryPointCategory": "LATEST",
"inheritedFrom": "RECOVERY_GROUP",
"timeZoneId": 0
},
"recoveryPoint": 0,
"executionOrder": {
"priority": 0,
"order": 0,
"group": 0
},
"connectionDetails": {
"guestCreds": {
"savedCredentials": {
"id": 0,
"name": "string"
},
"credentials": {
"name": "string",
"password": "string"
}
},
"csCreds": {
"savedCredentials": {
"id": 0,
"name": "string"
},
"credentials": {
"name": "string",
"password": "string"
}
},
"topologyDetails": {
"serverGroups": [
{
"id": 0,
"name": "string"
}
],
"networkGateway": [
{
"hostname": "string",
"port": 0
}
]
},
"vmHostName": "string",
"vmClientName": "string",
"domainCreds": {
"savedCredentials": {
"id": 0,
"name": "string"
},
"credentials": {
"name": "string",
"password": "string"
}
}
},
"blockSysrepForRecovery": true,
"recoveryStatus": "NO_STATUS",
"validationStatus": "NO_STATUS",
"validationResults": [
{
"output": "string",
"name": "string",
"validationStatus": "NO_STATUS",
"failureReason": "string"
}
],
"recoveryFailureReason": "string",
"validationFailureReason": "string",
"recoveryStatusNotReadyReason": "string",
"recoveryStatusNotReadyCategory": "NONE = 0",
"lastRecoveryJobId": 0,
"osType": "WINDOWS",
"copyAvailableTime": 0,
"installedWorkloads": [
"GENERIC"
],
"sourceVendor": "NONE"
}
]
}
Recovery group could not be found
- application/json
- Schema
- Example (from schema)
Schema
- errorMessage string
- errorCode int32
{
"errorMessage": "string",
"errorCode": 0
}