Get list of eligible machines that can be added to failover groups
Select
API to get list of machines eligible to be added to failover group
Query Parameters
- sourceEntityId int32 required
The ID of the source entity. This is the ID for client or client group
- failoverGroupSource string
Possible values: [
ARRAY_REPLICATION_TEST_FAILOVER
,ARRAY_REPLICATION_FAILOVER
,REPLICATION
,BACKUP
]The type of failover group source. Default value is 'REPLICATION'
- sourceEntityType string
Possible values: [
CLIENT_GROUP
,CLIENT
]The type of source entity. It can be 'CLIENT' or 'CLIENT_ENTITY'. Default value is 'CLIENT'
- destinationClientId int32
The client ID of the destination
- 200
- 404
OK
- application/json
- Schema
- Example (from schema)
Schema
virtualMachines object[]
replicationPairs object[]
The list of all replication pairs eligible to be added to failover group with replication source
id int32The ID of the replication pair
sourceId int32The id of the source machine
sourceName stringThe name of the source machine
destinationId int32The id of the destination machine
destinationName stringThe name of the destination machine
GUID stringThe GUID of the source of replication pair
priority int32The priority of the replication pair for DR operation in failover group. The lower values signify higher priority
copyPrecedence int32The copy precedence of replication pair
preFailoverScript object
DR operation scripting information
path stringThe path of the script to be executed. Can be local path on VM or UNC path accessible by access node
type stringPossible values: [
UNC
,LOCAL
]The type of path being used for DR operation script
scriptCredentials object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
guestCredentials object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
guid stringUnique script identifier string
scriptContent stringContent of the script to be executed
scriptName stringName of the script
reset booleanOn set to true, resets the script to empty
osType stringPossible values: [
WINDOWS
,UNIX
]OS types
postFailoverScript object
DR operation scripting information
path stringThe path of the script to be executed. Can be local path on VM or UNC path accessible by access node
type stringPossible values: [
UNC
,LOCAL
]The type of path being used for DR operation script
scriptCredentials object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
guestCredentials object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
guid stringUnique script identifier string
scriptContent stringContent of the script to be executed
scriptName stringName of the script
reset booleanOn set to true, resets the script to empty
osType stringPossible values: [
WINDOWS
,UNIX
]OS types
preFailbackScript object
DR operation scripting information
path stringThe path of the script to be executed. Can be local path on VM or UNC path accessible by access node
type stringPossible values: [
UNC
,LOCAL
]The type of path being used for DR operation script
scriptCredentials object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
guestCredentials object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
guid stringUnique script identifier string
scriptContent stringContent of the script to be executed
scriptName stringName of the script
reset booleanOn set to true, resets the script to empty
osType stringPossible values: [
WINDOWS
,UNIX
]OS types
postFailbackScript object
DR operation scripting information
path stringThe path of the script to be executed. Can be local path on VM or UNC path accessible by access node
type stringPossible values: [
UNC
,LOCAL
]The type of path being used for DR operation script
scriptCredentials object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
guestCredentials object
savedCredentials object
id int32name stringcredentials object
name stringusername to access the network path
password stringpassword to access the network path
guid stringUnique script identifier string
scriptContent stringContent of the script to be executed
scriptName stringName of the script
reset booleanOn set to true, resets the script to empty
osType stringPossible values: [
WINDOWS
,UNIX
]OS types
arrayReplicationPairs object[]
List of all array replication pairs for failover group that are eligible to be added
id int32The ID of the array replication pair
sourceId int32The id of the source machine
sourceName stringThe name of the source machine
destinationId int32The id of the destination machine
destinationName stringThe name of the destination machine
GUID stringThe GUID of the source of array replication pair
priority int32The priority of the array replication pair for DR operation in failover group. The lower values signify higher priority
ipSettings object[]
The settings for IP address mapping
sourceIP stringThe full IP address or an IP address pattern of the source VM.
sourceSubnetMask stringThe subnet mask of the source VM.
sourceDefaultGateway stringThe default gateway of the source VM.
useDhcp booleanDefault value:
false
Automatically assigns available IP addresses to be used with the specified destination network.
destinationIP stringThe full IP address or an IP address pattern for the destination VM. Provide only if DHCP is not enabled.
destinationSubnetMask stringThe subnet mask for the destination VM. Provide only if DHCP is not enabled.
destinationDefaultGateway stringThe default gateway for the destination VM. Provide only if DHCP is not enabled.
destinationPreferredDNS stringThe preferred DNS server for the destination VM. Provide only if DHCP is not enabled
destinationAlternateDNS stringThe alternate DNS server for the destination VM. Provide only if DHCP is not enabled
destinationPreferredWINS stringThe preferred WINS server for the destination VM. Provide only if DHCP is not enabled
destinationAlternateWINS stringThe alternate WINS server for the destination VM. Provide only if DHCP is not enabled
hostname stringThe hostname specified for the destination machine
{
"virtualMachines": [
{
"replicationPairs": [
{
"id": 0,
"sourceId": 0,
"sourceName": "string",
"destinationId": 0,
"destinationName": "string",
"GUID": "string",
"priority": 0,
"copyPrecedence": 0,
"preFailoverScript": {
"path": "string",
"type": "UNC",
"scriptCredentials": {
"savedCredentials": {
"id": 0,
"name": "string"
},
"credentials": {
"name": "string",
"password": "string"
}
},
"guestCredentials": {
"savedCredentials": {
"id": 0,
"name": "string"
},
"credentials": {
"name": "string",
"password": "string"
}
},
"guid": "string",
"scriptContent": "string",
"scriptName": "string",
"reset": true,
"osType": "WINDOWS"
},
"postFailoverScript": {
"path": "string",
"type": "UNC",
"scriptCredentials": {
"savedCredentials": {
"id": 0,
"name": "string"
},
"credentials": {
"name": "string",
"password": "string"
}
},
"guestCredentials": {
"savedCredentials": {
"id": 0,
"name": "string"
},
"credentials": {
"name": "string",
"password": "string"
}
},
"guid": "string",
"scriptContent": "string",
"scriptName": "string",
"reset": true,
"osType": "WINDOWS"
},
"preFailbackScript": {
"path": "string",
"type": "UNC",
"scriptCredentials": {
"savedCredentials": {
"id": 0,
"name": "string"
},
"credentials": {
"name": "string",
"password": "string"
}
},
"guestCredentials": {
"savedCredentials": {
"id": 0,
"name": "string"
},
"credentials": {
"name": "string",
"password": "string"
}
},
"guid": "string",
"scriptContent": "string",
"scriptName": "string",
"reset": true,
"osType": "WINDOWS"
},
"postFailbackScript": {
"path": "string",
"type": "UNC",
"scriptCredentials": {
"savedCredentials": {
"id": 0,
"name": "string"
},
"credentials": {
"name": "string",
"password": "string"
}
},
"guestCredentials": {
"savedCredentials": {
"id": 0,
"name": "string"
},
"credentials": {
"name": "string",
"password": "string"
}
},
"guid": "string",
"scriptContent": "string",
"scriptName": "string",
"reset": true,
"osType": "WINDOWS"
}
}
],
"arrayReplicationPairs": [
{
"id": 0,
"sourceId": 0,
"sourceName": "string",
"destinationId": 0,
"destinationName": "string",
"GUID": "string",
"priority": 0,
"ipSettings": [
{
"sourceIP": "string",
"sourceSubnetMask": "string",
"sourceDefaultGateway": "string",
"useDhcp": false,
"destinationIP": "string",
"destinationSubnetMask": "string",
"destinationDefaultGateway": "string",
"destinationPreferredDNS": "string",
"destinationAlternateDNS": "string",
"destinationPreferredWINS": "string",
"destinationAlternateWINS": "string"
}
],
"hostname": "string"
}
]
}
]
}
Not Found
- application/json
- Schema
- Example (from schema)
Schema
- errorMessage string
- errorCode int32
{
"errorMessage": "string",
"errorCode": 0
}