VmRecoverySettings

VmRecoverySettings
VmRecoverySettings

Recovery settings for a VM, defined in the context of a recovery plan

JSON Example
{
    "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"
        }
    ],
    "change_version": 0,
    "vm_tools_status": "string",
    "allow_vmotion_migration": false
}
string
ip_customization_type
Required

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.

Possible values are : AUTO, NETWORK_MAPPING_LEVEL, MANUAL, NO_CUSTOMIZATION,
nic_settings
Optional

Contains the IP settings for all the virtual ethernet cards on the VM

string
priority
Required

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.

Possible values are : P1, P2, P3, P4, P5,
string
startup_action
Required

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

Possible values are : POWER_ON, DO_NOT_POWER_ON,
shutdown_action_settings
Required

shutdown_action_settings

array of Callout
pre_power_on_steps
Optional

Contains all per VM steps that should be executed before the VM is powered on

array of Callout
post_power_on_steps
Optional

Contains all per VM steps that should be executed after the VM is powered on

startup_action_settings
Optional

startup_action_settings

dependent_vms
Optional

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.

integer As int64 As int64
change_version
Optional

Change version control. When reconfiguring an existing Protected workload this value must be set, and match the most recent value. For settings on newly added VMs, leave it unset.

string
vm_tools_status
Optional

Status of VM tools on the VM

Possible values are : INSTALLING, UPGRADING, INSTALLED, NOT_INSTALLED,
boolean
allow_vmotion_migration
Optional

Whether this VM to be migrated to the recovery site using vMotion during a planned failover workflow