Skip to content

Latest commit

 

History

History
52 lines (50 loc) · 5.31 KB

function_method.md

File metadata and controls

52 lines (50 loc) · 5.31 KB

XMLRPC Functions

Granular Permission: XMLRPC Library

Function Uses Plugin Possible in REST API Comments
Get Config Yes No as of 24.7 Returns a large dictionary of elements used for multiple functions. More details in the other functions.
Restore Config Section No No as of 24.7
Filter Configure Yes No as of 24.7 Used by the Filter and NAT functions
Enable/Disable Filter Rule N/A No as of 24.7 Uses Get Config, Filter Configure and Restore Config Section.
Enable/Disable NAT Port Forward Rule N/A No as of 24.7 Uses Get Config, Filter Configure and Restore Config Section.
Enable/Disable NAT Outbound Rule N/A No as of 24.7 Uses Get Config, Filter Configure and Restore Config Section.

REST API Functions

Function Endpoints Min OPNsense Version Granular Permission Comments
Get Interfaces
Get Device Unique ID
/api/interfaces/overview/export 24.1 Status: Interfaces
Get mbuf /api/diagnostics/system/system_mbuf 24.7 Lobby: Dashboard Part of Telemetry: Uses XMLRPC functions if <24.7
Get pfstates /api/diagnostics/firewall/pf_states 24.7 Lobby: Dashboard Part of Telemetry: Uses XMLRPC functions if <24.7
Get Memory /api/diagnostics/system/systemResources
/api/diagnostics/system/system_swap
24.7 Lobby: Dashboard Part of Telemetry: Uses XMLRPC functions if <24.7
Get System Time /api/diagnostics/system/systemTime 24.7 Lobby: Dashboard Part of Telemetry: Uses XMLRPC functions if <24.7
Get CPU /api/diagnostics/cpu_usage/getCPUType
/api/diagnostics/cpu_usage/stream
24.7 Lobby: Dashboard Part of Telemetry: Uses XMLRPC functions if <24.7
Get Filesystem /api/diagnostics/system/systemDisk 24.7 Lobby: Dashboard Part of Telemetry: Uses XMLRPC functions if <24.7
Get OpenVPN /api/openvpn/export/providers
/api/openvpn/service/searchSessions
/api/openvpn/instances/search
/api/openvpn/instances/get
20.1 VPN: OpenVPN: Client Export Utility
Status: OpenVPN
VPN: OpenVPN: Instances
Get Gateways /api/routes/gateway/status 2021 System: Gateways
Get Temperatures /api/diagnostics/system/systemTemperature 24.7 Lobby: Dashboard Part of Telemetry
Get Firmware Update Info
Get Firmware Version
/api/core/firmware/status 2018 System: Firmware
Upgrade Firmware /api/core/firmware/update
/api/core/firmware/upgrade
2018 System: Firmware
Firmware Upgrade Status /api/core/firmware/upgradestatus 2018 System: Firmware
Firmware Changelog /api/core/firmware/changelog/ 2018 System: Firmware
System Reboot /api/core/system/reboot 20.1 Diagnostics: Reboot System
System Halt /api/core/system/halt 20.1 Diagnostics: Halt system
Send WOL /api/wol/wol/set 2018 Services: Wake on LAN
Get ARP Table /api/diagnostics/interface/search_arp 2022 Diagnostics: ARP Table
Get System Info /api/diagnostics/system/systemInformation 24.7 Lobby: Dashboard Uses XMLRPC functions if <24.7
Get Notices /api/core/system/status 2022 System: Status
Close Notice /api/core/system/status
/api/core/system/dismissStatus
2022 System: Status
Get Services /api/core/service/search 2023 System: Status
Start Service /api/core/service/start 2023 Status: Services
Stop Service /api/core/service/stop 2023 Status: Services
Restart Service /api/core/service/restart 2023 Status: Services
Get Carp Status /api/diagnostics/interface/get_vip_status 2022 Interfaces: Virtual IPs: Status
Get DHCP Leases /api/kea/leases4/search
/api/kea/dhcpv4/searchReservation
/api/dhcpv4/leases/searchLease
/api/dhcpv6/leases/searchLease
24.1 Services: DHCP: Kea(v4)
Status: DHCP leases
Status: DHCPv6 leases
Get Unbound Blocklist /api/unbound/settings/get
/api/unbound/settings/set
/api/unbound/service/dnsbl
/api/unbound/service/restart
21.7 Services: Unbound (MVC)
Get Wireguard /api/wireguard/service/show
/api/wireguard/client/get
/api/wireguard/server/get
24.1 VPN: WireGuard
Get Kea Interfaces /api/kea/dhcpv4/get 24.1 Services: DHCP: Kea(v4)
Toggle VPN Instance /api/openvpn/instances/toggle
/api/openvpn/service/reconfigure
/api/wireguard/client/toggleClient
/api/wireguard/server/toggleServer
/api/wireguard/service/reconfigure
24.1 VPN: OpenVPN: Instances
Status: OpenVPN
VPN: WireGuard
Get Carp Interfaces /api/interfaces/vip_settings/get
/api/diagnostics/interface/get_vip_status
2022 Interfaces: Virtual IPs: Settings
Interfaces: Virtual IPs: Status
Reload Interface /api/interfaces/overview/reloadInterface/ 24.1 Status: Interfaces
Get Certificates /api/trust/cert/search 24.7 System: Certificate Manager
Generate Vouchers /api/captiveportal/voucher/listProviders
/api/captiveportal/voucher/generateVouchers/
20.1 Services: Captive Portal
Kill States /api/diagnostics/firewall/kill_states/ 21.7 Diagnostics: Show States
Toggle Alias /api/firewall/alias/searchItem
/api/firewall/alias/toggleItem/
/api/firewall/alias/set
/api/firewall/alias/reconfigure
20.1 Firewall: Alias: Edit