Save Zscaler IP SLA rule destination configuration

post

http://127.0.0.1:8080/thirdPartyServices/zscaler/ipslaRuleDestination

Creates or updates the IP SLA rule destination configuration for Zscaler integration. The destination addresses are validated (cannot be empty), trimmed of whitespace, and split/rejoined to ensure clean formatting. Empty segments in comma-separated lists are removed. This action is logged in system actions with the current user and configuration details.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

IP SLA rule destination configuration. The destination field is required and cannot be empty. Multiple destinations can be comma-separated and will be trimmed automatically.

Zscaler-specific IP SLA rule destination configuration. Extends base IpslaRuleDestination with Zscaler orchestration settings.

sourceInterface

string

Source interface label for IP SLA probes. Identifies which WAN interface sends monitoring traffic.

type

string

enum

Defaults to ip-monitor

Monitor type. Defaults to 'ip-monitor' (ICMP). Use 'http-monitor' for HTTP-based checks.

Allowed:

destination

string

required

Required. Comma-separated destination IP addresses or hostnames for probe targets. Whitespace is trimmed automatically.

proxyAddress

string

Proxy server address for HTTP monitoring. Only used when type is 'http-monitor'.

proxyPort

integer

1 to 65535

Proxy server port. Required when proxyAddress is set. Range: 1-65535.

userAgent

string

HTTP User-Agent header for HTTP monitoring requests. Only used when type is 'http-monitor'.

httpTimeout

integer

≥ 1

HTTP request timeout in seconds. Only used when type is 'http-monitor'. Must be positive.

keepAliveInterval

integer

≥ 1

Defaults to 1

Probe frequency in seconds. Controls how often connectivity checks are performed.

upThreshold

integer

≥ 1

Defaults to 3

Consecutive successful probes required to mark tunnel UP. Higher values provide stability.

downThreshold

integer

≥ 1

Defaults to 30

Consecutive failed probes required to mark tunnel DOWN. Higher values prevent false positives.

interval

integer

≥ 1

Defaults to 30

Time interval in seconds between IP SLA rule evaluations.

samplingWindow

integer

≥ 1

Rolling window size in seconds for calculating loss and latency metrics.

upLoss

integer

0 to 100

Packet loss percentage threshold for UP state. Tunnel is UP when loss is below this value.

downLoss

integer

0 to 100

Packet loss percentage threshold for DOWN state. Tunnel is DOWN when loss exceeds this value.

upLatency

integer

≥ 0

Latency threshold in milliseconds for UP state. Tunnel is UP when latency is below this value.

downLatency

integer

≥ 0

Latency threshold in milliseconds for DOWN state. Tunnel is DOWN when latency exceeds this value.

metricCombination

string

enum

Logic for combining loss and latency metrics. 'Loss OR Latency' triggers on either; 'Loss AND Latency' requires both.

Allowed:

routeLabelId

integer

Defaults to 0

Route label ID for traffic steering. Value 0 means default routing (no specific label).

enableIpslaRuleOrchestration

boolean

Defaults to false

Enable automatic IP SLA rule deployment to appliances. When true, rules are pushed to associated appliances automatically.

Responses

204

Successfully saved the IP SLA rule destination configuration. The action is logged to system actions.

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

400Bad request - validation failed. Occurs when destination field is null, empty, or contains only whitespace.

500Internal server error occurred while saving the configuration. Typically caused by database or I/O issues.