Get Failover group details
API to fetch failover group information
Path Parameters
- failoverGroupId int32 required
Id of the failover group
- 200
- 404
- 503
OK
- application/json
- Schema
- Example (from schema)
Schema
- id int32
Failover group Id
- name string
Failover group name
sourceHypervisor object
The hypervisor client/client group information for failover groups
id int32The Id of client/client group
name stringThe name of the hypervisor client/client group
type stringPossible values: [
CLIENT_GROUP
,CLIENT
]The type of entity is used
vendor stringPossible values: [
NONE
,VMW
,MICROSOFT
,XEN_SERVER
,AMAZON
,AZURE
,REDHAT
,AZURE_V2
,SCVMM
,NUTANIX
,ORACLE_VM
,DOCKER
,OPENSTACK
,ORACLE_CLOUD
,FUSIONCOMPUTE
,VCLOUD
,GOOGLE_CLOUD
,AZURE_STACK
,ALIBABA_CLOUD
,ORACLE_CLOUD_INFRASTRUCTURE
,KUBERNETES
,REDHAT_OPENSHIFT
,PROXMOX
]destinationHypervisor object
The hypervisor client/client group information for failover groups
id int32The Id of client/client group
name stringThe name of the hypervisor client/client group
type stringPossible values: [
CLIENT_GROUP
,CLIENT
]The type of entity is used
vendor stringPossible values: [
NONE
,VMW
,MICROSOFT
,XEN_SERVER
,AMAZON
,AZURE
,REDHAT
,AZURE_V2
,SCVMM
,NUTANIX
,ORACLE_VM
,DOCKER
,OPENSTACK
,ORACLE_CLOUD
,FUSIONCOMPUTE
,VCLOUD
,GOOGLE_CLOUD
,AZURE_STACK
,ALIBABA_CLOUD
,ORACLE_CLOUD_INFRASTRUCTURE
,KUBERNETES
,REDHAT_OPENSHIFT
,PROXMOX
]- source string
Possible values: [
ARRAY_REPLICATION_TEST_FAILOVER
,ARRAY_REPLICATION_FAILOVER
,REPLICATION
,BACKUP
]Failover group type
- isApprovalRequired boolean
Whether a user approval is required for DR operations
usersToNotify object[]
Users to notify/for approval of DR operations
id int32name stringdisplayName stringcompany object
id int32name string- operationType string
Possible values: [
LIVE_MOUNT
,LIVE_SYNC
,RESTORE
,LIVE_RECOVERY
,FAILOVER
,VIRTUAL_LAB
,ORACLE_EBS_APP
,GENERIC_ENTERPRISE_APP
,TEST_FAILOVER
]Failover group operation type
subclient object
id int32name stringstoragePolicy object
id int32name stringcopy object
id int32name string- priorityIntervalInMinutes int32
Possible values:
>= 1
The interval between DR operations of different priorities
- continueDROnFailure boolean
Whether to continue to next priority on DR job failure
recoveryTarget object
id int32name stringautomaticFailover object
The failover group automatic failover information of access nodes and monitoring status
machines object[]
id int32name stringmonitoringStatus stringPossible values: [
DISABLED
,FAILED
,ENABLED
,PAUSED
,STARTING
,NOT_CONFIGURED
]Automatic failover monitoring status
outageDelayTimeInMinutes int32Delay time before declaring outage (in minutes)
status stringPossible values: [
OFFLINE
,ONLINE
]Automatic failover configuration status
plannedFailoverSchedules object[]
The list of all planned failover schedules
scheduleId int32Id of the schedule if available, required for modifying, deleting schedule
scheduleName stringName of the schedule, for modify
policyId int32Schedule policy Id to which the schedule belongs
scheduleOperation stringPossible values: [
ADD
,DELETE
,MODIFY
]Default value:
MODIFY
Operation being performed on schedule
vmOperationType stringPossible values: [
PLANNED_FAILOVER
,TEST_BOOT
]Type of DR operation (only applicable for Failover groups)
backupType stringPossible values: [
FULL
,INCREMENTAL
,DIFFERENTIAL
,SYNTHETICFULL
,TRANSACTIONLOG
]Schedule Backup level
forDatabasesOnly booleanDefault value:
false
Boolean to indicate if schedule is for database agents
schedulePattern object
Used to describe when the schedule runs
scheduleFrequencyType stringPossible values: [
MINUTES
,DAILY
,WEEKLY
,MONTHLY
,YEARLY
,AUTOMATIC
]schedule frequency type
frequency int32Possible values:
>= 1
Frequency of the schedule based on schedule frequency type eg. for Hours, value 2 is 2 hours, for Minutes, 30 is 30 minutes, for Daily, 2 is 2 days. for Monthly 2 is it repeats every 2 months
weeklyDays string[]Possible values: [
SUNDAY
,MONDAY
,TUESDAY
,WEDNESDAY
,THURSDAY
,FRIDAY
,SATURDAY
]Days of the week for weekly frequency
dayOfMonth int32Possible values:
>= 1
and<= 31
Day on which to run the schedule, applicable for monthly, yearly
weekOfMonth stringPossible values: [
FIRST
,SECOND
,THIRD
,FOURTH
,LAST
]Specific week of a month
dayOfWeek stringPossible values: [
SUNDAY
,MONDAY
,TUESDAY
,WEDNESDAY
,THURSDAY
,FRIDAY
,SATURDAY
,DAY
,WEEKDAY
,WEEKEND_DAYS
]monthOfYear stringPossible values: [
JANUARY
,FEBRUARY
,MARCH
,APRIL
,MAY
,JUNE
,JULY
,AUGUST
,SEPTEMBER
,OCTOBER
,NOVEMBER
,DECEMBER
]repeatIntervalInMinutes int32Possible values:
>= 1
How often in minutes in a day the schedule runs, applicable for daily, weekly, monthly and yearly frequency types.
repeatUntilTime int32Until what time to repeat the schedule in a day, requires repeatIntervalInMinutes
timezone object
id int32name stringstartTime int32Default value:
75600
start time of schedule in seconds
startDate int32start date of schedule in epoch format
endDate int32Schedule end date in epoch format
noOfTimes int32The number of times you want the schedule to run.
exceptions object[]
Exceptions to when a schedule should not run, either in dates or week of month and days
onDates int32[]Possible values:
>= 1
and<= 31
list of dates in a month. For ex: 1, 20
onWeekOfTheMonth string[]Possible values: [
FIRST
,SECOND
,THIRD
,FOURTH
,LAST
]On which week of month, for ex: FIRST, LAST
onDayOfTheWeek string[]Possible values: [
SUNDAY
,MONDAY
,TUESDAY
,WEDNESDAY
,THURSDAY
,FRIDAY
,SATURDAY
,DAY
,WEEKDAY
,WEEKEND_DAYS
]On which days, for ex: MONDAY, FRIDAY
daysBetweenSyntheticFulls int32Possible values:
>= 6
No of days between two synthetic full jobs
maxBackupIntervalInMins int32Default value:
240
The number of mins to force a backup on automatic schedule.
scheduleOption object
Specific options to be set on schedules
useDiskCacheForLogBackups booleanUsed to enable disk caching feature on databases for automatic schedules on server plan
commitFrequencyInHours int32Commit frequency in hours for disk cache backups from automatic schedules
daysBetweenAutoConvert int32Number of days between auto conversion of backup level applicable for databases on incremental and differential schedules of server plan
o365ItemSelectionOption stringPossible values: [
SELECT_ALL
,SELECT_NEVER_PROCESSED
,SELECT_MEETING_SLA
,SELECT_NOT_MEETING_SLA_PROCESSED_ATLEAST_ONCE
,SELECT_FAILED_LAST_ATTEMPT
,SELECT_PROCESSED_ATLEAST_ONCE
,SELECT_NOT_MEETING_SLA
,SELECT_MEETING_SLA_NOT_RECENTLY_BACKED_UP
]item backup option for O365 V2 backup jobs
jobRunningTimeInMins int32total job running time in minutes
testBootSchedules object[]
The list of all test boot schedules
scheduleId int32Id of the schedule if available, required for modifying, deleting schedule
scheduleName stringName of the schedule, for modify
policyId int32Schedule policy Id to which the schedule belongs
scheduleOperation stringPossible values: [
ADD
,DELETE
,MODIFY
]Default value:
MODIFY
Operation being performed on schedule
vmOperationType stringPossible values: [
PLANNED_FAILOVER
,TEST_BOOT
]Type of DR operation (only applicable for Failover groups)
backupType stringPossible values: [
FULL
,INCREMENTAL
,DIFFERENTIAL
,SYNTHETICFULL
,TRANSACTIONLOG
]Schedule Backup level
forDatabasesOnly booleanDefault value:
false
Boolean to indicate if schedule is for database agents
schedulePattern object
Used to describe when the schedule runs
scheduleFrequencyType stringPossible values: [
MINUTES
,DAILY
,WEEKLY
,MONTHLY
,YEARLY
,AUTOMATIC
]schedule frequency type
frequency int32Possible values:
>= 1
Frequency of the schedule based on schedule frequency type eg. for Hours, value 2 is 2 hours, for Minutes, 30 is 30 minutes, for Daily, 2 is 2 days. for Monthly 2 is it repeats every 2 months
weeklyDays string[]Possible values: [
SUNDAY
,MONDAY
,TUESDAY
,WEDNESDAY
,THURSDAY
,FRIDAY
,SATURDAY
]Days of the week for weekly frequency
dayOfMonth int32Possible values:
>= 1
and<= 31
Day on which to run the schedule, applicable for monthly, yearly
weekOfMonth stringPossible values: [
FIRST
,SECOND
,THIRD
,FOURTH
,LAST
]Specific week of a month
dayOfWeek stringPossible values: [
SUNDAY
,MONDAY
,TUESDAY
,WEDNESDAY
,THURSDAY
,FRIDAY
,SATURDAY
,DAY
,WEEKDAY
,WEEKEND_DAYS
]monthOfYear stringPossible values: [
JANUARY
,FEBRUARY
,MARCH
,APRIL
,MAY
,JUNE
,JULY
,AUGUST
,SEPTEMBER
,OCTOBER
,NOVEMBER
,DECEMBER
]repeatIntervalInMinutes int32Possible values:
>= 1
How often in minutes in a day the schedule runs, applicable for daily, weekly, monthly and yearly frequency types.
repeatUntilTime int32Until what time to repeat the schedule in a day, requires repeatIntervalInMinutes
timezone object
id int32name stringstartTime int32Default value:
75600
start time of schedule in seconds
startDate int32start date of schedule in epoch format
endDate int32Schedule end date in epoch format
noOfTimes int32The number of times you want the schedule to run.
exceptions object[]
Exceptions to when a schedule should not run, either in dates or week of month and days
onDates int32[]Possible values:
>= 1
and<= 31
list of dates in a month. For ex: 1, 20
onWeekOfTheMonth string[]Possible values: [
FIRST
,SECOND
,THIRD
,FOURTH
,LAST
]On which week of month, for ex: FIRST, LAST
onDayOfTheWeek string[]Possible values: [
SUNDAY
,MONDAY
,TUESDAY
,WEDNESDAY
,THURSDAY
,FRIDAY
,SATURDAY
,DAY
,WEEKDAY
,WEEKEND_DAYS
]On which days, for ex: MONDAY, FRIDAY
daysBetweenSyntheticFulls int32Possible values:
>= 6
No of days between two synthetic full jobs
maxBackupIntervalInMins int32Default value:
240
The number of mins to force a backup on automatic schedule.
scheduleOption object
Specific options to be set on schedules
useDiskCacheForLogBackups booleanUsed to enable disk caching feature on databases for automatic schedules on server plan
commitFrequencyInHours int32Commit frequency in hours for disk cache backups from automatic schedules
daysBetweenAutoConvert int32Number of days between auto conversion of backup level applicable for databases on incremental and differential schedules of server plan
o365ItemSelectionOption stringPossible values: [
SELECT_ALL
,SELECT_NEVER_PROCESSED
,SELECT_MEETING_SLA
,SELECT_NOT_MEETING_SLA_PROCESSED_ATLEAST_ONCE
,SELECT_FAILED_LAST_ATTEMPT
,SELECT_PROCESSED_ATLEAST_ONCE
,SELECT_NOT_MEETING_SLA
,SELECT_MEETING_SLA_NOT_RECENTLY_BACKED_UP
]item backup option for O365 V2 backup jobs
jobRunningTimeInMins int32total job running time in minutes
esxServerMappings object[]
The list of all ESX server mappings
sourceServer stringThe name of source ESX server
destinationServer stringThe name of destination ESX server
networkSettings object[]
The list of all source network interface to destination network interface mapping
source stringSource network name
sourceId stringSource network ID
destination stringDestination network name
replicationPairs object[]
List of all replication pairs that are part of the failover group
id int32The ID of the replication pair
sourceName stringThe name of the source 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
reset booleanOn set to true, resets the script to empty
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
reset booleanOn set to true, resets the script to empty
arrayReplicationPairs object[]
List of all array replication pairs for failover group
id int32The ID of the array replication pair
sourceName stringThe name of the source 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 host name to be applied for the destination VM.
hostname stringThe hostname specified for the destination machine
{
"id": 0,
"name": "string",
"sourceHypervisor": {
"id": 0,
"name": "string",
"type": "CLIENT_GROUP",
"vendor": "NONE"
},
"destinationHypervisor": {
"id": 0,
"name": "string",
"type": "CLIENT_GROUP",
"vendor": "NONE"
},
"source": "ARRAY_REPLICATION_TEST_FAILOVER",
"isApprovalRequired": true,
"usersToNotify": [
{
"id": 0,
"name": "string",
"displayName": "string",
"company": {
"id": 0,
"name": "string"
}
}
],
"operationType": "LIVE_MOUNT",
"subclient": {
"id": 0,
"name": "string"
},
"storagePolicy": {
"id": 0,
"name": "string"
},
"copy": {
"id": 0,
"name": "string"
},
"priorityIntervalInMinutes": 0,
"continueDROnFailure": true,
"recoveryTarget": {
"id": 0,
"name": "string"
},
"automaticFailover": {
"machines": [
{
"id": 0,
"name": "string"
}
],
"monitoringStatus": "DISABLED",
"outageDelayTimeInMinutes": 0,
"status": "OFFLINE"
},
"plannedFailoverSchedules": [
{
"scheduleId": 0,
"scheduleName": "string",
"policyId": 0,
"scheduleOperation": "MODIFY",
"vmOperationType": "PLANNED_FAILOVER",
"backupType": "FULL",
"forDatabasesOnly": false,
"schedulePattern": {
"scheduleFrequencyType": "MINUTES",
"frequency": 0,
"weeklyDays": [
"SUNDAY"
],
"dayOfMonth": 0,
"weekOfMonth": "FIRST",
"dayOfWeek": "SUNDAY",
"monthOfYear": "JANUARY",
"repeatIntervalInMinutes": 0,
"repeatUntilTime": 0,
"timezone": {
"id": 0,
"name": "string"
},
"startTime": 75600,
"startDate": 0,
"endDate": 0,
"noOfTimes": 0,
"exceptions": [
{
"onDates": [
0
],
"onWeekOfTheMonth": [
"FIRST"
],
"onDayOfTheWeek": [
"SUNDAY"
]
}
],
"daysBetweenSyntheticFulls": 0,
"maxBackupIntervalInMins": 240
},
"scheduleOption": {
"useDiskCacheForLogBackups": true,
"commitFrequencyInHours": 0,
"daysBetweenAutoConvert": 0,
"o365ItemSelectionOption": "SELECT_ALL",
"jobRunningTimeInMins": 0
}
}
],
"testBootSchedules": [
{
"scheduleId": 0,
"scheduleName": "string",
"policyId": 0,
"scheduleOperation": "MODIFY",
"vmOperationType": "PLANNED_FAILOVER",
"backupType": "FULL",
"forDatabasesOnly": false,
"schedulePattern": {
"scheduleFrequencyType": "MINUTES",
"frequency": 0,
"weeklyDays": [
"SUNDAY"
],
"dayOfMonth": 0,
"weekOfMonth": "FIRST",
"dayOfWeek": "SUNDAY",
"monthOfYear": "JANUARY",
"repeatIntervalInMinutes": 0,
"repeatUntilTime": 0,
"timezone": {
"id": 0,
"name": "string"
},
"startTime": 75600,
"startDate": 0,
"endDate": 0,
"noOfTimes": 0,
"exceptions": [
{
"onDates": [
0
],
"onWeekOfTheMonth": [
"FIRST"
],
"onDayOfTheWeek": [
"SUNDAY"
]
}
],
"daysBetweenSyntheticFulls": 0,
"maxBackupIntervalInMins": 240
},
"scheduleOption": {
"useDiskCacheForLogBackups": true,
"commitFrequencyInHours": 0,
"daysBetweenAutoConvert": 0,
"o365ItemSelectionOption": "SELECT_ALL",
"jobRunningTimeInMins": 0
}
}
],
"esxServerMappings": [
{
"sourceServer": "string",
"destinationServer": "string",
"networkSettings": [
{
"source": "string",
"sourceId": "string",
"destination": "string"
}
]
}
],
"replicationPairs": [
{
"id": 0,
"sourceName": "string",
"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"
}
},
"reset": true
},
"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"
}
},
"reset": true
}
}
],
"arrayReplicationPairs": [
{
"id": 0,
"sourceName": "string",
"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"
}
],
"hostname": "string"
}
]
}
Not Found
- application/json
- Schema
- Example (from schema)
Schema
- errorMessage string
- errorCode int32
{
"errorMessage": "string",
"errorCode": 0
}
Service Unavailable
- application/json
- Schema
- Example (from schema)
Schema
- errorMessage string
- errorCode int32
{
"errorMessage": "string",
"errorCode": 0
}