Replication Update Recovery Settings

Replication Update Recovery Settings

This request updates the failover/migration and test recovery settings.

The result of this API call is a task which must be polled by using the respective APIs for task polling. If the task succeeds, then the result can be obtained from the result field. If the task fails, there is no result. The failure reason is in the error field.

Request
URI
PUT
https://{api_host}/replications/{replicationId}/recovery-settings
COPY
Path Parameters
string
replicationId
Required

VM replication identifier

replicationId example 
H4-ec991bd5-af9d-446a-8599-5b693842c4a3
Query Parameters
string
site
Optional

Optional site to run the operation on. When omitted, defaults to the local site.

site example 
site1
Header Parameters
string
operationID
Optional

Operation ID for correlating logs across multiple services

Request Body

The new recovery settings.

RecoverySettings of type(s) application/json
Required 
{
    "failoverPlacement": {
        "vmFolder": "group-v4",
        "vmFolderName": "VM folder",
        "resourcePool": "resgroup-4",
        "resourcePoolName": "My Resource Pool",
        "host": "host-4",
        "hostName": "somehostname",
        "networkMappings": {
            "defaultNetwork": "network-14",
            "defaultNetworkName": "VM Network",
            "mappings": [
                {
                    "key": 4000,
                    "networkId": "network-14",
                    "networkName": "VM Network"
                }
            ]
        }
    },
    "testPlacement": {
        "vmFolder": "group-v4",
        "vmFolderName": "VM folder",
        "resourcePool": "resgroup-4",
        "resourcePoolName": "My Resource Pool",
        "host": "host-4",
        "hostName": "somehostname",
        "networkMappings": {
            "defaultNetwork": "network-14",
            "defaultNetworkName": "VM Network",
            "mappings": [
                {
                    "key": 4000,
                    "networkId": "network-14",
                    "networkName": "VM Network"
                }
            ]
        }
    }
}
FailoverPlacement
failoverPlacement
Optional

failoverPlacement

FailoverTestPlacement
testPlacement
Optional

testPlacement

Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns H4ApiTask_of_RecoverySettings of type(s) application/vnd.vmware.h4-v4.7+json;charset=UTF-8 
{
    "endTime": 1499929558827,
    "error": {
        "args": [],
        "code": "Forbidden",
        "msg": "Permission denied.",
        "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
    },
    "id": "f61d60d2-698a-46dc-a266-88df27644956",
    "lastUpdated": 1499929558827,
    "progress": 100,
    "result": {
        "failoverPlacement": {
            "vmFolder": "group-v4",
            "vmFolderName": "VM folder",
            "resourcePool": "resgroup-4",
            "resourcePoolName": "My Resource Pool",
            "host": "host-4",
            "hostName": "somehostname",
            "networkMappings": {
                "defaultNetwork": "network-14",
                "defaultNetworkName": "VM Network",
                "mappings": [
                    {
                        "key": 4000,
                        "networkId": "network-14",
                        "networkName": "VM Network"
                    }
                ]
            }
        },
        "testPlacement": {
            "vmFolder": "group-v4",
            "vmFolderName": "VM folder",
            "resourcePool": "resgroup-4",
            "resourcePoolName": "My Resource Pool",
            "host": "host-4",
            "hostName": "somehostname",
            "networkMappings": {
                "defaultNetwork": "network-14",
                "defaultNetworkName": "VM Network",
                "mappings": [
                    {
                        "key": 4000,
                        "networkId": "network-14",
                        "networkName": "VM Network"
                    }
                ]
            }
        }
    },
    "resultType": "string",
    "site": "site2",
    "startTime": 1499929548951,
    "state": "string",
    "user": "root",
    "warnings": [],
    "workflowInfo": {}
}
integer As int64 As int64
endTime
Optional

Timestamp in msec of the completion time of the task. -1 indicates that the task did not complete yet.

ApiError
error
Optional

error

string As uuid As uuid
id
Optional

The unique identifier of the long-running task. It is unique and can be used for monitoring.

integer As int64 As int64
lastUpdated
Optional

Timestamp in msec of the last task status update.

integer As int32 As int32
progress
Optional

Percentage-based progress of the task.

RecoverySettings
result
Optional

result

string
resultType
Optional

Indicates the type of the task result. Populates only when the execution succeeds.

string
site
Optional

Site on which the task runs.

integer As int64 As int64
startTime
Optional

Timestamp in msec of the creation time of the task.

Task_State
state
Optional

state

string
user
Optional

The user who started the task.

array of ResultWarning
warnings
Optional

Warnings, which occurred during the task execution.

ApiWorkflowInfo
workflowInfo
Optional

workflowInfo


401

The returned error codes include (but are not limited to): NotAuthenticated

Returns ApiError of type(s) application/vnd.vmware.h4-v4.7+json;charset=UTF-8 
{
    "args": [],
    "code": "Forbidden",
    "msg": "Permission denied.",
    "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}
array of string
args
Optional

Positional arguments.

string
code
Optional

Specific error code.

string
msg
Optional

Detailed error message.

string
stacktrace
Optional

Exception stacktrace.


500

The returned error codes include (but are not limited to): GeneralServerFailure

Returns ApiError of type(s) application/vnd.vmware.h4-v4.7+json;charset=UTF-8 
{
    "args": [],
    "code": "Forbidden",
    "msg": "Permission denied.",
    "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}
array of string
args
Optional

Positional arguments.

string
code
Optional

Specific error code.

string
msg
Optional

Detailed error message.

string
stacktrace
Optional

Exception stacktrace.


On This Page
Replications Operations
DELETE
Replication Clean Failover Test
POST
Replication Failover
POST
Replication Failover Test
GET
Replication Get
GET
Replication Get Placement
GET
Replication Get Recovery Settings
GET
Replication Get Replicated Disks
GET
Replication Instance By Id
GET
Replication Instances
POST
Replication Migrate
POST
Replication Pause
GET
Replication Query Replications
PATCH
Replication Reconfigure
PATCH
Replication Reconfigure Disks
POST
Replication Resume
POST
Replication Reverse
POST
Replication Start
DELETE
Replication Stop
POST
Replication Stop Offline Sync
POST
Replication Sync
PUT
Replication Update Recovery Settings
GET
Replication Virtual Hardware