Restore All Placeholders

Repair placeholder VMs.

Called when the placeholder needs to be recreated due to one of these reasons:

Placeholder creation failed.
Placeholder was deleted.
Placeholder inventory was lost or needs to be reentered - one use case for this is when production VM was a template but then gets converted to a VM.

This method can be called only on the recovery site. It does not require the primary site to be up for successful completion.

Empty list of tasks is returned when no virtual machines need repair of their placeholder VMs.

Request

URI

POST

https://{api_host}/pairings/{pairing_id}/protection-management/groups/{group_id}/actions/restore-all-placeholders

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.

Authentication

This operation uses the following authentication methods.

SessionHeader

Responses

202

Response containing tasks to monitor the operation progress of different VMs.

Returns RecreateAllPlaceholderVmsResponseDrResponseEntity of type(s) application/json

This response body class contains all of the following: InlineRecreateAllPlaceholderVmsResponseDrResponseEntity1

{
    "errors": [
        {}
    ],
    "tasks": [
        {
            "id": "string",
            "description": "string",
            "description_id": "string",
            "entity": "string",
            "entity_name": "string",
            "status": "string",
            "error": {
                "message": "string",
                "details": "string"
            },
            "result": {},
            "progress": 0,
            "queued_time": 0,
            "start_time": 0,
            "complete_time": 0
        }
    ],
    "_meta": {
        "errors": [
            {
                "code": "string",
                "message": "string",
                "field": "string"
            }
        ]
    }
}

400

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

Returns ResponseError of type(s) application/json

"ResponseError Object"

string

error_code

Optional

The code of the error.

string

message

Optional

The message of the error.

string As uuid As uuid

op_id

Optional

The ID of the operation.

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

"ResponseError Object"

string

error_code

Optional

The code of the error.

string

message

Optional

The message of the error.

string As uuid As uuid

op_id

Optional

The ID of the operation.

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

"ResponseError Object"

string

error_code

Optional

The code of the error.

string

message

Optional

The message of the error.

string As uuid As uuid

op_id

Optional

The ID of the operation.

Code Samples

COPY

                    curl -X POST -H 'Authorization: <value>' https://{api_host}/pairings/{pairing_id}/protection-management/groups/{group_id}/actions/restore-all-placeholders

On This Page

Description

Request

Path Parameters

Authentication

Response

202 Response Body

Errors

Protection Operations

GET

Get All Groups

POST