Vm Replications
This request returns all the configured VM replications.
If present, returned replications will be filtered by their data connection state.
POWERED_OFFIf present, admins can filter by datastore moid (vimServerInstanceUuid is required in this case).
datastore-1If present, returned replications will be filtered by destination org.
org2If present, returned replications will be filtered by destination site type.
vcloudIf present, returned replications will be filtered by destination vDC id.
f3f9df5d-006b-429b-875b-028f0012759bIf present, returned replications will be filtered by destination vDC name.
org2_vdc2If present, returned replication's IDs will be in the given list. Comma-separated C4 replication ids are expected.
C4-d50b197f-c0ab-4041-bf38-d59c8fda437c,C4-d75a6707-b9ee-4324-8848-0daf9c0a7bcbIf present, returned replications will be filtered by replication type: migration or protection.
trueIf present, only replications for which management operations that were performed after the specified date are returned.
1499929500000If present, only replications for which management operations that were performed no later than the specified date are returned.
1499929599999Query limit - maximum number of items this query should retrieve. If omitted or higher than the server's limits, defaults to 100.
10Query offset - how much items to skip, before retrieving the actual items. If omitted, defaults to 0.
10If present, returned replications will be filtered by their overall health.
YELLOWIf present, returned replications will be filtered by replication owner. Filtering option available only to admins.
org2@site2If present, returned replications will be filtered by destination recovered vmId.
05bab7e6-adb9-4aa6-9e38-70f8b9e25613Optional site to run the operation on. If omitted, defaults to the local site.
site2The displayName of the SLA Profile used by a replication.
SilverThe SLA Profile to use instead of the custom rpo/dataConnectionType/retentionPolicy settings.
e137ef16-010a-4cc8-9121-53985cb67c5bAn optional list of comma-separated fields, used to sort the result. The default sorting direction is ascending. If one of the fields ends with a hyphen, the direction for this field will be descending. This allows chaining e.g. col,col2-,col3 will result in sorting by col (asc), then by col2 (desc) and finally by col3 (asc). Supported fields: [name, sourceSite, sourceOrg, sourceVdcName, destinationOrg, destinationVdcName, site, owner, lastUpdated]. If this field is omitted, the result is sorted by last update time in descending order.
vmName,sourceOrg-If present, returned replications will be filtered by VMware Cloud Director source org.
org1If present, returned replications will be filtered by source site short name. Local site filtering is not supported.
site1If present, returned replications will be filtered by source site type.
vcenterIf present, returned replications will be filtered by source vDC id.
38c4079d-131e-499f-aadb-60dfbaf85c08If present, returned replications will be filtered by source vDC name.
org1_vdc1If present, admins can filter by source vCenter instance id.
0c4268dc-1786-404a-bea2-52f1709a732fIf present, returned replications will be filtered by storage profile.
7475abd4-7e9f-46de-9edc-64f98e7eac6aIf present, admins can filter by vCenter instance id.
5b8d24f5-eaa7-4124-ad46-3f84c089360aIf present, returned replications will be filtered by source vm id, e.g. vm-1 for a DR2C replication, 4e7fa4b1-e8d9-45bd-a91d-852c46b7a0da for C2C replication.
vm-1If present, returned replications will be filtered by Virtual Machine name. The VM name must contain the provided value.
VM1Operation ID for correlating logs across multiple services
OK
{
"items": [
{
"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"
}
],
"limit": 100,
"offset": 0,
"total": 3
}Maximum number of items that this query could retrieve.
How much items were skipped, before retrieving the actual items.
The total number of items.
The returned error codes include (but are not limited to):
- UnsupportedSortingField
{
"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.