Update Vm Protection Settings

Update Vm Protection Settings

Update the protection settings of a virtual machine. This endpoint must be called after the remove protection operation in order for the VM to be recovered during recovery.

Request
URI
PUT
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


Request Body

A spec describing the new VM protection settings.

VmProtectionSettings of type(s) application/json
Required
{
    "placeholder_needs_repair": false,
    "location": {
        "name": "string",
        "protected_site": "string",
        "production_vm_path": {
            "datastore": "string",
            "datastore_name": "local",
            "path": "vms/finance-vm",
            "filename": "finance-vm.vmdk",
            "friendly_path": "string"
        },
        "recovery_site": "string",
        "placeholder_vm_path": {
            "datastore": "string",
            "datastore_name": "local",
            "path": "vms/finance-vm",
            "filename": "finance-vm.vmdk",
            "friendly_path": "string"
        },
        "placeholder_vm": "string"
    },
    "devices": [
        {
            "key": 0,
            "type": "string",
            "backing": "string",
            "label": "string",
            "production_path": {
                "datastore": "string",
                "datastore_name": "local",
                "path": "vms/finance-vm",
                "filename": "finance-vm.vmdk",
                "friendly_path": "string"
            },
            "production_datastores": [
                "string"
            ],
            "recovery_path": {
                "datastore": "string",
                "datastore_name": "local",
                "path": "vms/finance-vm",
                "filename": "finance-vm.vmdk",
                "friendly_path": "string"
            },
            "replicated": false,
            "detached": false
        }
    ],
    "networks": [
        {
            "editable": false,
            "source": "string",
            "source_name": "string",
            "target": "string",
            "target_name": "string",
            "is_inventory_mapped_target": false,
            "source_has_inventory_mapping": false,
            "index": 0,
            "key": 0,
            "source_network_nsx_backed": false,
            "target_network_nsx_backed": false
        }
    ],
    "folder": {
        "editable": false,
        "source": "string",
        "source_name": "string",
        "target": "string",
        "target_name": "string",
        "is_inventory_mapped_target": false,
        "source_has_inventory_mapping": false
    },
    "resource_pool": {
        "editable": false,
        "source": "string",
        "source_name": "string",
        "target": "string",
        "target_name": "string",
        "is_inventory_mapped_target": false,
        "source_has_inventory_mapping": false
    },
    "host": {
        "editable": false,
        "source": "string",
        "source_name": "string",
        "target": "string",
        "target_name": "string",
        "is_inventory_mapped_target": false,
        "source_has_inventory_mapping": false
    },
    "change_version": "string"
}
boolean
placeholder_needs_repair
Optional

Whether repair placeholder operation is required. If true, only repair placeholder is possible and not configure protection.

location
Optional

location

devices
Optional

List of VM devices, including hard disks, optical disks and floppy disks

networks
Optional

List of VM networks

folder
Optional

folder

resource_pool
Optional

resource_pool

host
Optional

host

string
change_version
Optional

Version number of these settings. Keep this if need to update the VM protection settings. Applicable only if the VM is protected.

Authentication
This operation uses the following authentication methods.
Responses
202

A task to monitor the operation progress

Returns TaskDrResponseEntity of type(s) application/json
This response body class contains all of the following: Task
{
    "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"
            }
        ]
    }
}
_meta
Optional

_meta


400

Bad request - the server could not understand the request due to invalid syntax or invalid request body content

Returns ResponseError of type(s) application/json
{
    "error_code": "string",
    "message": "string",
    "op_id": "string"
}
string
error_code
Optional

error_code

string
message
Optional

message

string As uuid As uuid
op_id
Optional

op_id


401

Unauthorized - the client must authenticate itself to get the requested response

Operation doesn't return any data structure

403

Forbidden - not sufficient access rights to fulfill the request

Returns ResponseError of type(s) application/json
{
    "error_code": "string",
    "message": "string",
    "op_id": "string"
}
string
error_code
Optional

error_code

string
message
Optional

message

string As uuid As uuid
op_id
Optional

op_id


404

Not Found - server cannot find the requested in URL resource

Operation doesn't return any data structure

500

Internal server error - unexpected condition prevents fulfilling the request

Returns ResponseError of type(s) application/json
{
    "error_code": "string",
    "message": "string",
    "op_id": "string"
}
string
error_code
Optional

error_code

string
message
Optional

message

string As uuid As uuid
op_id
Optional

op_id