Chown
This request allows administrators to change the owner of the specified vApp replication. By default, replications are owned by the user that started them. Any replication started by an administrator user would not be visible to the respective org, unless the administrator explicitly changes ownership of the replication to the org.
Alternatively, an administrator can temporarily take ownership of a replication to prevent the tenant from seeing or managing the replication while troubleshooting or an emergency recovery is in progress.
Changing the owner of the vApp replication results in the owner of the child VM replications being set to the same value.
Request
URI
PATCH
https://{api_host}/vapp-replications/{replicationId}/chown
COPY
Path Parameters
string
replicationId
Required
Cloud vApp-level replication identifier
replicationId example
C4VAPP-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
ChownSettings of type(s) application/json
Required
{
"owner": "org1@site1"
}string
owner
Optional
Optional owner of the replication, if omitted the currently logged in user becomes the owner.
Responses
200
OK
Returns VappReplicationInfo of type(s) application/json;charset=UTF-8
{
"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"
}
]
}string
id
Optional
The vApp-level replication ID.
boolean
isMigration
Optional
True if the VM replication is a migration. Otherwise, it's a protection.
integer As int64 As int64
lastUpdated
Optional
StartTime of the latest task associated with this vApp replication.
string
owner
Optional
The organisation that owns the replication.
401
The returned error codes include (but are not limited to): NotAuthenticated, RemoteAuthenticationFailure
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.
403
The returned error codes include (but are not limited to): Forbidden
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.
404
The returned error codes include (but are not limited to): SiteNotFound
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
Vapp Replications Operations
POST
Apply Storage Profile
PATCH
Chown
DELETE
Cleanup Failover Test
POST
Failover
POST
Failover Test
GET
Get Effective Guest Customization Settings
GET
Get Network Settings
POST
Migrate
POST
Pause
PATCH
Reconfigure
PATCH
Reconfigure Disks
PUT
Replace Guest Customization Settings
PUT
Replace Network Settings
GET
Replication
GET
Replications
POST
Resume
POST
Reverse
POST
Start
DELETE
Stop
POST
Sync