Chown Vm Replication

Chown Vm Replication

This request allows administrators to change the owner of the specified VM replication. By default, replications are owned by the user that started them. Any replications 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 in order to prevent the tenant from seeing or managing the replication while troubleshooting or an emergency recovery is in progress.

Request
URI
PATCH
https://{api_host}//vm-replications/{replicationId}/chown
COPY
Path Parameters
string
replicationId
Required

The VM Replication unique identifier

replicationId example 
C4-09b2917c-bbe9-4693-ae3f-95b43a94b244
Query Parameters
string
site
Optional

site

Header Parameters
string
operationID
Optional

Operation ID for correlating logs across multiple services

Request Body
ChownSettings of type(s) application/json
Optional 
{
    "owner": "org1@site1"
}
string
owner
Optional

Optional owner of the replication, if omitted the currently logged in user becomes the owner.

Authentication
This operation uses the following authentication methods.
Responses
200

OK

Returns SingleVmReplicationInfo of type(s) application/json;charset=UTF-8 
{
    "computerName": "computerName",
    "dataConnectionState": "SYNCING",
    "destination": {
        "org": "org2",
        "recoveredVappId": "null",
        "site": "site2",
        "vdcId": "5ee9224f-305d-46f6-865f-b605e70acef8",
        "vdcName": "Virtual DC 2"
    },
    "destinationState": {
        "currentRpoViolation": 25,
        "isMovingReplica": false,
        "lastError": {
            "args": [],
            "code": "Forbidden",
            "msg": "Permission denied.",
            "stacktrace": "com.vmware.h4.api.error.exceptions.PermissionDeniedException: Permission denied."
        },
        "latestInstance": {
            "isPinned": false,
            "key": "replica-52f3e775-a8fa-13e3-e9be-39264ed2dfe2",
            "quiescedType": "fileSystemQuiesced",
            "sequenceNumber": 11,
            "timestamp": 1469701818743,
            "transferBytes": 512000,
            "transferSeconds": 4
        },
        "recoveryInfo": {
            "recoveryState": "NOT_STARTED"
        },
        "spaceRequirement": 0,
        "state": "opened",
        "stateAge": 0
    },
    "id": "C4-11111111-af9d-446a-8599-5b693842c4a3",
    "isMigration": true,
    "isPaused": false,
    "isReversed": false,
    "lastUpdated": 618094800000,
    "metadata": {},
    "overallHealth": "GREEN",
    "owner": "org1@site1",
    "settings": {
        "dataConnectionType": "ENCRYPTED_COMPRESSED",
        "description": "new description",
        "excludedDiskKeys": [
            0
        ],
        "initialSyncTime": 0,
        "quiesced": true,
        "retentionPolicy": {
            "rules": [
                {
                    "distance": 15,
                    "numberOfInstances": 3
                }
            ]
        },
        "rpo": 15
    },
    "slaProfile": {
        "displayName": "Gold",
        "id": "61c528c8-1a8c-4c4e-8886-f1b6eeba98a5"
    },
    "source": {
        "org": "org1",
        "site": "site1",
        "vappId": "d6977f40-4d90-46b2-a34e-5077e8648eda",
        "vappName": "vApp1",
        "vdcId": "f61d60d2-698a-46dc-a266-88df27644956",
        "vdcName": "Virtual DC 1"
    },
    "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": "ecde053f-1aed-4547-b73a-52b9f7c48298",
    "storageProfileName": "Default",
    "vappReplicationId": "C4VAPP-ccbe771e-b685-46c7-8c7a-4ed36915d963",
    "vimLocation": {
        "datastore": "datastore",
        "datastoreMoref": "datastore-33",
        "datastoreName": "test datastore",
        "vimServer": "vim server",
        "vimServerInstanceUuid": "b260ac0-eec6-4437-9184-54ee34a1e28d"
    },
    "vmDescription": "description",
    "vmId": "d1d9739f-9e3b-4c24-9cbb-3a9fdddaf47c",
    "vmName": "my vm 1"
}
string
computerName
Optional

VMware Cloud Director VM computer name.

string
dataConnectionState
Optional

Shows the replication traffic (data) connection health. Possible values: [SYNCING, INITIAL_SYNCING, OK, PAUSED, POWERED_OFF, PRUNING, FINISHED, UNKNOWN, ERROR]

Possible values are : SYNCING, INITIAL_SYNCING, OK, PAUSED, POWERED_OFF, PRUNING, FINISHED, UNKNOWN, ERROR,
DestinationInfo
destination
Optional

destination

CloudDestinationStateInfo
destinationState
Optional

destinationState

string
id
Optional

The VM-level replication ID.

boolean
isMigration
Optional

True if the VM replication is a migration. Otherwise, it's a protection.

boolean
isPaused
Optional

Indicates whether the underlying VM replication is paused.

boolean
isReversed
Optional

Whether the replication is reversed. Note this flag gets inverted on each reverse, so only the odd reversed replication will show 'true'.

integer As int64 As int64
lastUpdated
Optional

The startTime of the latest task associated with this vm replication.

object
metadata
Optional

VMware Cloud Director metadata for the VM.

string
overallHealth
Optional

Representation of the replication health suitable for UI purposes.

Possible values are : GREEN, YELLOW, RED,
string
owner
Optional

The user that owns the replication

VmReplicationSettings
settings
Optional

settings

ReplicationSlaProfile
slaProfile
Optional

slaProfile

VmSourceInfo
source
Optional

source

SourceStateInfo
sourceState
Optional

sourceState

VmStartupInfo
startupInfo
Optional

startupInfo

string
storageProfile
Optional

Destination storage profile.

string
storageProfileName
Optional

Destination storage profile display name

string
vappReplicationId
Optional

Id of the corresponding vApp replication

VimLocation
vimLocation
Optional

vimLocation

string
vmDescription
Optional

VMware Cloud Director VM description.

string
vmId
Optional

VMware Cloud Director VM ID.

string
vmName
Optional

VMware Cloud Director VM name.


401

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

  • NotAuthenticated
Returns ApiError of type(s) application/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/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
Vm Replications Operations
POST
Apply Storage Profile Vm Replication
PATCH
Chown Vm Replication
DELETE
Cleanup Failover Test Vm Replication
GET
Disk Samples Vm Replication
POST
Failover Test Vm Replication
POST
Failover Vm Replication
GET
Get Network Settings Vm Replication
GET
Get Virtual Hardware
GET
Get Vm Replication
GET
Instance Vm Replication
GET
Instances Vm Replication
POST
Migrate Vm Replication
POST
Pause Vm Replication
PATCH
Reconfigure Disks Vm Replication
PATCH
Reconfigure Vm Replication
PUT
Replace Network Settings Vm Replication
POST
Resume Vm Replication
POST
Reverse Vm Replication
POST
Start Vm Replication
DELETE
Stop Vm Replication
POST
Sync Vm Replication
GET
Traffic Samples Vm Replication
PATCH
Update Network Settings Vm Replication
GET
Vm Replications