[{"label":"Latest (2.0.0)","version":"latest"},{"version":"1.0.0"}]
srm-rest-api
Get Plan Virtual Machine Recovery Settings
DescriptionGet recovery settings for a protected virtual machine.
Request
URLURL
https://{api_host}//pairings/{pairing_id}/recovery-management/plans/{plan_id}/vms/{vm_id}/recovery-settings
Path Parameters
Path Parameters
string
pairing_id
Required
The ID of a pairing between this Site Recovery Manager server and remote one.
string
plan_id
Required
The ID of a recovery plan defined within current pairing.
string
vm_id
Required
The ID of a virtual machine.
Authentication
This operation uses the following authentication methods.
Response
Response
Response BodyResponse Body
200 OK
Returns
VmRecoverySettingsStateDrResponseEntity
of type application/json
Details about recovery settings of a protected virtual machine.
{
"_meta": {
"errors": [
{
"code": "string",
"field": "string",
"message": "string"
}
]
},
"protection_group_support_vmotion": false,
"recovery_settings": {
"allow_vmotion_migration": false,
"change_version": 0,
"dependent_vms": [
{
"id": "string",
"inside_vapp": false,
"name": "string",
"priority_group": "P1",
"protection_group_name": "string",
"status": "OK",
"template": false
}
],
"ip_customization_type": "AUTO",
"nic_settings": [
{
"device_id": 0,
"primary_ip_settings": {
"dns": {
"alternate_server": "string",
"preferred_server": "string",
"suffixes": [
"string"
],
"type": "DHCP"
},
"ip_v4": {
"alternate_gateway": "string",
"default_gateway": "string",
"ip_address": "string",
"subnet_mask": "255.255.255.0",
"type": "DHCP"
},
"ip_v6": {
"alternate_gateway": "string",
"default_gateway": "string",
"ip_address": "fdda:5cc1:23:4::1f",
"subnet_prefix_length": 0,
"type": "DHCP"
},
"wins": {
"alternate_server": "string",
"primary_server": "string"
}
},
"secondary_ip_settings": {
"dns": {
"alternate_server": "string",
"preferred_server": "string",
"suffixes": [
"string"
],
"type": "DHCP"
},
"ip_v4": {
"alternate_gateway": "string",
"default_gateway": "string",
"ip_address": "string",
"subnet_mask": "255.255.255.0",
"type": "DHCP"
},
"ip_v6": {
"alternate_gateway": "string",
"default_gateway": "string",
"ip_address": "fdda:5cc1:23:4::1f",
"subnet_prefix_length": 0,
"type": "DHCP"
},
"wins": {
"alternate_server": "string",
"primary_server": "string"
}
}
}
],
"post_power_on_steps": [
{
"callout_type": "PROMPT",
"content": "string",
"id": "string",
"name": "string",
"step_type": "PRE_POWER_ON",
"timeout_seconds": 0
}
],
"pre_power_on_steps": [
{
"callout_type": "PROMPT",
"content": "string",
"id": "string",
"name": "string",
"step_type": "PRE_POWER_ON",
"timeout_seconds": 0
}
],
"priority": "P1",
"shutdown_action_settings": {
"skip_shutdown_guest": false,
"timeout_seconds": 0
},
"startup_action": "POWER_ON",
"startup_action_settings": {
"delay_before_power_on_steps_and_dependent_vms_seconds": 0,
"power_on_vmtools_timeout_seconds": 0
},
"vm_tools_status": "INSTALLING"
},
"status": "OK",
"vmotion_migration_supported": false
}
Errors
ResponseError
400
Bad request - the server could not understand the request due to invalid syntax or invalid request body content
401
Unauthorized - the client must authenticate itself to get the requested response
ResponseError
403
Forbidden - not sufficient access rights to fulfill the request
404
Not Found - server cannot find the requested in URL resource
ResponseError
500
Internal server error - unexpected condition prevents fulfilling the request
Code Samples
PowerCLI Client SDK Example
Invoke-SrmGetPlanVirtualMachineRecoverySettings -pairingId "MypairingId" -planId "MyplanId" -vmId "MyvmId"
cURL Command
curl https://{api_host}/pairings/{pairing_id}/recovery-management/plans/{plan_id}/vms/{vm_id}/recovery-settings
Vendor Extensions
This operation contains the following vendor extensions defined in the spec:
x-dr-permissions:
permissions:
- System.View
- System.Read
x-dr-remote-site-connectivity-contract:
not-authenticated: FULL_DATA
server-down: FULL_DATA
[{"label":"Latest (2.0.0)","version":"latest"},{"version":"1.0.0"}]
srm-rest-api
On This Page
Recovery Operations
post
post
post
Create Recovery Plan Folder
Introduced
post
Create Recovery Steps Callout
Introduced
delete
delete
Delete Recovery Plan Folder
Introduced
delete
Delete Recovery Step
Introduced
post
Dismiss Recovery Steps Recovery Plan Prompt
Introduced
post
Edit Recovery Steps Callout
Introduced
get
Get Recovery Plan Folder
Introduced
get
Get Recovery Plan Folder Children
Introduced
get
Get Recovery Plan Folders
Introduced
get
Get Recovery Step
Introduced
get
Get Recovery Steps
Introduced
get
Get Recovery Steps Callout Details
Introduced
get
Get Recovery Steps User Prompt
Introduced
get
Get Recovery Steps User Prompts
Introduced
post
Move Recovery Plan Folder
Introduced
post
Rename Recovery Plan Folder
Introduced
post
post
post
