Reconfigure
This request configures the replication settings of the specified vApp replication.
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.
Cloud vApp-level replication identifier
C4VAPP-ec991bd5-af9d-446a-8599-5b693842c4a3Optional site to run the operation on. When omitted, defaults to the local site.
site1Operation ID for correlating logs across multiple services
{
"dataConnectionType": "string",
"description": "New description",
"initialSyncTime": 0,
"quiesced": true,
"retentionPolicy": {
"rules": [
{
"numberOfInstances": 3,
"distance": 60
}
]
},
"rpo": 15,
"slaProfileId": "c4ReplicationReconfigureSettings.slaProfileId.example"
}The description of the replication.
Settings for reconfiguring the destination.
Optional value. Replication initial sync time. If in the past, 0 or negative, the sync will not be delayed. The time is specified as the difference, measured in milliseconds, between the current time and midnight, January 1, 1970 UTC.
Replicated image guest quiescing - if empty/omitted no change will be applied.
Recovery point objective in minutes - if empty/omitted no change will be applied.
When omitted old SLA profile ID will be used (if any) or if rpo, dataConnectionType, quiesced or retentionPolicy are specified - old SLA profile will be discarded and custom settings will be used.
Settings for reconfiguring the source.
Accepted
{
"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": {
"descriptor": {
"description": "vapp description in VMware Cloud Director",
"enabledTemplateCustomization": false,
"isGolden": false,
"metadata": {},
"name": "my vapp 1",
"networks": [
{
"dhcpService": {
"defaultLeaseTime": 86400,
"domainName": "acme.com",
"ipRange": {
"endAddress": "10.71.80.255",
"startAddress": "10.71.80.0"
},
"isEnabled": true,
"maxLeaseTime": 86400,
"primaryNameServer": "8.8.8.8",
"routerIp": "192.168.0.1",
"secondaryNameServer": "8.8.4.4",
"subMask": "255.255.255.0"
},
"fenceMode": "bridged",
"firewallService": {
"defaultAction": "allow",
"firewallRules": [],
"isEnabled": true,
"logDefaultAction": false
},
"ipScopes": [
{
"allocatedIpAddresses": [
"10.71.81.55"
],
"dnsSuffix": "acme.com",
"gateway": "192.168.4.1",
"ipRanges": [
{
"startAddress": "10.71.80.0",
"endAddress": "10.71.80.255"
}
],
"isEnabled": true,
"isInherited": true,
"netmask": "255.255.225.0",
"primaryDns": "8.8.8.8",
"secondaryDns": "8.8.4.4"
}
],
"name": "myvappnetworkdescriptor",
"natService": {
"externalIp": "1.2.3.4",
"isEnabled": true,
"natRules": [
{
"description": "Some description.",
"gatewayNatRule": {
"icmpSubType": "any",
"originalIp": "10.20.30.40",
"originalPort": "\"80\"",
"protocol": "TCP",
"translatedIp": "11.22.33.44",
"translatedPort": "\"88\""
},
"id": 1,
"isEnabled": true,
"oneToOneBasicRule": {
"externalIpAddress": "any",
"internalIpAddress": "any",
"mappingMode": "automatic"
},
"oneToOneVmRule": {
"externalIpAddress": "10.71.80.255",
"mappingMode": "automatic",
"vmName": "myvm",
"vmNicId": 0
},
"portForwardingRule": {
"externalIpAddress": "10.71.80.255",
"externalPort": 80,
"internalIpAddress": "10.20.30.40",
"internalPort": 88,
"protocol": "TCP"
},
"type": "SNAT",
"vmRule": {
"externalIpAddress": "10.71.80.255",
"externalPort": 80,
"internalPort": 88,
"protocol": "TCP",
"vmName": "myvm",
"vmNicId": 0
}
}
],
"policy": "allowTraffic",
"type": "ipTranslation"
},
"parentId": "b879c7ba-461e-46fe-af51-8208c063002e",
"parentName": "myparent",
"routerExternalIp": "10.20.30.40"
}
],
"sourceCatalogItemId": "0221b98b-b91c-4524-a491-f744f67bffbe"
},
"destination": {
"destinationCatalogItemId": "0221b98b-b91c-4524-a491-f744f67bffbe",
"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": "string",
"owner": "org1@site2",
"source": {
"isTemplate": false,
"org": "org1",
"site": "site1",
"sourceCatalogId": "0221b98b-b91c-4524-a491-f744f67bffbe",
"sourceCatalogName": "Catalog1",
"vappId": "d6977f40-4d90-46b2-a34e-5077e8648eda",
"vdcId": "f61d60d2-698a-46dc-a266-88df27644956",
"vdcName": "Virtual DC 1"
},
"vmReplications": [
{
"computerName": "computerName",
"dataConnectionState": "string",
"destinationState": {
"currentRpoViolation": 25,
"isMovingReplica": false,
"lastError": {
"args": [],
"code": "Forbidden",
"msg": "Permission denied.",
"stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
},
"latestInstance": {
"isPinned": true,
"key": "replica-52f3e775-a8fa-13e3-e9be-39264ed2dfe2",
"quiescedType": "string",
"sequenceNumber": 11,
"timestamp": 1469701818743,
"transferBytes": 512000,
"transferSeconds": 4
},
"spaceRequirement": 0,
"state": "string",
"stateAge": 0
},
"guestCustomization": {
"adminAutoLogonCount": 3,
"adminPassword": "sEcUrEpAsS",
"adminPasswordAuto": true,
"adminPasswordEnabled": true,
"changeSid": true,
"computerName": "workload-69",
"customizationScript": "echo 'hello world'",
"domainName": "workgroup",
"domainOrgUnit": "computers",
"domainUserName": "user1",
"domainUserPassword": "sEcUrEpAsS",
"enabled": true,
"joinDomainEnabled": true,
"resetPasswordRequired": true,
"resolutionType": "string",
"useOrgSettings": true
},
"id": "C4-11111111-af9d-446a-8599-5b693842c4a3",
"isMigration": true,
"isPaused": false,
"isReversed": false,
"lastUpdated": 618094800000,
"metadata": {},
"overallHealth": "string",
"owner": "org1@site1",
"placementPolicy": "ecde053f-1aed-4547-b73a-52b9f7c48298",
"placementPolicyName": "Gold",
"settings": {
"dataConnectionType": "string",
"description": "new description",
"excludedDiskKeys": [
0
],
"initialSyncTime": 0,
"quiesced": true,
"retentionPolicy": {
"rules": [
{
"numberOfInstances": 3,
"distance": 60
}
]
},
"rpo": 15,
"targetDiskType": "string"
},
"sizingPolicy": "ecde053f-1aed-4547-b73a-52b9f7c48298",
"sizingPolicyName": "SizingPolicy1",
"slaProfile": {
"displayName": "Gold",
"id": "61c528c8-1a8c-4c4e-8886-f1b6eeba98a5"
},
"sourceState": {
"stateAge": 0
},
"sourceVmEncrypted": false,
"startupInfo": {
"order": 0,
"startAction": "powerOn",
"startDelay": 0,
"stopAction": "powerOff",
"stopDelay": 0
},
"storageProfile": "ecde053f-1aed-4547-b73a-52b9f7c48298",
"storageProfileName": "*",
"vimLocation": {
"datastore": "datastore",
"datastoreMoref": "datastore-33",
"datastoreName": "test datastore",
"dsClusterMoref": "test datastore cluster",
"dsClusterName": "datastoreCluster-12",
"vimServer": "vim server",
"vimServerInstanceUuid": "b260ac0-eec6-4437-9184-54ee34a1e28d"
},
"vmDescription": "description",
"vmId": "d1d9739f-9e3b-4c24-9cbb-3a9fdddaf47c",
"vmName": "my vm 1"
}
]
},
"resultType": "string",
"site": "site2",
"startTime": 1499929548951,
"state": "string",
"user": "root",
"warnings": [],
"workflowInfo": {}
}Timestamp in msec of the completion time of the task. -1 indicates that the task did not complete yet.
The unique identifier of the long-running task. It is unique and can be used for monitoring.
Timestamp in msec of the last task status update.
Percentage-based progress of the task.
Indicates the type of the task result. Populates only when the execution succeeds.
Site on which the task runs.
Timestamp in msec of the creation time of the task.
The user who started the task.
The returned error codes include (but are not limited to): BadRequest
{
"args": [],
"code": "Forbidden",
"msg": "Permission denied.",
"stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}Positional arguments.
Specific error code.
Detailed error message.
Exception stacktrace.
The returned error codes include (but are not limited to): NotAuthenticated, RemoteAuthenticationFailure
{
"args": [],
"code": "Forbidden",
"msg": "Permission denied.",
"stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}Positional arguments.
Specific error code.
Detailed error message.
Exception stacktrace.
The returned error codes include (but are not limited to): SiteNotFound
{
"args": [],
"code": "Forbidden",
"msg": "Permission denied.",
"stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}Positional arguments.
Specific error code.
Detailed error message.
Exception stacktrace.
The returned error codes include (but are not limited to): GeneralServerFailure
{
"args": [],
"code": "Forbidden",
"msg": "Permission denied.",
"stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
}Positional arguments.
Specific error code.
Detailed error message.
Exception stacktrace.