openapi: 3.1.0
info:
contact:
email: tmunzer@juniper.net
name: Thomas Munzer
description: '> Version: **2604.1.1**
>
> Date: **May 13, 2026**
NOTE:
Some important API changes will be introduced. Please make sure to read the
announcements
---
## Additional Documentation
* [Mist Automation Guide](https://www.juniper.net/documentation/us/en/software/mist/automation-integration/index.html)
* [Mist Location SDK](https://www.juniper.net/documentation/us/en/software/mist/location-services/topics/concept/mist-how-get-mist-sdk.html)
* [Mist Product Updates](https://www.juniper.net/documentation/us/en/software/mist/product-updates/)
## Helpful Resources
* [API Sandbox and Exercises](https://api-class.mist.com/)
* [Postman Collection, Runners and Webhook Samples](https://www.postman.com/juniper-mist/workspace/mist-systems-s-public-workspace)
* [Python Script Examples](https://github.com/tmunzer/mist_library)
* [API Demo Apps](https://apps.mist-lab.fr/)
* [Juniper Blog](https://blogs.juniper.net/)
## Mist Web Browser Extension:
* Google Chrome, Microsoft Edge and other Chromium-based browser: [Chrome Web Store](https://chromewebstore.google.com/detail/mist-extension/ejhpdcljeamillfhdihkkmoakanpbplh)
* Firefox: [Firefox Add-ons](https://addons.mozilla.org/en-US/firefox/addon/mist-extension/)
---'
license:
name: MIT
url: https://raw.githubusercontent.com/tmunzer/Mist-OAS3.0/main/LICENSE
title: Mist Admins Sites Gateway Templates API
version: 2604.1.1
x-logo:
altText: Juniper-MistAI
backgroundColor: '#FFFFFF'
url: https://www.mist.com/wp-content/uploads/logo.png
servers:
- description: Mist Global 01
url: https://api.mist.com
- description: Mist Global 02
url: https://api.gc1.mist.com
- description: Mist Global 03
url: https://api.ac2.mist.com
- description: Mist Global 04
url: https://api.gc2.mist.com
- description: Mist Global 05
url: https://api.gc4.mist.com
- description: Mist EMEA 01
url: https://api.eu.mist.com
- description: Mist EMEA 02
url: https://api.gc3.mist.com
- description: Mist EMEA 03
url: https://api.ac6.mist.com
- description: Mist EMEA 04
url: https://api.gc6.mist.com
- description: Mist APAC 01
url: https://api.ac5.mist.com
- description: Mist APAC 02
url: https://api.gc5.mist.com
- description: Mist APAC 03
url: https://api.gc7.mist.com
security:
- apiToken: []
- basicAuth: []
- basicAuth: []
csrfToken: []
tags:
- description: The API Endpoints for the Gateway Templates at the site level can be used to get the site derived networks, meaning the org level configuration with the site variables resolved..
name: Sites Gateway Templates
paths:
/api/v1/sites/{site_id}/gatewaytemplates/derived:
parameters:
- $ref: '#/components/parameters/site_id'
get:
description: Get the list of derived Gateway Templates a Site
operationId: listSiteGatewayTemplatesDerived
parameters:
- description: Whether resolve the site variables
in: query
name: resolve
schema:
type: boolean
responses:
'200':
$ref: '#/components/responses/GatewaytemplatesArray'
'400':
$ref: '#/components/responses/HTTP400'
'401':
$ref: '#/components/responses/HTTP401'
'403':
$ref: '#/components/responses/HTTP403'
'404':
$ref: '#/components/responses/HTTP404'
'429':
$ref: '#/components/responses/HTTP429'
summary: listSiteGatewayTemplatesDerived
tags:
- Sites Gateway Templates
components:
schemas:
protect_re_custom_protocol:
default: any
description: 'enum: `any`, `icmp`, `tcp`, `udp`'
enum:
- any
- icmp
- tcp
- udp
type: string
gw_routing_policy_term_matching_protocol:
items:
$ref: '#/components/schemas/gw_routing_policy_term_matching_protocol_enum'
type: array
gateway_port_reth_nodes:
description: SSR only - supporting vlan-based redundancy (matching the size of `networks`)
examples:
- - node0
- node1
items:
type: string
type: array
tunnel_config_ipsec_proposal:
additionalProperties: false
properties:
auth_algo:
$ref: '#/components/schemas/tunnel_config_auth_algo'
dh_group:
$ref: '#/components/schemas/tunnel_config_dh_group'
enc_algo:
$ref: '#/components/schemas/tunnel_config_enc_algo'
type: object
tunnel_config_node_internal_ips:
description: Only if `provider`==`zscaler-gre`, `provider`==`jse-ipsec`, `provider`==`custom-ipsec` or `provider`==`custom-gre`
items:
type: string
type: array
service_policy_ewf_rule_profile:
default: strict
description: 'enum: `critical`, `standard`, `strict`'
enum:
- critical
- standard
- strict
type: string
day_of_week:
description: 'enum: `any`, `fri`, `mon`, `sat`, `sun`, `thu`, `tue`, `wed`'
enum:
- any
- fri
- mon
- sat
- sun
- thu
- tue
- wed
type: string
strings:
items:
type: string
type: array
uniqueItems: true
gateway_port_wan_arp_policer:
default: default
description: 'Only when `wan_type`==`broadband`. enum: `default`, `max`, `recommended`'
enum:
- default
- max
- recommended
type: string
gateway_oob_ip_config:
additionalProperties: false
description: Out-of-band (vme/em0/fxp0) IP config
properties:
gateway:
description: If `type`==`static`
type: string
ip:
description: If `type`==`static`
type: string
netmask:
description: If `type`==`static`
type: string
node1:
$ref: '#/components/schemas/gateway_oob_ip_config_node1'
type:
$ref: '#/components/schemas/ip_type'
use_mgmt_vrf:
default: false
description: If supported on the platform. If enabled, DNS will be using this routing-instance, too
type: boolean
use_mgmt_vrf_for_host_out:
default: false
description: For host-out traffic (NTP/TACPLUS/RADIUS/SYSLOG/SNMP), if alternative source network/ip is desired
type: boolean
vlan_id:
$ref: '#/components/schemas/gateway_port_vlan_id_with_variable'
type: object
service_policy_skyatp_dns_dga_detection_profile:
description: 'enum: `default`, `standard`, `strict`'
enum:
- default
- standard
- strict
type: string
gateway_port_config:
additionalProperties: false
description: Gateway port config
properties:
ae_disable_lacp:
default: false
description: If `aggregated`==`true`. To disable LCP support for the AE interface
type: boolean
ae_idx:
description: If `aggregated`==`true`. Users could force to use the designated AE name (must be an integer between 0 and 127)
type:
- string
- 'null'
ae_lacp_force_up:
default: false
description: 'For SRX only, if `aggregated`==`true`.Sets the state of the interface as UP when the peer has limited LACP capability. Use case: When a device connected to this AE port is ZTPing for the first time, it will not have LACP configured on the other end. **Note:** Turning this on will enable force-up on one of the interfaces in the bundle only'
type: boolean
aggregated:
default: false
type: boolean
critical:
default: false
description: To generate port up/down alarm, set it to true
type: boolean
description:
description: Interface Description. Can be a variable (i.e. "{{myvar}}")
type: string
disable_autoneg:
default: false
type: boolean
disabled:
default: false
description: Port admin up (true) / down (false)
type: boolean
dsl_type:
$ref: '#/components/schemas/gateway_port_dsl_type'
dsl_vci:
default: 35
description: If `wan_type`==`dsl`, 16 bit int
type: integer
dsl_vpi:
default: 0
description: If `wan_type`==`dsl`, 8 bit int
type: integer
duplex:
$ref: '#/components/schemas/gateway_port_duplex'
ip_config:
$ref: '#/components/schemas/gateway_port_config_ip_config'
lte_apn:
description: If `wan_type`==`lte`
type: string
lte_auth:
$ref: '#/components/schemas/gateway_port_lte_auth'
lte_backup:
type: boolean
lte_password:
description: If `wan_type`==`lte`
type: string
lte_username:
description: If `wan_type`==`lte`
type: string
mtu:
type: integer
name:
description: Name that we'll use to derive config
type: string
networks:
$ref: '#/components/schemas/gateway_port_networks'
outer_vlan_id:
description: For Q-in-Q
type: integer
poe_disabled:
default: false
type: boolean
poe_keep_state_when_reboot:
default: false
description: Whether Perpetual PoE capabilities are enabled for a port
type: boolean
port_network:
description: Only for SRX and if `usage`==`lan`, the name of the Network to be used as the Untagged VLAN
type: string
preserve_dscp:
default: true
description: Whether to preserve dscp when sending traffic over VPN (SSR-only)
type: boolean
redundant:
description: If HA mode
type: boolean
redundant_group:
description: If HA mode, SRX Only - support redundancy-group. 1-128 for physical SRX, 1-64 for virtual SRX
maximum: 128
minimum: 1
type: integer
reth_idx:
$ref: '#/components/schemas/gateway_port_config_reth_idx'
reth_node:
description: If HA mode
type: string
reth_nodes:
$ref: '#/components/schemas/gateway_port_reth_nodes'
speed:
default: auto
examples:
- 1g
type: string
ssr_no_virtual_mac:
default: false
description: When SSR is running as VM, this is required on certain hosting platforms
type: boolean
svr_port_range:
default: none
description: For SSR only
examples:
- 60000-60005
type: string
traffic_shaping:
$ref: '#/components/schemas/gateway_traffic_shaping'
usage:
$ref: '#/components/schemas/gateway_port_usage'
vlan_id:
$ref: '#/components/schemas/gateway_port_vlan_id_with_variable'
vpn_paths:
$ref: '#/components/schemas/gateway_port_vpn_paths'
wan_arp_policer:
$ref: '#/components/schemas/gateway_port_wan_arp_policer'
wan_ext_ip:
description: Only if `usage`==`wan`, optional. If spoke should reach this port by a different IP
examples:
- 64.2.4.3
type: string
wan_ext_ip6:
description: Only if `usage`==`wan`, optional. If spoke should reach this port by a different IPv6
examples:
- 2601:1700:43c0:dc0::10
type: string
wan_extra_routes:
additionalProperties:
$ref: '#/components/schemas/wan_extra_routes'
description: Only if `usage`==`wan`. Property Key is the destination CIDR (e.g. "100.100.100.0/24")
type: object
wan_extra_routes6:
additionalProperties:
$ref: '#/components/schemas/wan_extra_routes6'
description: Only if `usage`==`wan`. Property Key is the destination CIDR (e.g. "2a02:1234:420a:10c9::/64")
type: object
wan_networks:
$ref: '#/components/schemas/gateway_port_config_wan_networks'
wan_probe_override:
$ref: '#/components/schemas/gateway_wan_probe_override'
wan_source_nat:
$ref: '#/components/schemas/gateway_port_wan_source_nat'
wan_speedtest_mode:
$ref: '#/components/schemas/gateway_port_config_wan_speedtest_mode'
wan_type:
$ref: '#/components/schemas/gateway_port_wan_type'
required:
- usage
type: object
service_policy:
additionalProperties: false
properties:
action:
$ref: '#/components/schemas/allow_deny'
antivirus:
$ref: '#/components/schemas/service_policy_antivirus'
appqoe:
$ref: '#/components/schemas/service_policy_appqoe'
ewf:
$ref: '#/components/schemas/service_policy_ewf'
idp:
$ref: '#/components/schemas/idp_config'
local_routing:
description: access within the same VRF
type: boolean
name:
type: string
path_preference:
description: By default, we derive all paths available and use them. Optionally, you can customize by using `path_preference`
type: string
secintel:
$ref: '#/components/schemas/service_policy_secintel'
servicepolicy_id:
description: Used to link servicepolicy defined at org level and overwrite some attributes
format: uuid
type: string
services:
$ref: '#/components/schemas/strings'
skyatp:
$ref: '#/components/schemas/service_policy_skyatp'
ssl_proxy:
$ref: '#/components/schemas/service_policy_ssl_proxy'
syslog:
$ref: '#/components/schemas/service_policy_syslog'
tenants:
$ref: '#/components/schemas/strings'
type: object
routing_policy_term_matching_community:
items:
examples:
- '3900062'
type: string
type: array
network_internal_access:
additionalProperties: false
properties:
enabled:
type: boolean
type: object
app_probing_apps:
description: APp-keys from [List Applications](/#operations/listApplications)
examples:
- - facebook
items:
type: string
type: array
tunnel_config_node:
additionalProperties: false
description: Only if `provider`==`zscaler-ipsec`, `provider`==`jse-ipsec` or `provider`==`custom-ipsec`
properties:
hosts:
$ref: '#/components/schemas/tunnel_config_node_hosts'
internal_ips:
$ref: '#/components/schemas/tunnel_config_node_internal_ips'
probe_ips:
$ref: '#/components/schemas/strings'
remote_ids:
$ref: '#/components/schemas/tunnel_config_node_remote_ids'
wan_names:
$ref: '#/components/schemas/tunnel_config_node_wan_names'
required:
- hosts
- wan_names
type: object
app_probing_custom_app:
additionalProperties: false
properties:
address:
description: Required if `protocol`==`icmp`
examples:
- 192.168.1.1
type: string
app_type:
type: string
hostnames:
$ref: '#/components/schemas/app_probing_custom_app_hostname'
key:
type: string
name:
examples:
- pos_app
type: string
network:
examples:
- lan
type: string
packetSize:
description: If `protocol`==`icmp`
maximum: 65400
minimum: 0
type: integer
protocol:
$ref: '#/components/schemas/app_probing_custom_app_protocol'
url:
description: If `protocol`==`http`
examples:
- www.abc.com
type: string
vrf:
examples:
- lan
type: string
type: object
tunnel_config_dh_group:
default: '14'
description: "Only if `provider`==`custom-ipsec`. enum:\n * 1\n * 2 (1024-bit)\n * 5\n * 14 (default, 2048-bit)\n * 15 (3072-bit)\n * 16 (4096-bit)\n * 19 (256-bit ECP)\n * 20 (384-bit ECP)\n * 21 (521-bit ECP)\n * 24 (2048-bit ECP)"
enum:
- '1'
- '14'
- '15'
- '16'
- '19'
- '2'
- '20'
- '21'
- '24'
- '5'
type: string
gateway_mgmt_probe_hosts:
examples:
- - 8.8.8.8
format: ipv4
items:
type: string
type: array
gateway_port_vpn_path:
additionalProperties: false
properties:
bfd_profile:
$ref: '#/components/schemas/gateway_port_vpn_path_bfd_profile'
bfd_use_tunnel_mode:
default: false
description: Only if the VPN `type`==`hub_spoke`. Whether to use tunnel mode. SSR only
type: boolean
preference:
description: Only if the VPN `type`==`hub_spoke`. For a given VPN, when `path_selection.strategy`==`simple`, the preference for a path (lower is preferred)
type: integer
role:
$ref: '#/components/schemas/gateway_port_vpn_path_role'
traffic_shaping:
$ref: '#/components/schemas/gateway_traffic_shaping'
type: object
tunnel_config_node_remote_ids:
description: Only if `provider`==`jse-ipsec` or `provider`==`custom-ipsec`
items:
type: string
type: array
network_internet_access:
additionalProperties: false
description: Whether this network has direct internet access
properties:
create_simple_service_policy:
default: false
type: boolean
destination_nat:
$ref: '#/components/schemas/network_internet_access_destination_nat'
enabled:
type: boolean
restricted:
default: false
description: By default, all access is allowed, to only allow certain traffic, make `restricted`=`true` and define service_policies
type: boolean
static_nat:
$ref: '#/components/schemas/network_internet_access_static_nat'
type: object
gateway_wan_probe_override_probe_profile:
default: broadband
description: 'enum: `broadband`, `lte`'
enum:
- broadband
- lte
type: string
gw_routing_policy_term:
additionalProperties: false
properties:
actions:
$ref: '#/components/schemas/gw_routing_policy_term_action'
matching:
$ref: '#/components/schemas/gw_routing_policy_term_matching'
type: object
gateway_extra_route6:
additionalProperties: false
properties:
via:
format: ipv6
type: string
type: object
gateway_ip_config_dns_suffix:
description: Except for out-of_band interface (vme/em0/fxp0)
items:
type: string
type: array
service_policy_secintel_profile:
default: default
description: 'enum: `default`, `standard`, `strict`'
enum:
- default
- standard
- strict
type: string
tunnel_config_node_hosts:
items:
description: IP Address of the remote host
type: string
type: array
tunnel_config_local_subnets:
description: List of Local protected subnet for policy-based IPSec negotiation
items:
type: string
type: array
gateway_port_usage:
description: 'port usage name. enum: `ha_control`, `ha_data`, `lan`, `wan`'
enum:
- ha_control
- ha_data
- lan
- wan
type: string
gateway_mgmt_auto_signature_update:
additionalProperties: false
properties:
day_of_week:
$ref: '#/components/schemas/day_of_week'
enable:
default: true
type: boolean
time_of_day:
description: Optional, Mist will decide the timing
type: string
type: object
dhcpd_config_fixed_bindings:
additionalProperties:
$ref: '#/components/schemas/dhcpd_config_fixed_binding'
description: If `type`==`local` or `type6`==`local`. Property key is the MAC Address. Format is `[0-9a-f]{12}` (e.g. "5684dae9ac8b")
examples:
- 5684dae9ac8b:
ip: 192.168.70.35
name: John
type: object
tunnel_config:
additionalProperties: false
properties:
auto_provision:
$ref: '#/components/schemas/tunnel_config_auto_provision'
ike_lifetime:
description: Only if `provider`==`custom-ipsec`
type: integer
ike_mode:
$ref: '#/components/schemas/tunnel_config_ike_mode'
ike_proposals:
$ref: '#/components/schemas/tunnel_config_ike_proposals'
ipsec_lifetime:
description: If `provider`==`custom-ipsec`
type: integer
ipsec_proposals:
$ref: '#/components/schemas/tunnel_config_ipsec_proposals'
local_id:
description: Required if `provider`==`zscaler-ipsec`, `provider`==`jse-ipsec` or `provider`==`custom-ipsec`
type: string
local_subnets:
$ref: '#/components/schemas/tunnel_config_local_subnets'
mode:
$ref: '#/components/schemas/tunnel_config_tunnel_mode'
networks:
$ref: '#/components/schemas/tunnel_config_networks'
primary:
$ref: '#/components/schemas/tunnel_config_node'
probe:
$ref: '#/components/schemas/tunnel_config_probe'
protocol:
$ref: '#/components/schemas/tunnel_config_protocol'
provider:
$ref: '#/components/schemas/tunnel_config_provider'
psk:
description: Required if `provider`==`zscaler-ipsec`, `provider`==`jse-ipsec` or `provider`==`custom-ipsec`
type: string
remote_subnets:
$ref: '#/components/schemas/tunnel_config_remote_subnets'
secondary:
$ref: '#/components/schemas/tunnel_config_node'
version:
$ref: '#/components/schemas/tunnel_config_version'
type: object
dhcpd_config_type:
default: local
description: 'enum: `local` (DHCP Server), `none`, `relay` (DHCP Relay)'
enum:
- local
- none
- relay
type: string
tunnel_provider_options_prisma:
additionalProperties: false
properties:
service_account_name:
description: For prisma-ipsec, service account name to used for tunnel auto provisioning
examples:
- sa1@1823425211
type: string
type: object
gw_routing_policy_term_action:
additionalProperties: false
description: When used as import policy
properties:
accept:
type: boolean
add_community:
$ref: '#/components/schemas/gw_routing_policy_term_action_add_community'
add_target_vrfs:
$ref: '#/components/schemas/gw_routing_policy_term_action_add_target_vrfs'
community:
$ref: '#/components/schemas/routing_policy_term_action_community'
exclude_as_path:
$ref: '#/components/schemas/gw_routing_policy_term_action_exclude_as_path'
exclude_community:
$ref: '#/components/schemas/gw_routing_policy_term_action_exclude_community'
export_communities:
$ref: '#/components/schemas/gw_routing_policy_term_action_export_communities'
local_preference:
$ref: '#/components/schemas/routing_policy_local_preference'
prepend_as_path:
$ref: '#/components/schemas/routing_policy_term_action_prepend_as_path'
type: object
protect_re_custom_subnet:
items:
examples:
- 10.1.2.0/24
type: string
type: array
app_probing_custom_app_protocol:
default: http
description: 'enum: `http`, `icmp`'
enum:
- http
- icmp
type: string
service_policies:
items:
$ref: '#/components/schemas/service_policy'
type: array
gateway_path_preferences_paths:
items:
$ref: '#/components/schemas/gateway_path_preferences_path'
type: array
gw_routing_policy_terms:
description: zero or more criteria/filter can be specified to match the term, all criteria have to be met
items:
$ref: '#/components/schemas/gw_routing_policy_term'
type: array
uniqueItems: true
tunnel_config_tunnel_mode:
default: active-standby
description: 'Required if `provider`==`zscaler-gre`, `provider`==`jse-ipsec`. enum: `active-active`, `active-standby`'
enum:
- active-active
- active-standby
type: string
gateway_port_dsl_type:
default: vdsl
description: 'if `wan_type`==`dsl`. enum: `adsl`, `vdsl`'
enum:
- adsl
- vdsl
type: string
service_policy_skyatp_dns_tunnel_detection:
additionalProperties: false
properties:
enabled:
type: boolean
profile:
$ref: '#/components/schemas/service_policy_skyatp_dns_tunnel_detection_profile'
type: object
routing_policy_local_preference:
anyOf:
- type: string
- maximum: 4294967295
minimum: 1
type: integer
description: Optional, for an import policy, local_preference can be changed, value in range 1-4294967294. Can be a Variable (e.g. `{{bgp_as}}`)
network_internet_access_destination_nat_property:
additionalProperties: false
properties:
internal_ip:
description: The Destination NAT destination IP Address. Must be an IP (i.e. "192.168.70.30") or a Variable (i.e. "{{myvar}}")
examples:
- 192.168.70.30
type: string
name:
examples:
- web server
type: string
port:
description: The Destination NAT destination IP Address. Must be a Port (i.e. "443") or a Variable (i.e. "{{myvar}}")
examples:
- '443'
type: string
wan_name:
description: SRX Only. If not set, we configure the nat policies against all WAN ports for simplicity
examples:
- wan0
type: string
type: object
gateway_ip_configs:
additionalProperties:
$ref: '#/components/schemas/gateway_ip_config_property'
description: Property key is the network name
type: object
gateway_path_type:
description: 'enum: `local`, `tunnel`, `vpn`, `wan`'
enum:
- local
- tunnel
- vpn
- wan
type: string
gateway_port_config_ip_config:
additionalProperties: false
description: Junos IP Config
properties:
dns:
$ref: '#/components/schemas/gateway_ip_config_dns_servers'
dns_suffix:
$ref: '#/components/schemas/gateway_ip_config_dns_suffix'
gateway:
description: Except for out-of_band interface (vme/em0/fxp0). Interface Default Gateway IP Address (i.e. "192.168.1.1") or a Variable (i.e. "{{myvar}}")
examples:
- 192.168.1.1
type: string
gateway6:
description: Except for out-of_band interface (vme/em0/fxp0). Interface Default Gateway IPv6 Address (i.e. "2001:db8::1") or a Variable (i.e. "{{myvar}}")
examples:
- 2001:db8::1
type: string
ip:
description: Interface IP Address (i.e. "192.168.1.8") or a Variable (i.e. "{{myvar}}")
examples:
- 192.168.1.8
format: ipv4
type: string
ip6:
description: Interface IPv6 Address (i.e. "2001:db8::123") or a Variable (i.e. "{{myvar}}")
examples:
- 2001:db8::123
format: ipv6
type: string
netmask:
description: Used only if `subnet` is not specified in `networks`. Interface Netmask (i.e. "/24") or a Variable (i.e. "{{myvar}}")
examples:
- /24
type: string
netmask6:
description: Used only if `subnet` is not specified in `networks`. Interface IPv6 Netmask (i.e. "/64") or a Variable (i.e. "{{myvar}}")
examples:
- /64
type: string
network:
description: Optional, the network to be used for mgmt
type: string
poser_password:
description: If `type`==`pppoe`
type: string
pppoe_auth:
$ref: '#/components/schemas/gateway_wan_ppoe_auth'
pppoe_username:
description: If `type`==`pppoe`
type: string
type:
$ref: '#/components/schemas/gateway_wan_type'
type6:
$ref: '#/components/schemas/gateway_wan_type6'
type: object
gateway_wan_probe_override:
additionalProperties: false
description: Only if `usage`==`wan`
properties:
ip6s:
$ref: '#/components/schemas/strings'
ips:
$ref: '#/components/schemas/strings'
probe_profile:
$ref: '#/components/schemas/gateway_wan_probe_override_probe_profile'
type: object
tunnel_config_remote_subnets:
description: List of Remote protected subnet for policy-based IPSec negotiation
items:
type: string
type: array
gateway_templates:
items:
$ref: '#/components/schemas/gateway_template'
type: array
app_probing_custom_app_hostname:
description: If `protocol`==`http`
examples:
- - https://www.abc.com
items:
type: string
type: array
network_vpn_access_config_other_vrfs:
description: By default, the routes are only readvertised toward the same vrf on spoke. To allow it to be leaked to other vrfs
items:
examples:
- iot
type: string
type: array
service_policy_antivirus:
additionalProperties: false
description: For SRX-only
properties:
avprofile_id:
description: org-level AV Profile can be used, this takes precedence over 'profile'
format: uuid
type: string
enabled:
default: false
type: boolean
profile:
description: Default / noftp / httponly / or keys from av_profiles
type: string
type: object
gateway_port_lte_auth:
default: none
description: 'if `wan_type`==`lte`. enum: `chap`, `none`, `pap`'
enum:
- chap
- none
- pap
type: string
gw_routing_policy_term_action_add_community:
items:
examples:
- '3900190'
type: string
type: array
tunnel_provider_options_zscaler_sub_location:
additionalProperties: false
properties:
aup_block_internet_until_accepted:
default: false
type: boolean
aup_enabled:
default: false
description: Can only be `true` when `auth_required`==`false`, display Acceptable Use Policy (AUP)
type: boolean
aup_force_ssl_inspection:
default: false
description: Proxy HTTPs traffic, requiring Zscaler cert to be installed in browser
type: boolean
aup_timeout_in_days:
description: Required if `aup_enabled`==`true`. Days before AUP is requested again
maximum: 180
minimum: 1
type: integer
auth_required:
default: false
description: Enable this option to authenticate users
type: boolean
caution_enabled:
default: false
description: Can only be `true` when `auth_required`==`false`, display caution notification for non-authenticated users
type: boolean
dn_bandwidth:
description: Download bandwidth cap of the link, in Mbps. Disabled if not set
examples:
- 200
format: double
maximum: 99999
minimum: 0.1
type:
- number
- 'null'
idle_time_in_minutes:
description: Required if `surrogate_IP`==`true`, idle Time to Disassociation
maximum: 43200
minimum: 0
type: integer
name:
description: '[network]($h/Orgs%20Networks/_overview) name'
type: string
ofw_enabled:
default: false
description: If `true`, enable the firewall control option
type: boolean
surrogate_IP:
default: false
description: Can only be `true` when `auth_required`==`true`. Map a user to a private IP address so it applies the user's policies, instead of the location's policies
type: boolean
surrogate_IP_enforced_for_known_browsers:
description: Can only be `true` when `surrogate_IP`==`true`, enforce surrogate IP for known browsers
type: boolean
surrogate_refresh_time_in_minutes:
description: Required if `surrogate_IP_enforced_for_known_browsers`==`true`, must be lower or equal than `idle_time_in_minutes`, refresh Time for re-validation of Surrogacy
maximum: 43200
minimum: 1
type: integer
up_bandwidth:
description: Download bandwidth cap of the link, in Mbps. Disabled if not set
examples:
- 200
format: double
maximum: 99999
minimum: 0.1
type:
- number
- 'null'
type: object
gateway_port_vlan_id_with_variable:
description: If WAN interface is on a VLAN. Can be the VLAN ID (i.e. "10") or a Variable (i.e. "{{myvar}}")
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
wan_extra_routes6:
additionalProperties: false
properties:
via:
format: ipv6
type: string
type: object
routing_policy_term_matching_as_path:
items:
$ref: '#/components/schemas/bgp_as'
type: array
routing_policy_term_action_prepend_as_path:
description: When used as export policy, optional. By default, the local AS will be prepended, to change it. Can be a Variable (e.g. `{{as_path}}`)
items:
examples:
- 65000 400
type: string
type: array
tunnel_config_auto_provision_provider:
description: 'enum: `jse-ipsec`, `zscaler-ipsec`'
enum:
- jse-ipsec
- zscaler-ipsec
type: string
tunnel_provider_options:
additionalProperties: false
properties:
jse:
$ref: '#/components/schemas/tunnel_provider_options_jse'
prisma:
$ref: '#/components/schemas/tunnel_provider_options_prisma'
zscaler:
$ref: '#/components/schemas/tunnel_provider_options_zscaler'
type: object
gateway_mgmt_probe_hostsv6:
examples:
- - 2001:4860:4860::8888
format: ipv6
items:
type: string
type: array
response_http401:
additionalProperties: false
properties:
detail:
examples:
- Authentication credentials were not provided.
type: string
type: object
network_internet_access_static_nat:
additionalProperties:
$ref: '#/components/schemas/network_internet_access_static_nat_property'
description: Property key may be an External IP Address (i.e. "63.16.0.3"), a CIDR (i.e. "63.16.0.12/20") or a Variable (i.e. "{{myvar}}")
type: object
additional_config_cmds:
description: 'additional CLI commands to append to the generated Junos config. **Note**: no check is done'
items:
description: JUNOS "set" command to add to the generated configuration
examples:
- set snmp community public
type: string
type: array
gateway_ip_config_property:
additionalProperties: false
properties:
ip:
format: ipv4
type: string
ip6:
format: ipv6
type: string
netmask:
examples:
- /24
type: string
netmask6:
examples:
- 2001:db8:abcd:12::1
type: string
secondary_ips:
$ref: '#/components/schemas/gateway_ip_config_property_second_ips'
type:
$ref: '#/components/schemas/ip_type'
type6:
$ref: '#/components/schemas/ip_type6'
type: object
gateway_mgmt_admin_sshkeys:
description: For SSR only, as direct root access is not allowed
examples:
- - ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAA...Wxa6p6UW0ZbcP john@host
items:
type: string
type: array
gateway_port_config_wan_speedtest_mode:
default: auto
description: 'Controls whether Marvis/scheduler can run speedtest on this port. enum: `auto`, `enabled`, `disabled`'
enum:
- auto
- enabled
- disabled
examples:
- auto
type: string
gateway_path_strategy:
default: ordered
description: 'enum: `ecmp`, `ordered`, `weighted`'
enum:
- ecmp
- ordered
- weighted
type: string
idp_profile:
properties:
base_profile:
$ref: '#/components/schemas/idp_profile_base_profile'
created_time:
$ref: '#/components/schemas/created_time'
id:
$ref: '#/components/schemas/id'
modified_time:
$ref: '#/components/schemas/modified_time'
name:
examples:
- relaxed
type: string
org_id:
$ref: '#/components/schemas/org_id'
overwrites:
$ref: '#/components/schemas/idp_profile_overwrites'
type: object
gateway_wan_ppoe_auth:
default: none
description: 'if `type`==`pppoe`. enum: `chap`, `none`, `pap`'
enum:
- chap
- none
- pap
type: string
idp_config:
additionalProperties: false
properties:
alert_only:
type: boolean
enabled:
default: false
type: boolean
idpprofile_id:
description: org_level IDP Profile can be used, this takes precedence over `profile`
examples:
- 89b9d208-84a4-fa8f-af57-78f92c639cf2
format: uuid
type: string
profile:
default: strict
description: 'enum: `Custom`, `strict` (default), `standard` or keys from idp_profiles'
type: string
type: object
network_source_nat:
additionalProperties: false
description: If `routed`==`false` (usually at Spoke), but some hosts needs to be reachable from Hub
properties:
external_ip:
examples:
- 172.16.0.8/30
type: string
type: object
network_tenant_addresses:
items:
description: The user/tenant IP Address (i.e. "192.168.70.30"), an Subnet (i.e. "192.168.70.0/24") or a Variable (i.e. "{{myvar}}")
examples:
- 192.168.70.30
type: string
type: array
tunnel_config_auth_algo:
description: 'enum: `md5`, `sha1`, `sha2`'
enum:
- md5
- sha1
- sha2
type: string
gateway_traffic_shaping:
additionalProperties: false
properties:
class_percentages:
$ref: '#/components/schemas/gateway_traffic_shaping_class_percentages'
enabled:
default: false
type: boolean
max_tx_kbps:
description: Interface Transmit Cap in kbps
type: integer
type: object
gateway_template_type:
default: standalone
description: 'enum: `spoke`, `standalone`'
enum:
- spoke
- standalone
examples:
- standalone
type: string
gateway_ip_config_property_second_ips:
description: Optional list of secondary IPs in CIDR format
examples:
- - 192.168.50.1/24
- 192.168.60.1/26
items:
type: string
type: array
app_probing:
additionalProperties: false
properties:
apps:
$ref: '#/components/schemas/app_probing_apps'
custom_apps:
$ref: '#/components/schemas/app_probing_custom_apps'
enabled:
type: boolean
type: object
zscaler_sub_locations:
description: '`sub-locations` can be used for specific uses cases to define different configuration based on the user network'
items:
$ref: '#/components/schemas/tunnel_provider_options_zscaler_sub_location'
type: array
tunnel_config_auto_provision_node_wan_names:
description: Optional, only needed if `vars_only`==`false`
items:
examples:
- wan0
type: string
type: array
network_vpn_access_static_nat_property:
additionalProperties: false
properties:
internal_ip:
description: The Static NAT destination IP Address. Must be an IP Address (i.e. "192.168.70.3") or a Variable (i.e. "{{myvar}}")
examples:
- 192.168.70.3
type: string
name:
examples:
- pos_station-1
type: string
type: object
dns_suffix:
description: Global dns settings. To keep compatibility, dns settings in `ip_config` and `oob_ip_config` will overwrite this setting
items:
type: string
type: array
tunnel_config_ike_mode:
default: main
description: 'Only if `provider`==`custom-ipsec`. enum: `aggressive`, `main`'
enum:
- aggressive
- main
type: string
tunnel_config_auto_provision_node:
properties:
probe_ips:
$ref: '#/components/schemas/strings'
wan_names:
$ref: '#/components/schemas/tunnel_config_auto_provision_node_wan_names'
dns_servers:
description: Global dns settings. To keep compatibility, dns settings in `ip_config` and `oob_ip_config` will overwrite this setting
items:
type: string
type: array
gateway_template:
description: Gateway Template is applied to a site for gateway(s) in a site.
properties:
additional_config_cmds:
$ref: '#/components/schemas/additional_config_cmds'
bgp_config:
additionalProperties:
$ref: '#/components/schemas/bgp_config'
type: object
created_time:
$ref: '#/components/schemas/created_time'
dhcpd_config:
$ref: '#/components/schemas/dhcpd_config'
dnsOverride:
default: false
type: boolean
dns_servers:
$ref: '#/components/schemas/dns_servers'
dns_suffix:
$ref: '#/components/schemas/dns_suffix'
extra_routes:
$ref: '#/components/schemas/gateway_extra_routes'
extra_routes6:
$ref: '#/components/schemas/gateway_extra_routes6'
gateway_matching:
$ref: '#/components/schemas/gateway_matching'
gateway_mgmt:
$ref: '#/components/schemas/gateway_mgmt'
id:
$ref: '#/components/schemas/id'
idp_profiles:
$ref: '#/components/schemas/gateway_idp_profiles'
ip_configs:
$ref: '#/components/schemas/gateway_ip_configs'
modified_time:
$ref: '#/components/schemas/modified_time'
name:
examples:
- gw_template
type: string
networks:
$ref: '#/components/schemas/networks'
ntpOverride:
default: false
type: boolean
ntp_servers:
$ref: '#/components/schemas/ntp_servers'
oob_ip_config:
$ref: '#/components/schemas/gateway_oob_ip_config'
org_id:
$ref: '#/components/schemas/org_id'
path_preferences:
additionalProperties:
$ref: '#/components/schemas/gateway_path_preferences'
description: Property key is the path name
type: object
port_config:
additionalProperties:
$ref: '#/components/schemas/gateway_port_config'
description: Property key is the Port Name (i.e. "ge-0/0/0"), the Ports Range (i.e. "ge-0/0/0-10"), the List of Ports (i.e. "ge-0/0/0,ge-1/0/0", only allowed for Aggregated or Redundant interfaces) or a Variable (i.e. "{{myvar}}").
type: object
router_id:
description: Auto assigned if not set
examples:
- 10.2.1.10
type: string
routing_policies:
$ref: '#/components/schemas/gw_routing_policies'
service_policies:
$ref: '#/components/schemas/service_policies'
tunnel_configs:
additionalProperties:
$ref: '#/components/schemas/tunnel_config'
description: Property key is the tunnel name
type: object
tunnel_provider_options:
$ref: '#/components/schemas/tunnel_provider_options'
type:
$ref: '#/components/schemas/gateway_template_type'
url_filtering_deny_msg:
default: Access to this URL Category has been blocked
description: When a service policy denies a app_category, what message to show in user's browser
examples:
- Access to this URL Category has been blocked
type: string
vrf_config:
$ref: '#/components/schemas/vrf_config'
vrf_instances:
$ref: '#/components/schemas/gateway_vrf_instances'
required:
- name
type: object
tunnel_config_auto_provision_lat_lng:
additionalProperties: false
description: API override for POP selection
properties:
lat:
examples:
- 37.295833
format: double
type: number
lng:
examples:
- -122.032946
format: double
type: number
required:
- lat
- lng
type: object
network_vpn_access_config:
additionalProperties: false
properties:
advertised_subnet:
description: If `routed`==`true`, whether to advertise an aggregated subnet toward HUB this is useful when there are multiple networks on SPOKE's side
examples:
- 172.16.0.0/24
type: string
allow_ping:
description: Whether to allow ping from vpn into this routed network
type: boolean
destination_nat:
$ref: '#/components/schemas/network_vpn_access_destination_nat'
nat_pool:
description: If `routed`==`false` (usually at Spoke), but some hosts needs to be reachable from Hub, a subnet is required to create and advertise the route to Hub
examples:
- 172.16.0.0/26
type: string
no_readvertise_to_lan_bgp:
default: false
description: toward LAN-side BGP peers
type: boolean
no_readvertise_to_lan_ospf:
default: false
description: toward LAN-side OSPF peers
type: boolean
no_readvertise_to_overlay:
description: toward overlay, how HUB should deal with routes it received from Spokes
type: boolean
other_vrfs:
$ref: '#/components/schemas/network_vpn_access_config_other_vrfs'
routed:
description: Whether this network is routable
type: boolean
source_nat:
$ref: '#/components/schemas/network_source_nat'
static_nat:
$ref: '#/components/schemas/network_vpn_access_static_nat'
summarized_subnet:
description: toward overlay, how HUB should deal with routes it received from Spokes
examples:
- 172.16.0.0/16
type: string
summarized_subnet_to_lan_bgp:
description: toward LAN-side BGP peers
examples:
- 172.16.0.0/16
type: string
summarized_subnet_to_lan_ospf:
description: toward LAN-side OSPF peers
examples:
- 172.16.0.0/16
type: string
type: object
idp_profile_overwrites:
items:
$ref: '#/components/schemas/idp_profile_overwrite'
type: array
network_vpn_access:
additionalProperties:
$ref: '#/components/schemas/network_vpn_access_config'
description: Property key is the VPN name. Whether this network can be accessed from vpn
type: object
network_routed_for_networks:
description: For a Network (usually LAN), it can be routable to other networks (e.g. OSPF)
items:
examples:
- pos
type: string
type: array
network_vpn_access_destination_nat:
additionalProperties:
$ref: '#/components/schemas/network_vpn_access_destination_nat_property'
description: Property key can be an External IP (i.e. "63.16.0.3"), an External IP:Port (i.e. "63.16.0.3:443"), an External Port (i.e. ":443"), an External CIDR (i.e. "63.16.0.0/30"), an External CIDR:Port (i.e. "63.16.0.0/30:443") or a Variable (i.e. "{{myvar}}"). At least one of the `internal_ip` or `port` must be defined
type: object
vlan_id_with_variable:
oneOf:
- type: string
- maximum: 4094
minimum: 1
type: integer
dhcpd_config_type6:
default: none
description: 'enum: `local` (DHCP Server), `none`, `relay` (DHCP Relay)'
enum:
- local
- none
- relay
type: string
allow_deny:
description: 'enum: `allow`, `deny`'
enum:
- allow
- deny
type: string
dhcpd_config_property:
additionalProperties: false
properties:
dns_servers:
$ref: '#/components/schemas/dhcpd_config_dns_servers'
dns_suffix:
$ref: '#/components/schemas/dhcpd_config_dns_suffix'
fixed_bindings:
$ref: '#/components/schemas/dhcpd_config_fixed_bindings'
gateway:
description: If `type`==`local` - optional, `ip` will be used if not provided
examples:
- 192.168.70.1
type: string
ip6_end:
description: If `type6`==`local`
examples:
- 2607:f8b0:4005:808::ff
type: string
ip6_start:
description: If `type6`==`local`
examples:
- 2607:f8b0:4005:808::2
type: string
ip_end:
description: If `type`==`local`
examples:
- 192.168.70.200
type: string
ip_start:
description: If `type`==`local`
examples:
- 192.168.70.100
type: string
lease_time:
default: 86400
description: In seconds, lease time has to be between 3600 [1hr] - 604800 [1 week], default is 86400 [1 day]
maximum: 604800
minimum: 3600
type: integer
options:
$ref: '#/components/schemas/dhcpd_config_options'
server_id_override:
default: false
description: "`server_id_override`==`true` means the device, when acts as DHCP relay and forwards DHCP responses from DHCP server to clients, \nshould overwrite the Sever Identifier option (i.e. DHCP option 54) in DHCP responses with its own IP address."
type: boolean
servers:
$ref: '#/components/schemas/dhcpd_config_servers'
serversv6:
$ref: '#/components/schemas/dhcpd_config_servers6'
type:
$ref: '#/components/schemas/dhcpd_config_type'
type6:
$ref: '#/components/schemas/dhcpd_config_type6'
vendor_encapsulated:
$ref: '#/components/schemas/dhcpd_config_vendor_options'
type: object
idp_profile_overwrite:
additionalProperties: false
properties:
action:
$ref: '#/components/schemas/idp_profile_action'
matching:
$ref: '#/components/schemas/idp_profile_matching'
name:
type: string
type: object
tunnel_config_auto_provision:
additionalProperties: false
description: Auto Provisioning configuration for the tunne. This takes precedence over the `primary` and `secondary` nodes.
properties:
enabled:
description: Enable auto provisioning for the tunnel. If enabled, the `primary` and `secondary` nodes will be ignored.
type: boolean
latlng:
$ref: '#/components/schemas/tunnel_config_auto_provision_lat_lng'
primary:
$ref: '#/components/schemas/tunnel_config_auto_provision_node'
provider:
$ref: '#/components/schemas/tunnel_config_auto_provision_provider'
region:
description: API override for POP selection in the case user wants to override the auto discovery of remote network location and force the tunnel to use the specified peer location.
type: string
secondary:
$ref: '#/components/schemas/tunnel_config_auto_provision_node'
service_connection:
description: if `provider`==`prisma-ipsec`. By default, we'll use the location of the site to determine the optimal Remote Network location, optionally, service_connection can be considered, then we'll also consider this along with the site location. Define service_connection if the traffic is to be routed to a specific service connection. This field takes a service connection name that is configured in the Prisma cloud, Prisma Access Setup -> Service Connections.
examples:
- Juniper-Lab-SC-1
type: string
required:
- provider
type: object
service_policy_syslog:
additionalProperties: false
description: Required for syslog logging
properties:
enabled:
default: false
type: boolean
server_names:
examples:
- - dc_syslog_server
items:
type: string
type: array
type: object
tunnel_config_probe_type:
default: icmp
description: 'enum: `http`, `icmp`'
enum:
- http
- icmp
type: string
gateway_path_preferences_path_networks:
description: Required when `type`==`local`
items:
type: string
type: array
ssl_proxy_ciphers_category:
default: strong
description: 'enum: `medium`, `strong`, `weak`'
enum:
- medium
- strong
- weak
type: string
gateway_extra_routes6:
additionalProperties:
$ref: '#/components/schemas/gateway_extra_route6'
description: Property key is the destination CIDR (e.g. "2a02:1234:420a:10c9::/64"), the destination Network name or a variable (e.g. "{{myvar}}")
examples:
- 2a02:1234:420a:10c9::/64:
via: 2a02:1234:200a::100
type: object
idp_profile_matching_attack_name:
items:
examples:
- HTTP:INVALID:HDR-FIELD
type: string
type: array
dhcpd_config_dns_servers:
description: If `type`==`local` or `type6`==`local` - optional, if not defined, system one will be used
examples:
- - 8.8.8.8
- 4.4.4.4
- 2001:4860:4860::8888
items:
type: string
type: array
dhcpd_config_servers:
description: If `type`==`relay`
examples:
- - 11.2.3.4
items:
type: string
type: array
gateway_matching:
additionalProperties: false
description: Gateway matching
properties:
enable:
type: boolean
rules:
$ref: '#/components/schemas/gateway_matching_rules'
type: object
network_multicast:
additionalProperties: false
description: Whether to enable multicast support (only PIM-sparse mode is supported)
properties:
disable_igmp:
default: false
description: If the network will only be the source of the multicast traffic, IGMP can be disabled
type: boolean
enabled:
default: false
type: boolean
groups:
$ref: '#/components/schemas/network_multicast_groups'
type: object
service_policy_skyatp_http_inspection_profile:
description: 'enum: `standard`, `strict`'
enum:
- standard
- strict
type: string
gw_routing_policy_term_action_export_communities:
description: When used as export policy, optional
items:
type: string
type: array
gateway_port_vpn_path_role:
default: spoke
description: 'If the VPN `type`==`hub_spoke`, enum: `hub`, `spoke`. If the VPN `type`==`mesh`, enum: `mesh`'
enum:
- hub
- mesh
- spoke
type: string
protect_re_allowed_service:
description: 'enum: `icmp`, `ssh`'
enum:
- icmp
- ssh
type: string
app_probing_custom_apps:
items:
$ref: '#/components/schemas/app_probing_custom_app'
type: array
gw_routing_policy_term_matching_route_exists:
additionalProperties: false
properties:
route:
examples:
- 192.168.0.0/24
type: string
vrf_name:
default: default
description: Name of the vrf instance, it can also be the name of the VPN or wan if they
type: string
type: object
gateway_extra_route:
additionalProperties: false
properties:
via:
format: ipv4
type: string
type: object
created_time:
description: When the object has been created, in epoch
format: double
readOnly: true
type: number
tunnel_provider_options_jse:
additionalProperties: false
description: For jse-ipsec, this allows provisioning of adequate resource on JSE. Make sure adequate licenses are added
properties:
num_users:
examples:
- 5
type: integer
org_name:
description: JSE Organization name. The list of available organizations can be retrieved with the [Get Org JSE Info](/#operations/getOrgJseInfo) API Call
examples:
- JSE_ORG1
type: string
type: object
network_vpn_access_destination_nat_property:
additionalProperties: false
properties:
internal_ip:
description: The Destination NAT destination IP Address. Must be an IP (i.e. "192.168.70.30") or a Variable (i.e. "{{myvar}}")
examples:
- 192.168.70.30
type: string
name:
examples:
- web server
type: string
port:
examples:
- '443'
type: string
type: object
dhcpd_config_dns_suffix:
description: If `type`==`local` or `type6`==`local` - optional, if not defined, system one will be used
examples:
- - .mist.local
- .mist.com
items:
type: string
type: array
service_policy_ewf:
items:
$ref: '#/components/schemas/service_policy_ewf_rule'
type: array
gateway_port_duplex:
default: auto
description: 'enum: `auto`, `full`, `half`'
enum:
- auto
- full
- half
examples:
- full
type: string
gateway_vrf_instance:
additionalProperties: false
examples:
- networks:
- CORP_NET
- MGMT_NET
properties:
networks:
$ref: '#/components/schemas/strings'
type: object
protect_re_allowed_services:
description: Optionally, services we'll allow
examples:
- - icmp
- ssh
items:
$ref: '#/components/schemas/protect_re_allowed_service'
type: array
gateway_oob_ip_config_node1:
additionalProperties: false
description: For HA Cluster, node1 can have different IP Config
properties:
gateway:
description: If `type`==`static`
type: string
ip:
type: string
netmask:
description: Used only if `subnet` is not specified in `networks`
type: string
type:
$ref: '#/components/schemas/ip_type'
use_mgmt_vrf:
default: false
description: If supported on the platform. If enabled, DNS will be using this routing-instance, too
type: boolean
use_mgmt_vrf_for_host_out:
default: false
description: Whether to use `mgmt_junos` for host-out traffic (NTP/TACPLUS/RADIUS/SYSLOG/SNMP), if alternative source network/ip is desired
type: boolean
vlan_id:
$ref: '#/components/schemas/gateway_port_vlan_id_with_variable'
type: object
dhcpd_config_servers6:
description: If `type6`==`relay`
examples:
- - 2607:f8b0:4005:808::64
items:
type: string
type: array
network_tenant:
additionalProperties: false
properties:
addresses:
$ref: '#/components/schemas/network_tenant_addresses'
type: object
gw_routing_policy_term_matching_vpn_path_sla:
additionalProperties: false
properties:
max_jitter:
type:
- integer
- 'null'
max_latency:
examples:
- 1500
type:
- integer
- 'null'
max_loss:
examples:
- 30
type:
- integer
- 'null'
type: object
tunnel_config_protocol:
description: 'Only if `provider`==`custom-ipsec`. enum: `gre`, `ipsec`'
enum:
- gre
- ipsec
type: string
gateway_path_preferences_path_target_ips:
description: If `type`==`local`, if destination IP is to be replaced
items:
type: string
type: array
service_policy_skyatp:
additionalProperties: false
description: SRX only
properties:
dns_dga_detection:
$ref: '#/components/schemas/service_policy_skyatp_dns_dga_detection'
dns_tunnel_detection:
$ref: '#/components/schemas/service_policy_skyatp_dns_tunnel_detection'
http_inspection:
$ref: '#/components/schemas/service_policy_skyatp_http_inspection'
iot_device_policy:
$ref: '#/components/schemas/service_policy_skyatp_iot_device_policy'
type: object
dhcpd_config_option_type:
description: 'enum: `boolean`, `hex`, `int16`, `int32`, `ip`, `string`, `uint16`, `uint32`'
enum:
- boolean
- hex
- int16
- int32
- ip
- string
- uint16
- uint32
type: string
tunnel_via:
default: primary
description: 'If `via`==`tunnel`, specifies which tunnel (primary/secondary) this neighbor is associated with. enum: `primary`, `secondary`'
enum:
- primary
- secondary
type: string
tunnel_config_ike_proposals:
description: If `provider`==`custom-ipsec`
items:
$ref: '#/components/schemas/tunnel_config_ike_proposal'
type: array
vrf_config:
additionalProperties: false
properties:
enabled:
description: Whether to enable VRF (when supported on the device)
type: boolean
type: object
tunnel_config_node_wan_names:
items:
type: string
type: array
gw_routing_policy_term_matching:
additionalProperties: false
description: zero or more criteria/filter can be specified to match the term, all criteria have to be met
properties:
as_path:
$ref: '#/components/schemas/routing_policy_term_matching_as_path'
community:
$ref: '#/components/schemas/routing_policy_term_matching_community'
network:
$ref: '#/components/schemas/strings'
prefix:
$ref: '#/components/schemas/routing_policy_term_matching_prefix'
protocol:
$ref: '#/components/schemas/gw_routing_policy_term_matching_protocol'
route_exists:
$ref: '#/components/schemas/gw_routing_policy_term_matching_route_exists'
vpn_neighbor_mac:
$ref: '#/components/schemas/gw_routing_policy_term_matching_vpn_neighbor_mac'
vpn_path:
$ref: '#/components/schemas/gw_routing_policy_term_matching_vpn_path'
vpn_path_sla:
$ref: '#/components/schemas/gw_routing_policy_term_matching_vpn_path_sla'
type: object
bgp_as:
anyOf:
- type: string
- maximum: 4294967294
minimum: 1
type: integer
description: BGP AS, value in range 1-4294967294. Can be a Variable (e.g. `{{bgp_as}}` )
examples:
- 65000
protect_re_custom:
additionalProperties: false
description: Custom acls
properties:
port_range:
default: '0'
description: Matched dst port, "0" means any
examples:
- 80,1035-1040
type: string
protocol:
$ref: '#/components/schemas/protect_re_custom_protocol'
subnets:
$ref: '#/components/schemas/protect_re_custom_subnet'
type: object
gw_routing_policy:
additionalProperties: false
properties:
terms:
$ref: '#/components/schemas/gw_routing_policy_terms'
type: object
service_policy_ssl_proxy:
additionalProperties: false
description: For SRX-only
properties:
ciphers_category:
$ref: '#/components/schemas/ssl_proxy_ciphers_category'
enabled:
default: false
type: boolean
type: object
service_policy_skyatp_http_inspection:
additionalProperties: false
properties:
enabled:
type: boolean
profile:
$ref: '#/components/schemas/service_policy_skyatp_http_inspection_profile'
type: object
gateway_port_vpn_path_bfd_profile:
default: broadband
description: 'Only if the VPN `type`==`hub_spoke`. enum: `broadband`, `lte`'
enum:
- broadband
- lte
type: string
bgp_local_as:
anyOf:
- type: string
- maximum: 4294967295
minimum: 1
type: integer
description: Required if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. BGP AS, value in range 1-4294967295
examples:
- 65000
dhcpd_config:
additionalProperties:
$ref: '#/components/schemas/dhcpd_config_property'
properties:
enabled:
default: true
description: If set to `false`, disable the DHCP server
type: boolean
type: object
networks:
items:
$ref: '#/components/schemas/network'
type: array
dhcpd_config_options:
additionalProperties:
$ref: '#/components/schemas/dhcpd_config_option'
description: If `type`==`local` or `type6`==`local`. Property key is the DHCP option number
type: object
bgp_config_networks:
description: Optional if `via`==`lan`. List of networks where we expect BGP neighbor to connect to/from
items:
type: string
type: array
bgp_config_neighbors:
additionalProperties: false
properties:
disabled:
default: false
description: If true, the BGP session to this neighbor will be administratively disabled/shutdown
type: boolean
export_policy:
type: string
hold_time:
default: 90
maximum: 65535
minimum: 0
type: integer
import_policy:
type: string
multihop_ttl:
description: Assuming BGP neighbor is directly connected
maximum: 255
minimum: 0
type: integer
neighbor_as:
$ref: '#/components/schemas/bgp_as'
tunnel_via:
$ref: '#/components/schemas/tunnel_via'
required:
- neighbor_as
type: object
gateway_port_config_reth_idx:
anyOf:
- type: integer
- type: string
description: For SRX only and if HA Mode. `-1` means it will be managed by the device. Use `>= 0` values to manage it manually. Ensure no conflicting values are assigned across all ports.
gateway_traffic_shaping_class_percentages:
description: 'percentages for different class of traffic: high / medium / low / best-effort. Sum must be equal to 100'
items:
type: integer
type: array
gateway_vrf_instances:
additionalProperties:
$ref: '#/components/schemas/gateway_vrf_instance'
description: Property key is the network name
examples:
- CORP_VRF:
networks:
- CORP_NET
- MGMT_NET
type: object
tunnel_config_ike_proposal:
additionalProperties: false
properties:
auth_algo:
$ref: '#/components/schemas/tunnel_config_auth_algo'
dh_group:
$ref: '#/components/schemas/tunnel_config_ike_dh_group'
enc_algo:
$ref: '#/components/schemas/tunnel_config_enc_algo'
type: object
idp_profile_action:
default: alert
description: "enum:\n * alert (default)\n * drop: silently dropping packets\n * close: notify client/server to close connection"
enum:
- alert
- close
- drop
examples:
- alert
type: string
response_http429:
additionalProperties: false
properties:
detail:
examples:
- Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
type: string
type: object
network_tenants:
additionalProperties:
$ref: '#/components/schemas/network_tenant'
description: Property key must be the user/tenant name (i.e. "printer-1") or a Variable (i.e. "{{myvar}}")
type: object
tunnel_config_enc_algo:
default: aes256
description: 'enum: `3des`, `aes128`, `aes256`, `aes_gcm128`, `aes_gcm256`'
enum:
- 3des
- aes128
- aes256
- aes_gcm128
- aes_gcm256
type:
- string
- 'null'
gw_routing_policy_term_matching_protocol_enum:
description: 'enum: `aggregate`, `bgp`, `direct`, `ospf`, `static` (SRX Only)'
enum:
- aggregate
- bgp
- direct
- ospf
- static
type: string
gateway_ip_config_dns_servers:
description: Except for out-of_band interface (vme/em0/fxp0)
items:
type: string
type: array
gateway_extra_routes:
additionalProperties:
$ref: '#/components/schemas/gateway_extra_route'
description: Property key is the destination CIDR (e.g. "10.0.0.0/8"), the destination Network name or a variable (e.g. "{{myvar}}")
type: object
wan_extra_routes:
additionalProperties: false
properties:
via:
format: ipv4
type: string
type: object
protect_re:
additionalProperties: false
description: "Restrict inbound-traffic to host\nwhen enabled, all traffic that is not essential to our operation will be dropped \ne.g. ntp / dns / traffic to mist will be allowed by default, if dhcpd is enabled, we'll make sure it works"
properties:
allowed_services:
$ref: '#/components/schemas/protect_re_allowed_services'
custom:
$ref: '#/components/schemas/protect_re_customs'
enabled:
default: false
description: "When enabled, all traffic that is not essential to our operation will be dropped\ne.g. ntp / dns / traffic to mist will be allowed by default\n if dhcpd is enabled, we'll make sure it works"
type: boolean
hit_count:
default: false
description: Whether to enable hit count for Protect_RE policy
type: boolean
trusted_hosts:
$ref: '#/components/schemas/protect_re_trusted_hosts'
type: object
service_policy_secintel:
additionalProperties: false
description: SRX only
properties:
enabled:
default: false
type: boolean
profile:
$ref: '#/components/schemas/service_policy_secintel_profile'
secintelprofile_id:
description: org-level secintel Profile can be used, this takes precedence over 'profile'
type: string
type: object
tunnel_config_probe:
additionalProperties: false
description: Only if `provider`==`custom-ipsec`
properties:
interval:
description: How often to trigger the probe
type: integer
threshold:
description: Number of consecutive misses before declaring the tunnel down
type: integer
timeout:
description: Time within which to complete the connectivity check
type: integer
type:
$ref: '#/components/schemas/tunnel_config_probe_type'
type: object
gw_routing_policy_term_action_exclude_as_path:
description: When used as export policy, optional. To exclude certain AS
items:
examples:
- '65002'
type: string
type: array
gateway_idp_profiles:
additionalProperties:
$ref: '#/components/schemas/idp_profile'
description: Property key is the profile name
type: object
idp_profile_matching_severity:
items:
$ref: '#/components/schemas/idp_profile_matching_severity_value'
type: array
org_id:
examples:
- a97c1b22-a4e9-411e-9bfd-d8695a0f9e61
format: uuid
readOnly: true
type: string
ip_type6:
default: disabled
description: 'enum: `autoconf`, `dhcp`, `disabled`, `static`'
enum:
- autoconf
- dhcp
- disabled
- static
examples:
- static
type: string
tunnel_config_provider:
description: 'Only if `auto_provision.enabled`==`false`. enum: `custom-ipsec`, `custom-gre`, `jse-ipsec`, `prisma-ipsec`, `zscaler-gre`, `zscaler-ipsec`'
enum:
- custom-ipsec
- custom-gre
- jse-ipsec
- prisma-ipsec
- zscaler-gre
- zscaler-ipsec
type: string
gateway_mgmt:
additionalProperties: false
description: Gateway Management settings
properties:
admin_sshkeys:
$ref: '#/components/schemas/gateway_mgmt_admin_sshkeys'
app_probing:
$ref: '#/components/schemas/app_probing'
app_usage:
description: Consumes uplink bandwidth, requires WA license
type: boolean
auto_signature_update:
$ref: '#/components/schemas/gateway_mgmt_auto_signature_update'
config_revert_timer:
default: 10
description: Rollback timer for commit confirmed
maximum: 30
minimum: 1
type: integer
disable_console:
default: false
description: For SSR and SRX, disable console port
type: boolean
disable_oob:
default: false
description: For SSR and SRX, disable management interface
type: boolean
disable_usb:
default: false
description: For SSR and SRX, disable usb interface
type: boolean
fips_enabled:
default: false
type: boolean
probe_hosts:
$ref: '#/components/schemas/gateway_mgmt_probe_hosts'
probe_hostsv6:
$ref: '#/components/schemas/gateway_mgmt_probe_hostsv6'
protect_re:
$ref: '#/components/schemas/protect_re'
root_password:
description: SRX only
format: password
type: string
security_log_source_address:
examples:
- 192.168.1.1
format: ipv4
type: string
security_log_source_interface:
examples:
- ge-0/0/1.0
type: string
type: object
service_policy_appqoe:
additionalProperties: false
description: SRX only
properties:
enabled:
default: false
type: boolean
type: object
routing_policy_term_matching_prefix:
description: zero or more criteria/filter can be specified to match the term, all criteria have to be met
items:
examples:
- 192.168.0.0/16-30
type: string
type: array
protect_re_trusted_hosts:
description: host/subnets we'll allow traffic to/from
items:
examples:
- 10.242.3.0/24
type: string
type: array
gateway_port_wan_source_nat:
additionalProperties: false
description: Only if `usage`==`wan`, optional. By default, source-NAT is performed on all WAN Ports using the interface-ip
properties:
disabled:
default: false
description: Or to disable the source-nat
type: boolean
nat6_pool:
description: If alternative nat_pool is desired
examples:
- 2601:1700:43c0:dc0:20c:29ff:fea7:93bc/126
type: string
nat_pool:
description: If alternative nat_pool is desired
examples:
- 64.2.4.0/30
type: string
type: object
gateway_port_vpn_paths:
additionalProperties:
$ref: '#/components/schemas/gateway_port_vpn_path'
description: Property key is the VPN name
type: object
network_internet_access_destination_nat:
additionalProperties:
$ref: '#/components/schemas/network_internet_access_destination_nat_property'
description: Property key can be an External IP (i.e. "63.16.0.3"), an External IP:Port (i.e. "63.16.0.3:443"), an External Port (i.e. ":443"), an External CIDR (i.e. "63.16.0.0/30"), an External CIDR:Port (i.e. "63.16.0.0/30:443") or a Variable (i.e. "{{myvar}}"). At least one of the `internal_ip` or `port` must be defined
type: object
id:
description: Unique ID of the object instance in the Mist Organization
examples:
- 53f10664-3ce8-4c27-b382-0ef66432349f
format: uuid
readOnly: true
type: string
tunnel_provider_options_zscaler:
additionalProperties: false
description: For zscaler-ipsec and zscaler-gre
properties:
aup_block_internet_until_accepted:
default: false
type: boolean
aup_enabled:
default: false
description: Can only be `true` when `auth_required`==`false`, display Acceptable Use Policy (AUP)
type: boolean
aup_force_ssl_inspection:
default: false
description: Proxy HTTPs traffic, requiring Zscaler cert to be installed in browser
type: boolean
aup_timeout_in_days:
description: Required if `aup_enabled`==`true`. Days before AUP is requested again
maximum: 180
minimum: 1
type: integer
auth_required:
default: false
description: Enable this option to enforce user authentication
type: boolean
caution_enabled:
default: false
description: Can only be `true` when `auth_required`==`false`, display caution notification for non-authenticated users
type: boolean
dn_bandwidth:
description: Download bandwidth cap of the link, in Mbps. Disabled if not set
examples:
- 200
format: double
maximum: 99999
minimum: 0.1
type:
- number
- 'null'
idle_time_in_minutes:
description: Required if `surrogate_IP`==`true`, idle Time to Disassociation
maximum: 43200
minimum: 0
type: integer
ofw_enabled:
default: false
description: If `true`, enable the firewall control option
type: boolean
sub_locations:
$ref: '#/components/schemas/zscaler_sub_locations'
surrogate_IP:
default: false
description: Can only be `true` when `auth_required`==`true`. Map a user to a private IP address so it applies the user's policies, instead of the location's policies
type: boolean
surrogate_IP_enforced_for_known_browsers:
description: Can only be `true` when `surrogate_IP`==`true`, enforce surrogate IP for known browsers
type: boolean
surrogate_refresh_time_in_minutes:
description: Required if `surrogate_IP_enforced_for_known_browsers`==`true`, must be lower or equal than `idle_time_in_minutes`, refresh Time for re-validation of Surrogacy
maximum: 43200
minimum: 1
type: integer
up_bandwidth:
description: Download bandwidth cap of the link, in Mbps. Disabled if not set
examples:
- 200
format: double
maximum: 99999
minimum: 0.1
type:
- number
- 'null'
xff_forward_enabled:
default: false
description: Location uses proxy chaining to forward traffic
type: boolean
type: object
gateway_matching_rule:
additionalProperties:
description: 'Property key defines the type of matching. e.g: `match_name[0:3]`, `match_model[0-6]` or `match_role`'
type: string
properties:
additional_config_cmds:
$ref: '#/components/schemas/additional_config_cmds'
name:
type: string
port_config:
additionalProperties:
$ref: '#/components/schemas/gateway_port_config'
description: Property key is the port(s) name or range (e.g. "ge-0/0/0-10").
type: object
type: object
bgp_config:
additionalProperties: false
description: BFD is enabled when either bfd_minimum_interval or bfd_multiplier is configured
properties:
auth_key:
description: Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`
type: string
bfd_minimum_interval:
default: 350
description: "Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`, when bfd_multiplier is configured alone. Default:\n * 1000 if `type`==`external`\n * 350 `type`==`internal`"
maximum: 255000
minimum: 1
type:
- integer
- 'null'
bfd_multiplier:
default: 3
description: Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`, when bfd_minimum_interval_is_configured alone
maximum: 255
minimum: 1
type:
- integer
- 'null'
disable_bfd:
default: false
description: Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. BFD provides faster path failure detection and is enabled by default
type: boolean
export:
type: string
export_policy:
description: Default export policies if no per-neighbor policies defined
type: string
extended_v4_nexthop:
description: Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. By default, either inet/net6 unicast depending on neighbor IP family (v4 or v6). For v6 neighbors, to exchange v4 nexthop, which allows dual-stack support, enable this
type: boolean
graceful_restart_time:
default: 0
description: Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. `0` means disable
maximum: 4095
minimum: 0
type: integer
hold_time:
default: 90
description: Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. Default is 90.
maximum: 65535
minimum: 0
type: integer
import:
type: string
import_policy:
description: Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. Default import policies if no per-neighbor policies defined
type: string
local_as:
$ref: '#/components/schemas/bgp_local_as'
neighbor_as:
$ref: '#/components/schemas/bgp_as'
neighbors:
additionalProperties:
$ref: '#/components/schemas/bgp_config_neighbors'
description: Required if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. If per-neighbor as is desired. Property key is the neighbor address
type: object
networks:
$ref: '#/components/schemas/bgp_config_networks'
no_private_as:
default: false
description: Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. If true, we will not advertise private ASNs (AS 64512-65534) to this neighbor
type: boolean
no_readvertise_to_overlay:
default: false
description: Optional if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. By default, we'll re-advertise all learned BGP routers toward overlay
type: boolean
tunnel_name:
description: Optional if `via`==`tunnel`
type: string
type:
$ref: '#/components/schemas/bgp_config_type'
via:
$ref: '#/components/schemas/bgp_config_via'
vpn_name:
description: Optional if `via`==`vpn`
type: string
wan_name:
description: Optional if `via`==`wan`
type: string
required:
- via
type: object
gateway_matching_rules:
items:
$ref: '#/components/schemas/gateway_matching_rule'
type: array
uniqueItems: true
gateway_port_networks:
description: If `usage`==`lan`, name of the [networks]($h/Orgs%20Networks/_overview) to attach to the interface
items:
type: string
type: array
gateway_wan_type:
default: dhcp
description: 'enum: `dhcp`, `pppoe`, `static`'
enum:
- dhcp
- pppoe
- static
type: string
gw_routing_policy_term_matching_vpn_path:
description: overlay-facing criteria (used for bgp_config where via=vpn). ordered-
items:
type: string
type: array
network_multicast_group:
additionalProperties: false
properties:
rp_ip:
description: RP (rendezvous point) IP Address
type: string
type: object
service_policy_ewf_rule:
additionalProperties: false
properties:
alert_only:
type: boolean
block_message:
examples:
- Access to this URL Category has been blocked
type: string
enabled:
default: false
type: boolean
profile:
$ref: '#/components/schemas/service_policy_ewf_rule_profile'
type: object
idp_profile_matching_dst_subnet:
items:
examples:
- 63.1.2.0/24
type: string
type: array
response_http403:
additionalProperties: false
properties:
detail:
examples:
- You do not have permission to perform this action.
type: string
type: object
gateway_path_preferences:
additionalProperties: false
properties:
paths:
$ref: '#/components/schemas/gateway_path_preferences_paths'
strategy:
$ref: '#/components/schemas/gateway_path_strategy'
type: object
ip_type:
default: dhcp
description: 'enum: `dhcp`, `static`'
enum:
- dhcp
- static
examples:
- static
type: string
network_multicast_groups:
additionalProperties:
$ref: '#/components/schemas/network_multicast_group'
description: Group address to RP (rendezvous point) mapping. Property Key is the CIDR (example "225.1.0.3/32")
type: object
idp_profile_matching_severity_value:
description: 'enum: `critical`, `info`, `major`, `minor`'
enum:
- critical
- info
- major
- minor
examples:
- major
type: string
gateway_port_wan_type:
default: broadband
description: 'Only if `usage`==`wan`. enum: `broadband`, `dsl`, `lte`'
enum:
- broadband
- dsl
- lte
type: string
ntp_servers:
description: List of NTP servers specific to this device. By default, those in Site Settings will be used
items:
type: string
type: array
tunnel_config_ike_dh_group:
default: '14'
description: "enum:\n * 1\n * 2 (1024-bit)\n * 5\n * 14 (default, 2048-bit)\n * 15 (3072-bit)\n * 16 (4096-bit)\n * 19 (256-bit ECP)\n * 20 (384-bit ECP)\n * 21 (521-bit ECP)\n * 24 (2048-bit ECP)"
enum:
- '1'
- '14'
- '15'
- '16'
- '19'
- '2'
- '20'
- '21'
- '24'
- '5'
type: string
dhcpd_config_fixed_binding:
additionalProperties: false
properties:
ip:
examples:
- 192.168.70.35
type: string
ip6:
examples:
- 2607:f8b0:4005:808::2
type: string
name:
type: string
type: object
idp_profile_base_profile:
description: 'enum: `critical`, `standard`, `strict`'
enum:
- critical
- standard
- strict
examples:
- strict
type: string
response_http404:
additionalProperties: false
properties:
id:
type: string
type: object
dhcpd_config_option:
additionalProperties: false
properties:
type:
$ref: '#/components/schemas/dhcpd_config_option_type'
value:
type: string
type: object
gw_routing_policy_term_matching_vpn_neighbor_mac:
description: overlay-facing criteria (used for bgp_config where via=vpn)
items:
type: string
type: array
gateway_path_preferences_path:
additionalProperties: false
properties:
cost:
type: integer
disabled:
description: For SSR Only. `true`, if this specific path is undesired
type: boolean
gateway_ip:
description: Only if `type`==`local`, if a different gateway is desired
type: string
internet_access:
description: Only if `type`==`vpn`, if this vpn path can be used for internet
type: boolean
name:
description: "Required when \n * `type`==`vpn`: the name of the VPN Path to use \n * `type`==`wan`: the name of the WAN interface to use"
type: string
networks:
$ref: '#/components/schemas/gateway_path_preferences_path_networks'
target_ips:
$ref: '#/components/schemas/gateway_path_preferences_path_target_ips'
type:
$ref: '#/components/schemas/gateway_path_type'
wan_name:
description: Optional if `type`==`vpn`
examples:
- wan0
type: string
required:
- type
type: object
dhcpd_config_vendor_option_type:
description: 'enum: `boolean`, `hex`, `int16`, `int32`, `ip`, `string`, `uint16`, `uint32`'
enum:
- boolean
- hex
- int16
- int32
- ip
- string
- uint16
- uint32
type: string
idp_profile_matching:
additionalProperties: false
properties:
attack_name:
$ref: '#/components/schemas/idp_profile_matching_attack_name'
dst_subnet:
$ref: '#/components/schemas/idp_profile_matching_dst_subnet'
severity:
$ref: '#/components/schemas/idp_profile_matching_severity'
type: object
service_policy_skyatp_iot_device_policy:
additionalProperties: false
properties:
enabled:
type: boolean
type: object
response_http400:
additionalProperties: false
properties:
detail:
examples:
- 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
type: string
type: object
network_vpn_access_static_nat:
additionalProperties:
$ref: '#/components/schemas/network_vpn_access_static_nat_property'
description: Property key may be an External IP Address (i.e. "63.16.0.3"), a CIDR (i.e. "63.16.0.12/20") or a Variable (i.e. "{{myvar}}")
type: object
dhcpd_config_vendor_option:
additionalProperties: false
properties:
type:
$ref: '#/components/schemas/dhcpd_config_vendor_option_type'
value:
type: string
type: object
gw_routing_policy_term_action_exclude_community:
items:
examples:
- '3900190'
type: string
type: array
service_policy_skyatp_dns_tunnel_detection_profile:
description: 'enum: `default`, `standard`, `strict`'
enum:
- default
- standard
- strict
type: string
tunnel_config_networks:
description: If `provider`==`custom-ipsec` or `provider`==`prisma-ipsec`, networks reachable via this tunnel
items:
type: string
type: array
gateway_wan_type6:
default: autoconf
description: 'enum: `autoconf`, `dhcp`, `static`'
enum:
- autoconf
- dhcp
- static
type: string
gw_routing_policies:
additionalProperties:
$ref: '#/components/schemas/gw_routing_policy'
description: Property key is the routing policy name
type: object
bgp_config_via:
default: lan
description: 'enum: `lan`, `tunnel`, `vpn`, `wan`'
enum:
- lan
- tunnel
- vpn
- wan
type: string
gw_routing_policy_term_action_add_target_vrfs:
description: For SSR, hub decides how VRF routes are leaked on spoke
items:
type: string
type: array
network:
description: Networks are usually subnets that have cross-site significance. `networks`in Org Settings will got merged into `networks`in Site Setting. For gateways, they can be used to define Service Routes.
properties:
created_time:
$ref: '#/components/schemas/created_time'
disallow_mist_services:
default: false
description: Whether to disallow Mist Devices in the network
type: boolean
gateway:
examples:
- 192.168.70.1
format: ipv4
type: string
gateway6:
examples:
- fdad:b0bc:f29e::1
format: ipv6
type: string
id:
$ref: '#/components/schemas/id'
internal_access:
$ref: '#/components/schemas/network_internal_access'
internet_access:
$ref: '#/components/schemas/network_internet_access'
isolation:
description: Whether to allow clients in the network to talk to each other
type: boolean
modified_time:
$ref: '#/components/schemas/modified_time'
multicast:
$ref: '#/components/schemas/network_multicast'
name:
type: string
org_id:
$ref: '#/components/schemas/org_id'
routed_for_networks:
$ref: '#/components/schemas/network_routed_for_networks'
subnet:
examples:
- 192.168.70.0/24
type: string
subnet6:
examples:
- fdad:b0bc:f29e::/32
type: string
tenants:
$ref: '#/components/schemas/network_tenants'
vlan_id:
$ref: '#/components/schemas/vlan_id_with_variable'
vpn_access:
$ref: '#/components/schemas/network_vpn_access'
required:
- name
type: object
bgp_config_type:
description: 'Required if `via`==`lan`, `via`==`tunnel` or `via`==`wan`. enum: `external`, `internal`'
enum:
- external
- internal
minLength: 1
type: string
tunnel_config_version:
default: '2'
description: 'Only if `provider`==`custom-gre` or `provider`==`custom-ipsec`. enum: `1`, `2`'
enum:
- '1'
- '2'
type: string
tunnel_config_ipsec_proposals:
description: Only if `provider`==`custom-ipsec`
items:
$ref: '#/components/schemas/tunnel_config_ipsec_proposal'
type: array
protect_re_customs:
items:
$ref: '#/components/schemas/protect_re_custom'
type: array
modified_time:
description: When the object has been modified for the last time, in epoch
format: double
readOnly: true
type: number
dhcpd_config_vendor_options:
additionalProperties:
$ref: '#/components/schemas/dhcpd_config_vendor_option'
description: "If `type`==`local` or `type6`==`local`. Property key is :, with\n * enterprise number: 1-65535 (https://www.iana.org/assignments/enterprise-numbers/enterprise-numbers)\n * sub option code: 1-255, sub-option code"
type: object
routing_policy_term_action_community:
description: When used as export policy, optional
items:
examples:
- '3900190'
type: string
type: array
gateway_port_config_wan_networks:
description: Only if `usage`==`wan`. If some networks are connected to this WAN port, it can be added here so policies can be defined
items:
type: string
type: array
service_policy_skyatp_dns_dga_detection:
additionalProperties: false
properties:
enabled:
type: boolean
profile:
$ref: '#/components/schemas/service_policy_skyatp_dns_dga_detection_profile'
type: object
network_internet_access_static_nat_property:
additionalProperties: false
properties:
internal_ip:
description: The Static NAT destination IP Address. Must be an IP Address (i.e. "192.168.70.3") or a Variable (i.e. "{{myvar}}")
examples:
- 192.168.70.3
type: string
name:
examples:
- pos_station-1
type: string
wan_name:
description: SRX Only. If not set, we configure the nat policies against all WAN ports for simplicity. Can be a Variable (i.e. "{{myvar}}")
examples:
- wan0
type: string
type: object
examples:
HTTP403Example:
value:
detail: You do not have permission to perform this action.
HTTP429Example:
value:
detail: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
HTTP400Example:
value:
detail: 'JSON parse error - Expecting value: line 5 column 8 (char 56)'
HTTP401Example:
value:
detail: Authentication credentials were not provided.
responses:
HTTP403:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/HTTP403Example'
schema:
$ref: '#/components/schemas/response_http403'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/HTTP403Example'
schema:
$ref: '#/components/schemas/response_http403'
description: Permission Denied
HTTP401:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/HTTP401Example'
schema:
$ref: '#/components/schemas/response_http401'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/HTTP401Example'
schema:
$ref: '#/components/schemas/response_http401'
description: Unauthorized
HTTP404:
content:
application/json:
schema:
$ref: '#/components/schemas/response_http404'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/response_http404'
description: Not found. The API endpoint doesn’t exist or resource doesn’ t exist
GatewaytemplatesArray:
content:
application/json:
schema:
$ref: '#/components/schemas/gateway_templates'
application/vnd.api+json:
schema:
$ref: '#/components/schemas/gateway_templates'
description: OK
HTTP429:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/HTTP429Example'
schema:
$ref: '#/components/schemas/response_http429'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/HTTP429Example'
schema:
$ref: '#/components/schemas/response_http429'
description: Too Many Request. The API Token used for the request reached the 5000 API Calls per hour threshold
HTTP400:
content:
application/json:
examples:
Example:
$ref: '#/components/examples/HTTP400Example'
schema:
$ref: '#/components/schemas/response_http400'
application/vnd.api+json:
examples:
Example:
$ref: '#/components/examples/HTTP400Example'
schema:
$ref: '#/components/schemas/response_http400'
description: Bad Syntax
parameters:
site_id:
in: path
name: site_id
required: true
schema:
examples:
- 000000ab-00ab-00ab-00ab-0000000000ab
format: uuid
type: string
securitySchemes:
apiToken:
description: "Like many other API providers, it’s also possible to generate API Tokens to be used (in HTTP Header) for authentication. An API token ties to a Admin with equal or less privileges.\n\n**Format**:\n API Token value format is `Token {apitoken}`\n\n**Notes**:\n* an API token generated for a specific admin has the same privilege as the user\n* an API token will be automatically removed if not used for > 90 days\n* SSO admins cannot generate these API tokens. Refer Org level API tokens which can have privileges of a specific Org/Site for more information."
in: header
name: Authorization
type: apiKey
basicAuth:
description: While our current UI uses Session / Cookie-based authentication, it’s also possible to do Basic Auth.
scheme: basic
type: http
csrfToken:
description: "This protects the website against [Cross Site Request Forgery](https://en.wikipedia.org/wiki/Cross-site_request_forgery), all the POST / PUT / DELETE APIs needs to have CSRF token in the AJAX Request header when using Login/Password authentication (with or without MFA)\n\n\nThe CSRF Token is sent back by Mist in the Cookies from the Login Response API Call:\n`cookies[csrftoken]` \n\nThe CSRF Token must be added in the HTTP Request Headers:\n```\nX-CSRFToken: vwvBuq9qkqaKh7lu8tNc0gkvBfEaLAmx\n```"
in: header
name: X-CSRFToken
type: apiKey