[{"label":"Latest (2.0.0)","version":"latest"},{"version":"1.0.0"}]

srm-rest-api

Get VM Protection Settings

Description

Get details about the current protection settings of a virtual machine.

Request

URL

get

https://{api_host}//pairings/{pairing_id}/protection-management/groups/{group_id}/vms/{vm_id}/protection-settings

Copy

Path Parameters

string

pairing_id Required

The ID of a pairing between this Site Recovery Manager server and remote one.

string

group_id Required

The ID of a protection group defined within current pairing.

string

vm_id Required

The ID of a protected virtual machine.

Authentication

This operation uses the following authentication methods.

SessionHeader

Response

Response Body

200 OK

Returns VmProtectionSettingsDrResponseEntity of type application/json

Detailed VM protection settings

{
	"_meta": {
		"errors": [
			{
				"code": "string",
				"field": "string",
				"message": "string"
			}
		]
	},
	"change_version": "string",
	"devices": [
		{
			"backing": "FILE",
			"detached": false,
			"key": 0,
			"label": "string",
			"production_datastores": [
				"string"
			],
			"production_path": {
				"datastore": "string",
				"datastore_name": "local",
				"filename": "finance-vm.vmdk",
				"friendly_path": "string",
				"path": "vms/finance-vm"
			},
			"recovery_path": {
				"datastore": "string",
				"datastore_name": "local",
				"filename": "finance-vm.vmdk",
				"friendly_path": "string",
				"path": "vms/finance-vm"
			},
			"replicated": false,
			"type": "HARD_DRIVE"
		}
	],
	"folder": {
		"editable": false,
		"is_inventory_mapped_target": false,
		"source": "string",
		"source_has_inventory_mapping": false,
		"source_name": "string",
		"target": "string",
		"target_name": "string"
	},
	"host": {
		"editable": false,
		"is_inventory_mapped_target": false,
		"source": "string",
		"source_has_inventory_mapping": false,
		"source_name": "string",
		"target": "string",
		"target_name": "string"
	},
	"location": {
		"name": "string",
		"placeholder_vm": "string",
		"placeholder_vm_path": {
			"datastore": "string",
			"datastore_name": "local",
			"filename": "finance-vm.vmdk",
			"friendly_path": "string",
			"path": "vms/finance-vm"
		},
		"production_vm_path": {
			"datastore": "string",
			"datastore_name": "local",
			"filename": "finance-vm.vmdk",
			"friendly_path": "string",
			"path": "vms/finance-vm"
		},
		"protected_site": "string",
		"recovery_site": "string"
	},
	"networks": [
		{
			"editable": false,
			"index": 0,
			"is_inventory_mapped_target": false,
			"key": 0,
			"source": "string",
			"source_has_inventory_mapping": false,
			"source_name": "string",
			"source_network_nsx_backed": false,
			"target": "string",
			"target_name": "string",
			"target_network_nsx_backed": false
		}
	],
	"placeholder_needs_repair": false,
	"resource_pool": {
		"editable": false,
		"is_inventory_mapped_target": false,
		"source": "string",
		"source_has_inventory_mapping": false,
		"source_name": "string",
		"target": "string",
		"target_name": "string"
	}
}

Metadata

_meta Optional

Response meta data. Contains data about the response payload data.

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-SrmGetVmProtectionSettings -pairingId "MypairingId" -groupId "MygroupId" -vmId "MyvmId"

cURL Command

curl https://{api_host}/pairings/{pairing_id}/protection-management/groups/{group_id}/vms/{vm_id}/protection-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: ERROR
    server-down: ERROR

[{"label":"Latest (2.0.0)","version":"latest"},{"version":"1.0.0"}]

srm-rest-api

Protection Operations

post

Add Datastore Group

post

Configure All

post

Create Group

post

Create Protection Group Folder Introduced

delete

Delete Group

delete

Delete Protection Group Folder Introduced

get

Get All Groups

get

Get Datastore Group

get

Get Datastore Groups

get

Get Group

get

Get Group Issues

get

Get Group Related Recovery Plans

get

Get Group VM

get

Get Group VMS

get

Get Protection Group Folder Introduced

get

Get Protection Group Folder Children Introduced

get

Get Protection Group Folders Introduced

get

Get VM Protection Settings

get

Get vVol Replication Group

get

Get vVol Replication Groups

post

Move Protection Group Folder Introduced

post

Reconfigure Group

delete

Remove Datastore Group

post

Remove VM From Protection Group

post

Remove VM Protection

post

Rename Protection Group Folder Introduced

post

Restore All Placeholders

put

Update VM Protection Settings

Get VM Protection Settings

Request

URL

Path Parameters

Authentication

SessionHeader

Response

Response Body

200 OK

Errors

Code Samples

PowerCLI Client SDK Example

cURL Command

Vendor Extensions

On This Page

Protection Operations

Was this page helpful?