Update Plan Virtual Machine Recovery Settings
Update recovery settings for a protected virtual machine.
The ID of a pairing between this Site Recovery Manager server and remote one
The ID of a recovery plan defined within current pairing
The ID of a virtual machine
Spec describing VM recovery settings
{
"ip_customization_type": "string",
"nic_settings": [
{
"device_id": 0,
"primary_ip_settings": {
"ip_v4": {
"ip_address": "string",
"type": "string",
"default_gateway": "string",
"alternate_gateway": "string",
"subnet_mask": "255.255.255.0"
},
"ip_v6": {
"ip_address": "fdda:5cc1:23:4::1f",
"type": "string",
"default_gateway": "string",
"alternate_gateway": "string",
"subnet_prefix_length": 0
},
"dns": {
"type": "string",
"preferred_server": "string",
"alternate_server": "string",
"suffixes": [
"string"
]
},
"wins": {
"primary_server": "string",
"alternate_server": "string"
}
},
"secondary_ip_settings": {
"ip_v4": {
"ip_address": "string",
"type": "string",
"default_gateway": "string",
"alternate_gateway": "string",
"subnet_mask": "255.255.255.0"
},
"ip_v6": {
"ip_address": "fdda:5cc1:23:4::1f",
"type": "string",
"default_gateway": "string",
"alternate_gateway": "string",
"subnet_prefix_length": 0
},
"dns": {
"type": "string",
"preferred_server": "string",
"alternate_server": "string",
"suffixes": [
"string"
]
},
"wins": {
"primary_server": "string",
"alternate_server": "string"
}
}
}
],
"priority": "string",
"startup_action": "string",
"shutdown_action_settings": {
"skip_shutdown_guest": false,
"timeout_seconds": 0
},
"pre_power_on_steps": [
{
"name": "string",
"content": "string",
"callout_type": "string",
"timeout_seconds": 0,
"step_type": "string",
"id": "string"
}
],
"post_power_on_steps": [
{
"name": "string",
"content": "string",
"callout_type": "string",
"timeout_seconds": 0,
"step_type": "string",
"id": "string"
}
],
"startup_action_settings": {
"power_on_vmtools_timeout_seconds": 0,
"delay_before_power_on_steps_and_dependent_vms_seconds": 0
},
"dependent_vms": [
{
"id": "string",
"name": "string",
"template": false,
"inside_vapp": false,
"status": "string",
"priority_group": "string",
"protection_group_name": "string"
}
]
}IP customization modes:
- Auto (AUTO)
- If the advanced setting 'recovery.useIpMapperAutomatically' is set to True - Site Recovery Manager evaluates the IP subnet mapping rules during recovery to customize the virtual machines.
- If the advanced setting 'recovery.useIpMapperAutomatically' is set to False - Site Recovery Manager does not evaluate the IP subnet mapping rules during recovery.
- Use IP customization rules if applicable (NETWORK_LEVEL)
- Site Recovery Manager will evaluate the IP subnet mapping rules during recovery of the concrete VM regardless of the advanced setting value of recovery.useIpMapperAutomatically.
- Manual IP customization (MANUAL)
- Manually set up explicit recovery IP settings per VM.
- No IP customization (NO_CUSTOMIZATION)
- Do not change VM IP settings during recovery.
Contains the IP settings for all the virtual ethernet cards on the VM
Recovery priority group. Used to translate server priority values to client priorities. The recovery priority for this VM. P1 is the highest and P5 is the lowest priority.
Startup action after recovery:
- DO_NOT_POWER_ON
The VM will not be powered on and post-power-on steps will not be executed as partof the recovery and test workflows. Note that the VM may still get powered onduring recovery as part of the IP customization workflow. - POWER_ON
The VM will be powered on and post-power-on steps will be executed as part of the recovery and test workflows
Contains all per VM steps that should be executed before the VM is powered on
Contains all per VM steps that should be executed after the VM is powered on
This is a list of VM identities that must be powered-on before this VM can be powered on. Dependencies are only valid within VMs of the same recovery priority. If there are dependent VMs that are not in the current plan and same recovery priority, they will be ignored. This list may contain VMs that are not contained by any protection group in the plan. But it will only contain valid VMs.
Task to monitor the operation progress
{
"id": "string",
"description": "string",
"description_id": "string",
"entity": "string",
"entity_name": "string",
"status": "string",
"error": {
"message": "string",
"details": "string"
},
"progress": 0,
"queued_time": "string",
"start_time": "string",
"complete_time": "string",
"_meta": {
"errors": [
{
"code": "string",
"message": "string",
"field": "string"
}
]
}
}Bad request - the server could not understand the request due to invalid syntax or invalid request body content
{
"error_code": "string",
"message": "string",
"op_id": "string"
}error_code
message
op_id
Unauthorized - the client must authenticate itself to get the requested response
Forbidden - not sufficient access rights to fulfill the request
{
"error_code": "string",
"message": "string",
"op_id": "string"
}error_code
message
op_id
Not Found - server cannot find the requested in URL resource
Internal server error - unexpected condition prevents fulfilling the request
{
"error_code": "string",
"message": "string",
"op_id": "string"
}error_code
message
op_id