Vm Replications
This request returns all the configured VM replications.
If present, returned replications will be filtered by replication owner. Filtering option available only to admins.
org2@site2
If present, returned replications will be filtered by source vDC id.
38c4079d-131e-499f-aadb-60dfbaf85c08
If present, returned replications will be filtered by source vDC name.
org1_vdc1
If present, returned replications will be filtered by source site short name. Local site filtering is not supported.
site1
If present, returned replications will be filtered by source site type.
vcenter
If present, returned replications will be filtered by VMware Cloud Director source org.
org1
If present, admins can filter by source vCenter instance id.
0c4268dc-1786-404a-bea2-52f1709a732f
If 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-1
If present, returned replications will be filtered by Virtual Machine name. The VM name must contain the provided value.
VM1
If present, returned replications will be filtered by storage profile.
7475abd4-7e9f-46de-9edc-64f98e7eac6a
If present, returned replications will be filtered by destination org.
org2
If present, returned replications will be filtered by destination vDC id.
f3f9df5d-006b-429b-875b-028f0012759b
If present, returned replications will be filtered by destination vDC name.
org2_vdc2
If present, returned replications will be filtered by destination site type.
vcloud
If present, admins can filter by vCenter instance id.
5b8d24f5-eaa7-4124-ad46-3f84c089360a
If present, admins can filter by datastore moid (vimServerInstanceUuid is required in this case).
datastore-1
If present, returned replications will be filtered by destination recovered vmId.
05bab7e6-adb9-4aa6-9e38-70f8b9e25613
If present, returned replications will be filtered by replication type: migration or protection.
true
The SLA Profile to use instead of the custom rpo/dataConnectionType/retentionPolicy settings.
e137ef16-010a-4cc8-9121-53985cb67c5b
The displayName of the SLA Profile used by a replication.
Silver
If 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-0daf9c0a7bcb
If present, only replications for which management operations that were performed no later than the specified date are returned.
1499929599999
If present, only replications for which management operations that were performed after the specified date are returned.
1499929500000
An 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 their data connection state.
POWERED_OFF
If present, returned replications will be filtered by their overall health.
YELLOW
Optional site to run the operation on. If omitted, defaults to the local site.
site2
Query limit - maximum number of items this query should retrieve. If omitted or higher than the server's limits, defaults to 100.
10
Query offset - how much items to skip, before retrieving the actual items. If omitted, defaults to 0.
10
Operation ID for correlating logs across multiple services
OK
{
"items": [
{
"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": false,
"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,
"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": [
{
"distance": 15,
"numberOfInstances": 3
}
]
},
"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": "string",
"dsClusterName": "string",
"vimServer": "vim server",
"vimServerInstanceUuid": "b260ac0-eec6-4437-9184-54ee34a1e28d"
},
"vmDescription": "description",
"vmId": "d1d9739f-9e3b-4c24-9cbb-3a9fdddaf47c",
"vmName": "my vm 1",
"destination": {
"org": "org2",
"recoveredVappId": "null",
"site": "site2",
"vdcId": "5ee9224f-305d-46f6-865f-b605e70acef8",
"vdcName": "Virtual DC 2"
},
"source": {
"vappName": "vApp1"
},
"vappReplicationId": "C4VAPP-ccbe771e-b685-46c7-8c7a-4ed36915d963"
}
],
"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.