Update Uplink Selection Settings For An MX Network
PUT {{baseUrl}}/networks/:networkId/appliance/trafficShaping/uplinkSelection
Update uplink selection settings for an MX network #### Body Parameters Parameter|Type|Description :-------------: |:-------------: |:-------------: activeActiveAutoVpnEnabled| boolean| Toggle for enabling or disabling active-active AutoVPN defaultUplink| string| The default uplink. Must be one of: 'wan1' or 'wan2' loadBalancingEnabled| boolean| Toggle for enabling or disabling load balancing wanTrafficUplinkPreferences| array| Array of uplink preference rules for WAN traffic vpnTrafficUplinkPreferences| array| Array of uplink preference rules for VPN traffic
Supports Action Batches
Resource | Operation |
---|---|
/networks/{networkId}/appliance/trafficShaping/uplinkSelection | update |
Request Body
{"activeActiveAutoVpnEnabled"=>"<boolean>", "defaultUplink"=>"<string>", "loadBalancingEnabled"=>"<boolean>", "wanTrafficUplinkPreferences"=>[{"trafficFilters"=>[{"type"=>"<string>", "value"=>{"source"=>{"port"=>"<string>", "cidr"=>"<string>", "vlan"=>"<integer>", "host"=>"<integer>"}, "destination"=>{"port"=>"<string>", "cidr"=>"<string>"}, "protocol"=>"<string>"}}, {"type"=>"<string>", "value"=>{"source"=>{"port"=>"<string>", "cidr"=>"<string>", "vlan"=>"<integer>", "host"=>"<integer>"}, "destination"=>{"port"=>"<string>", "cidr"=>"<string>"}, "protocol"=>"<string>"}}], "preferredUplink"=>"<string>"}, {"trafficFilters"=>[{"type"=>"<string>", "value"=>{"source"=>{"port"=>"<string>", "cidr"=>"<string>", "vlan"=>"<integer>", "host"=>"<integer>"}, "destination"=>{"port"=>"<string>", "cidr"=>"<string>"}, "protocol"=>"<string>"}}, {"type"=>"<string>", "value"=>{"source"=>{"port"=>"<string>", "cidr"=>"<string>", "vlan"=>"<integer>", "host"=>"<integer>"}, "destination"=>{"port"=>"<string>", "cidr"=>"<string>"}, "protocol"=>"<string>"}}], "preferredUplink"=>"<string>"}], "vpnTrafficUplinkPreferences"=>[{"trafficFilters"=>[{"type"=>"<string>", "value"=>{"id"=>"<string>", "protocol"=>"<string>", "source"=>{"port"=>"<string>", "cidr"=>"<string>", "network"=>"<string>", "vlan"=>"<integer>", "host"=>"<integer>"}, "destination"=>{"port"=>"<string>", "cidr"=>"<string>", "network"=>"<string>", "vlan"=>"<integer>", "host"=>"<integer>", "fqdn"=>"<string>"}}}, {"type"=>"<string>", "value"=>{"id"=>"<string>", "protocol"=>"<string>", "source"=>{"port"=>"<string>", "cidr"=>"<string>", "network"=>"<string>", "vlan"=>"<integer>", "host"=>"<integer>"}, "destination"=>{"port"=>"<string>", "cidr"=>"<string>", "network"=>"<string>", "vlan"=>"<integer>", "host"=>"<integer>", "fqdn"=>"<string>"}}}], "preferredUplink"=>"<string>", "failOverCriterion"=>"<string>", "performanceClass"=>{"type"=>"<string>", "builtinPerformanceClassName"=>"<string>", "customPerformanceClassId"=>"<string>"}}, {"trafficFilters"=>[{"type"=>"<string>", "value"=>{"id"=>"<string>", "protocol"=>"<string>", "source"=>{"port"=>"<string>", "cidr"=>"<string>", "network"=>"<string>", "vlan"=>"<integer>", "host"=>"<integer>"}, "destination"=>{"port"=>"<string>", "cidr"=>"<string>", "network"=>"<string>", "vlan"=>"<integer>", "host"=>"<integer>", "fqdn"=>"<string>"}}}, {"type"=>"<string>", "value"=>{"id"=>"<string>", "protocol"=>"<string>", "source"=>{"port"=>"<string>", "cidr"=>"<string>", "network"=>"<string>", "vlan"=>"<integer>", "host"=>"<integer>"}, "destination"=>{"port"=>"<string>", "cidr"=>"<string>", "network"=>"<string>", "vlan"=>"<integer>", "host"=>"<integer>", "fqdn"=>"<string>"}}}], "preferredUplink"=>"<string>", "failOverCriterion"=>"<string>", "performanceClass"=>{"type"=>"<string>", "builtinPerformanceClassName"=>"<string>", "customPerformanceClassId"=>"<string>"}}]}
HEADERS
Key | Datatype | Required | Description |
---|---|---|---|
X-Cisco-Meraki-API-Key | null | ||
Content-Type | string |
RESPONSES
status: OK
{"activeActiveAutoVpnEnabled":true,"defaultUplink":"wan1","loadBalancingEnabled":true,"wanTrafficUplinkPreferences":[{"trafficFilters":[{"type":"custom","value":{"protocol":"tcp","source":{"port":"any","cidr":"192.168.1.0/24"},"destination":{"port":"any","cidr":"any"}}}],"preferredUplink":"wan2"},{"trafficFilters":[{"type":"custom","value":{"protocol":"tcp","source":{"port":"1-1024","vlan":10,"host":254},"destination":{"port":"any","cidr":"any"}}}],"preferredUplink":"wan1"}],"vpnTrafficUplinkPreferences":[{"trafficFilters":[{"type":"applicationCategory","value":{"id":"meraki:layer7/category/1"}},{"type":"application","value":{"id":"meraki:layer7/application/33"}},{"type":"custom","value":{"protocol":"tcp","source":{"port":"any","cidr":"192.168.1.0/24"},"destination":{"port":"any","cidr":"any"}}},{"type":"custom","value":{"protocol":"tcp","source":{"port":"any","cidr":"any"},"destination":{"port":"any","network":"L_23456789","vlan":20,"host":200}}},{"type":"custom","value":{"protocol":"tcp","source":{"port":"any","cidr":"any"},"destination":{"port":"1-1024","fqdn":"www.google.com"}}}],"preferredUplink":"wan2","failOverCriterion":"poorPerformance","performanceClass":{"type":"custom","customPerformanceClassId":"123456"}},{"trafficFilters":[{"type":"application","value":{"id":"meraki:layer7/application/9"}}],"preferredUplink":"defaultUplink"},{"trafficFilters":[{"type":"application","value":{"id":"meraki:layer7/application/106"}}],"preferredUplink":"bestForVoIP"},{"trafficFilters":[{"type":"application","value":{"id":"meraki:layer7/application/107"}}],"preferredUplink":"loadBalancing","performanceClass":{"type":"builtin","builtinPerformanceClassName":"VoIP"}},{"trafficFilters":[{"type":"application","value":{"id":"meraki:layer7/application/162"}}],"preferredUplink":"loadBalancing","performanceClass":{"type":"custom","customPerformanceClassId":"123456"}},{"trafficFilters":[{"type":"application","value":{"id":"meraki:layer7/application/168"}}],"preferredUplink":"wan2","failOverCriterion":"poorPerformance","performanceClass":{"type":"builtin","builtinPerformanceClassName":"VoIP"}},{"trafficFilters":[{"type":"application","value":{"id":"meraki:layer7/application/171"}}],"preferredUplink":"wan2","failOverCriterion":"poorPerformance","performanceClass":{"type":"custom","customPerformanceClassId":"123456"}}]}