Failover
Failover all the vApp's child VM replications to the destination site.
Request
URI
POST
https://{api_host}//vapp-replications/{replicationId}/failover
COPY
Path Parameters
string
replicationId
Required
The vApp Replication unique identifier
replicationId example
C4VAPP-d38b426f-dbfa-4ab7-851d-a538c23bd268
Query Parameters
string
site
Optional
site
Header Parameters
string
operationID
Optional
Operation ID for correlating logs across multiple services
Request Body
failoverSettings
VappReplicationFailoverSettings of type(s) application/json
Required
{
"type": "string"
}string
type
Required
type
Possible values are : vcenter, vcloud,
Authentication
This operation uses the following authentication methods.
Responses
202
Accepted
Returns C4ApiTaskOfVappReplicationInfo of type(s) application/vnd.vmware.h4-v3.5+json;charset=UTF-8
{
"endTime": 1499929558827,
"error": {
"args": [
"string"
],
"code": "string",
"msg": "string",
"stacktrace": "string"
},
"id": "f61d60d2-698a-46dc-a266-88df27644956",
"lastUpdated": 1499929558827,
"progress": 100,
"result": {
"descriptor": {
"description": "vapp description in vCD",
"metadata": {},
"name": "my vapp 1",
"networks": [
{
"dhcpService": {
"defaultLeaseTime": 0,
"domainName": "string",
"ipRange": {
"endAddress": "string",
"startAddress": "string"
},
"isEnabled": false,
"maxLeaseTime": 0,
"primaryNameServer": "string",
"routerIp": "string",
"secondaryNameServer": "string",
"subMask": "string"
},
"fenceMode": "string",
"firewallService": {
"IsEnabled": false,
"defaultAction": "string",
"firewallRules": [
{
"description": "string",
"destinationIp": "string",
"destinationPortRange": "string",
"destinationVm": {
"ipType": "string",
"vmName": "string",
"vmNicId": 0
},
"direction": "string",
"enableLogging": false,
"icmpSubType": "string",
"id": "string",
"isEnabled": false,
"matchOnTranslate": false,
"policy": "string",
"port": 0,
"protocol": {
"any": false,
"icmp": false,
"other": "string",
"tcp": false,
"udp": false
},
"sourceIp": "string",
"sourcePort": 0,
"sourcePortRange": "string",
"sourceVm": {
"ipType": "string",
"vmName": "string",
"vmNicId": 0
}
}
],
"logDefaultAction": false
},
"ipScopes": [
{
"allocatedIpAddresses": [
"string"
],
"dnsSuffix": "string",
"gateway": "string",
"ipRanges": [
{
"endAddress": "string",
"startAddress": "string"
}
],
"isEnabled": false,
"isInherited": false,
"netmask": "string",
"primaryDns": "string",
"secondaryDns": "string"
}
],
"name": "string",
"natService": {
"externalIp": "string",
"isEnabled": false,
"natRules": [
{
"description": "string",
"gatewayNatRule": {
"icmpSubType": "string",
"originalIp": "string",
"originalPort": "string",
"protocol": "string",
"translatedIp": "string",
"translatedPort": "string"
},
"id": 0,
"isEnabled": false,
"oneToOneBasicRule": {
"externalIpAddress": "string",
"internalIpAddress": "string",
"mappingMode": "string"
},
"oneToOneVmRule": {
"externalIpAddress": "string",
"mappingMode": "string",
"vmName": "string",
"vmNicId": 0
},
"portForwardingRule": {
"externalIpAddress": "string",
"externalPort": 0,
"internalIpAddress": "string",
"internalPort": 0,
"protocol": "string"
},
"type": "string",
"vmRule": {
"externalIpAddress": "string",
"externalPort": 0,
"internalPort": 0,
"protocol": "string",
"vmName": "string",
"vmNicId": 0
}
}
],
"policy": "string",
"type": "string"
},
"parentId": "string",
"parentName": "string"
}
]
},
"destination": {
"org": "org2",
"recoveredVappId": "null",
"site": "site2",
"vdcId": "5ee9224f-305d-46f6-865f-b605e70acef8",
"vdcName": "Virtual DC 2"
},
"id": "C4VAPP-ccbe771e-b685-46c7-8c7a-4ed36915d963",
"isMigration": false,
"lastUpdated": 0,
"overallHealth": "GREEN",
"owner": "org1@site2",
"source": {
"org": "org1",
"site": "site1",
"vappId": "d6977f40-4d90-46b2-a34e-5077e8648eda",
"vdcId": "f61d60d2-698a-46dc-a266-88df27644956",
"vdcName": "Virtual DC 1"
},
"vmReplications": [
{
"computerName": "null",
"dataConnectionState": "SYNCING",
"destinationState": {
"currentRpoViolation": 25,
"isMovingReplica": false,
"lastError": {
"args": [
"string"
],
"code": "string",
"msg": "string",
"stacktrace": "string"
},
"latestInstance": {
"key": "replica-52f3e775-a8fa-13e3-e9be-39264ed2dfe2",
"quiescedType": "fileSystemQuiesced",
"sequenceNumber": 11,
"timestamp": 1469701818743,
"transferBytes": 512000,
"transferSeconds": 4
},
"recoveryInfo": {
"recoveryState": "NOT_STARTED",
"vAppId": "null",
"vcdVmId": "null"
},
"spaceRequirement": 0,
"state": "opened",
"stateAge": 0
},
"id": "C4-11111111-af9d-446a-8599-5b693842c4a3",
"isMigration": true,
"isPaused": false,
"isReversed": false,
"lastUpdated": 618094800000,
"metadata": {},
"overallHealth": "GREEN",
"settings": {
"dataConnectionType": "ENCRYPTED_COMPRESSED",
"description": "new description",
"excludedDiskKeys": [
0
],
"initialSyncTime": 0,
"quiesced": true,
"retentionPolicy": {
"rules": [
{
"distance": 15,
"numberOfInstances": 3
}
]
},
"rpo": 15
},
"sourceState": {
"progress": {
"bytesToTransfer": 1000,
"bytesTransferred": 400,
"checksumComparedBytes": 1000,
"checksumTotalBytes": 1000,
"progress": 40
},
"state": "idle",
"stateAge": 0
},
"startupInfo": {
"order": 0,
"startAction": "powerOn",
"startDelay": 0,
"stopAction": "powerOff",
"stopDelay": 0
},
"storageProfile": "null",
"vimLocation": {
"datastore": "datastore",
"datastoreMoref": "datastore-33",
"datastoreName": "test datastore",
"vimServer": "vim server",
"vimServerInstanceUuid": "b260ac0-eec6-4437-9184-54ee34a1e28d"
},
"vmDescription": "null",
"vmId": "d1d9739f-9e3b-4c24-9cbb-3a9fdddaf47c",
"vmName": "my vm 1"
}
]
},
"resultType": "string",
"site": "site2",
"startTime": 1499929548951,
"state": "SUCCEEDED",
"user": "root",
"warnings": [],
"workflowInfo": {
"resourceId": "C4VAPP-ccbe771e-b685-46c7-8c7a-4ed36915d963",
"resourceName": "my vapp 1",
"resourceType": "vappReplication",
"type": "sync"
}
}integer As int64 As int64
endTime
Optional
Timestamp (in msec) of the task's completion time. -1 means the task hasn't completed.
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.
string
resultType
Optional
Indicates the type of the task result. Populated only if the execution was successful.
string
site
Optional
Site on which the task runs.
integer As int64 As int64
startTime
Optional
Timestamp (in msec) of the task's creation time.
string
state
Optional
The current state of the task. States: [RUNNING, SUCCEEDED, FAILED]
Possible values are : RUNNING, SUCCEEDED, FAILED,
string
user
Optional
The user who started the task.
400
Returned error codes include (but are not limited to):
- BadRequest
Returns ApiError of type(s) application/vnd.vmware.h4-v3.5+json;charset=UTF-8
{
"args": [
"string"
],
"code": "string",
"msg": "string",
"stacktrace": "string"
}array of string
args
Optional
Positional arguments.
string
code
Optional
Specific error code.
string
msg
Optional
Detailed error message.
string
stacktrace
Optional
Exception stacktrace.
401
Returned error codes include (but are not limited to):
- NotAuthenticated
- RemoteAuthenticationFailure
Returns ApiError of type(s) application/vnd.vmware.h4-v3.5+json;charset=UTF-8
{
"args": [
"string"
],
"code": "string",
"msg": "string",
"stacktrace": "string"
}array of string
args
Optional
Positional arguments.
string
code
Optional
Specific error code.
string
msg
Optional
Detailed error message.
string
stacktrace
Optional
Exception stacktrace.
404
Returned error codes include (but are not limited to):
- VAppReplicationNotFound
- SiteNotFound
Returns ApiError of type(s) application/vnd.vmware.h4-v3.5+json;charset=UTF-8
{
"args": [
"string"
],
"code": "string",
"msg": "string",
"stacktrace": "string"
}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
Returned error codes include (but are not limited to):
- GeneralServerFailure
Returns ApiError of type(s) application/vnd.vmware.h4-v3.5+json;charset=UTF-8
{
"args": [
"string"
],
"code": "string",
"msg": "string",
"stacktrace": "string"
}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
Vapp Replications Operations
POST
Apply Storage Profile
PATCH
Chown
DELETE
Cleanup Failover Test
POST
Failover
POST
Failover Test
GET
Get Network Settings
POST
Migrate
POST
Pause
PATCH
Reconfigure
PATCH
Reconfigure Disks
GET
Replication
GET
Replications
POST
Resume
POST
Reverse
POST
Start
DELETE
Stop
POST
Sync
PATCH
Update Network Settings