About this Resource

Defines the Link Monitor Managed Object

REST API Methods for this Resource

Resource Schema

Configuration

Parameter Name Required Service Affecting Data Type Default Value Possible Values Description
GWDescriptionNoNostringnone64 - Max Length Assign an operator-friendly gateway description text configured by the operator for future reference.
HostTypeYesNoEnum0Possible values:
  • 0 - eHost
  • 1 - eGateway
Specifies whether the peer is a Host or Gateway that is being monitored.
MonitorTypeYesNoEnum1Possible values:
  • 0 - eIPSEC_CAC
  • 1 - eBackupRoute
Specifies whether this entry supports IPSEC and/or CAC or backup default route.
HostIpAddressYesNostringnone255 - Max Length Specifies the IP address or FQDN of the destination to be monitored. If HostType is eHost, this value could be an IP Address or an FQDN. If HostType is eGateway, this value is an IP Address of the gateway. If this host/gateway is reachable, it indicates that the WAN link is healthy.
TimeProbePeriodYesNoint10Possible values:
  • 5 - Minimum
  • 60 - Maximum
Specifies the poll frequency time in seconds, for testing the link status. The host or the nexthop gateway specified by HostIpAddress is probed for every TimeProbePeriod specified.
PollToDownState YesNoint3Possible values:
  • 2 - Minimum
  • 10 - Maximum
Specifies the number of failure attempts, to the probe in reaching the gateway, after which the gateway is declared to be in DOWN state. When the gateway is declared DOWN, the sequence of actions ("DownAction_x") are performed. Probes are continued to detect if the gateway becomes reachable again.
PollToServiceReadyStateYesNoint3Possible values:
  • 2 - Minimum
  • 10 - Maximum
Specifies the number of success polls, from REACHABLE state for which the system must stay in the REACHABLE state, before being declared to be ready for service (i.e. for calls, data etc).
IdIPsec_1NoYesint0 Specifies the IPsec tunnel ID to be activated when this gateway is in use. The tunnel is terminated when this gateway is not in use.
IdIPsec_2NoYesint0 Specifies the IPsec tunnel ID to be activated when this gateway is in use. The tunnel is terminated when this gateway is not is use.
IdIPsec_3NoYesint0 Specifies the IPsec tunnel ID to be activated when this gateway is in use. The tunnel is terminated when this gateway is not in use.
IdIPsec_4NoYesint0 Specifies the IPsec tunnel ID to be activated when this gateway is in use. The tunnel is terminated when this gateway is not in use.
CACProfileIDNoNoint0 Specifies the CAC profile ID associated with this gateway. For Host the CACProfileID is 0.

Runtime

Parameter Name Description Data Type Possible Values
rt_HostIpAddress Specifies the IP address of the host or gateway . string
rt_ServiceState Indicates the state of the link monitoring the host or gateway. EnumPossible values:
  • 0 - GW_OPER_DOWN
  • 1 - GW_OPER_REACHABLE
  • 2 - GW_OPER_READY
  • 3 - GW_OPER_DEGRADED
  • 4 - GW_OPER_INITIALIZING
rt_InUse Indicates if the current gateway is used as the default gateway. EnumPossible values:
  • 0 - GW_USE_STATUS_NA
  • 1 - GW_USE_STATUS_IN_USE
  • 2 - GW_USE_STATUS_NOT_USE