/api/v1/appliance
Set Synchronization Configuration
Sets configuration for proxy settings synchronization.
Not available in (Undefined variable: ALVariables.AWS) Auto Scaling appliances.
URL
/api/v1/appliance
HTTP Method
POST
POST Parameters
Parameter |
Required |
Type |
Description |
Acceptable Values |
---|---|---|---|---|
mode |
false |
string |
Specifies the synchronization mode. Defaults to "learn" |
"teach" |
password |
true |
string |
Specifies whether to enable health checking. |
alphanumeric, space, dash, slash, underscore, period and parentheses. |
peer |
false |
string containing IP address, or array of strings containing IP addresses |
Specifies the IP address(es) of the peer(s) to sync with. Required when protocol is set to "unicast". Parameter is ignored for "multicast". |
"<ip address>" |
protocol |
true |
string |
Specifies the transmission protocol. Only "unicast" is supported in AWS or Azure. |
"unicast" |
status |
false |
string containing integer |
Specifies whether proxy settings synchronization is enabled. Defaults to "0". |
"0" → Disabled |
sync_style |
true |
string |
Specifies the what to sync among the cluster. If set to "full" and appliance is configured for multiple SSL proxies, the Listen IP of each proxy must be set to "*" (All Inbound). |
"full" |
interface |
false |
array of strings containing integers |
Enables synchronization on the specified interface if provided. Parameter not usable if a different interface is already configured for synchronization. |
Name of interface (list of interfaces can be obtained with Get Interfaces) |
Response Parameters
Returns a string indicating success/error.
Example: Configure appliance sync config as a unicast learner with a single peer
Request
curl -kv
-u api_ninja:ninja_password
-X POST
-H 'Content-Type: text/json'
--data-binary @setsync.json
https://172.31.1.172:4849/api/v1/appliance
POST Parameters
{ "mode": "learn", "password": "ninja_password", "peer": "1.2.3.4", "protocol": "unicast", "status": "1", "sync_style": "full" }
Response
{"result":"success"}
Example: Configure appliance sync settings as a multicast teacher
Request
/api/v1/website
curl -kv
-u api_ninja:ninja_password
-X POST
-H 'Content-Type: text/json'
--data-binary @setsync.json
https://172.31.1.172:4849/api/v1/appliance
POST Parameters
{ "mode": "teach", "password": "ninja_password", "protocol": "multicast", "status": "1", "sync_style": "full" }
Response
{"result":"success"}
Example: Configure appliance sync settings as a unicast teacher with multiple peers, and also enable synchronization on eth1
Request
/api/v1/appliance
curl -kv
-u api_ninja:ninja_password
-X POST
-H 'Content-Type: text/json'
--data-binary @setsync.json
https://172.31.1.172:4849/api/v1/appliance
POST Parameters
{ "mode": "teach", "password": "ninja_password", "peer": [ "4.3.2.1", "5.4.3.2" ], "protocol": "unicast", "status": "1", "sync_style": "template", "interface": "eth1" }
Response
{"result":"success"}