Update recovery entity in a recovery group
Select
Updating the entity in the recovery group
Path Parameters
- recoveryGroupId integer required
Recovery group Id
- entityId integer required
Recovery entity Id
- application/json
Request Body
- id int32
Id of the recovery entity
- name string
Name of the recovery entity
entity object
id int32name stringrecoveryGroup object
id int32name string- workload 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
] 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 int32
Timestamp 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 boolean
- recoveryStatus string
Possible 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 string
Possible 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 string
Reason for last recovery job failure
- validationFailureReason string
Reason for last validation failure
- recoveryStatusNotReadyReason string
Recovery status not ready reason
- recoveryStatusNotReadyCategory string
Possible 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 int32
Last recovery job Id of the entity
- osType string
Possible values: [
WINDOWS
,UNIX
]OS types
- copyAvailableTime int32
Timestamp 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 string
Possible 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
]
- 200
- 400
OK
- application/json
- Schema
- Example (from schema)
Schema
- errorMessage string
- errorCode int32
{
"errorMessage": "string",
"errorCode": 0
}
Entity cannot be updated
- application/json
- Schema
- Example (from schema)
Schema
- errorMessage string
- errorCode int32
{
"errorMessage": "string",
"errorCode": 0
}