Модуль community.routeros.api_info – Получение информации из API

ca_path

путь

добавлено в community.routeros 1.2.0

Файл в формате PEM, содержащий сертификат CA, который будет использоваться для проверки сертификатов.

См. также validate_cert_hostname. Используется только при tls=true и validate_certs=true.

encoding

строка

добавлено в community.routeros 2.1.0

Используйте указанное кодирование при общении с устройством RouterOS.

По умолчанию ASCII. Обратите внимание, что UTF-8 требует librouteros 3.2.1 или более поздней версии.

По умолчанию: "ASCII"

force_no_cert

логическое

добавлено в community.routeros 2.4.0

Установите true для подключения без сертификата при tls=true.

См. также validate_certs.

Примечание: это принудительно использует анонимные шифры Diffie-Hellman (ADH). Протокол уязвим для атак «человек посередине», поскольку ключи, используемые в обмене, не аутентифицированы. Вместо простого подключения без сертификата для «работы», ознакомьтесь с validate_certs и ca_path.

Варианты:

• false ← (по умолчанию)
• true

handle_disabled

строка

Как обрабатывать значения unset.

exclamation добавляет ключи с ! в выводе со значением null.

null-value использует обычный ключ со значением null.

omit пропускает эти значения из результата.

Варианты:

• "exclamation" ← (по умолчанию)
• "null-value"
• "omit"

hide_defaults

логическое

Скрыть значения по умолчанию.

Варианты:

• false
• true ← (по умолчанию)

hostname

строка / обязательно

Имя хоста API RouterOS.

include_builtin

логическое

добавлено в community.routeros 2.4.0

Включать встроенные значения.

По умолчанию они не возвращаются, и ключи builtin опускаются.

Если установлено в true, они возвращаются, и ключи builtin также возвращаются.

Варианты:

• false ← (по умолчанию)
• true

include_dynamic

логическое

Включать динамические значения.

По умолчанию они не возвращаются, и ключи dynamic опускаются.

Если установлено в true, они возвращаются, и ключи dynamic также возвращаются.

Варианты:

• false ← (по умолчанию)
• true

include_read_only

логическое

добавлено в community.routeros 2.10.0

Включать поля только для чтения.

По умолчанию они не возвращаются.

Варианты:

• false ← (по умолчанию)
• true

password

строка / обязательно

Пароль пользователя RouterOS.

path

string / обязательно

Путь для запроса.

Пример значения: ip address. Это эквивалентно выполнению команды /ip address print в командной строке RouterOS.

Варианты:

• "caps-man aaa"
• "caps-man access-list"
• "caps-man channel"
• "caps-man configuration"
• "caps-man datapath"
• "caps-man manager"
• "caps-man manager interface"
• "caps-man provisioning"
• "caps-man security"
• "certificate settings"
• "interface bonding"
• "interface bridge"
• "interface bridge mlag"
• "interface bridge port"
• "interface bridge port-controller"
• "interface bridge port-extender"
• "interface bridge settings"
• "interface bridge vlan"
• "interface detect-internet"
• "interface eoip"
• "interface ethernet"
• "interface ethernet poe"
• "interface ethernet switch"
• "interface ethernet switch port"
• "interface gre"
• "interface gre6"
• "interface l2tp-server server"
• "interface list"
• "interface list member"
• "interface ovpn-client"
• "interface ovpn-server server"
• "interface ppp-client"
• "interface pppoe-client"
• "interface pppoe-server server"
• "interface pptp-server server"
• "interface sstp-server server"
• "interface vlan"
• "interface vrrp"
• "interface wifi"
• "interface wifi aaa"
• "interface wifi access-list"
• "interface wifi cap"
• "interface wifi capsman"
• "interface wifi channel"
• "interface wifi configuration"
• "interface wifi datapath"
• "interface wifi interworking"
• "interface wifi provisioning"
• "interface wifi security"
• "interface wifi steering"
• "interface wifiwave2"
• "interface wifiwave2 aaa"
• "interface wifiwave2 access-list"
• "interface wifiwave2 cap"
• "interface wifiwave2 capsman"
• "interface wifiwave2 channel"
• "interface wifiwave2 configuration"
• "interface wifiwave2 datapath"
• "interface wifiwave2 interworking"
• "interface wifiwave2 provisioning"
• "interface wifiwave2 security"
• "interface wifiwave2 steering"
• "interface wireguard"
• "interface wireguard peers"
• "interface wireless"
• "interface wireless align"
• "interface wireless cap"
• "interface wireless security-profiles"
• "interface wireless sniffer"
• "interface wireless snooper"
• "iot modbus"
• "ip accounting"
• "ip accounting web-access"
• "ip address"
• "ip arp"
• "ip cloud"
• "ip cloud advanced"
• "ip dhcp-client"
• "ip dhcp-client option"
• "ip dhcp-relay"
• "ip dhcp-server"
• "ip dhcp-server config"
• "ip dhcp-server lease"
• "ip dhcp-server matcher"
• "ip dhcp-server network"
• "ip dhcp-server option"
• "ip dhcp-server option sets"
• "ip dns"
• "ip dns adlist"
• "ip dns static"
• "ip firewall address-list"
• "ip firewall connection tracking"
• "ip firewall filter"
• "ip firewall layer7-protocol"
• "ip firewall mangle"
• "ip firewall nat"
• "ip firewall raw"
• "ip firewall service-port"
• "ip hotspot service-port"
• "ip ipsec identity"
• "ip ipsec peer"
• "ip ipsec policy"
• "ip ipsec profile"
• "ip ipsec proposal"
• "ip ipsec settings"
• "ip neighbor discovery-settings"
• "ip pool"
• "ip proxy"
• "ip route"
• "ip route rule"
• "ip route vrf"
• "ip service"
• "ip settings"
• "ip smb"
• "ip socks"
• "ip ssh"
• "ip tftp settings"
• "ip traffic-flow"
• "ip traffic-flow ipfix"
• "ip traffic-flow target"
• "ip upnp"
• "ip upnp interfaces"
• "ip vrf"
• "ipv6 address"
• "ipv6 dhcp-client"
• "ipv6 dhcp-server"
• "ipv6 dhcp-server option"
• "ipv6 firewall address-list"
• "ipv6 firewall filter"
• "ipv6 firewall mangle"
• "ipv6 firewall nat"
• "ipv6 firewall raw"
• "ipv6 nd"
• "ipv6 nd prefix"
• "ipv6 nd prefix default"
• "ipv6 route"
• "ipv6 settings"
• "mpls"
• "mpls interface"
• "mpls ldp"
• "mpls ldp accept-filter"
• "mpls ldp advertise-filter"
• "mpls ldp interface"
• "port firmware"
• "port remote-access"
• "ppp aaa"
• "ppp profile"
• "ppp secret"
• "queue interface"
• "queue simple"
• "queue tree"
• "queue type"
• "radius"
• "radius incoming"
• "routing bgp aggregate"
• "routing bgp connection"
• "routing bgp instance"
• "routing bgp network"
• "routing bgp peer"
• "routing bgp template"
• "routing filter"
• "routing filter num-list"
• "routing filter rule"
• "routing filter select-rule"
• "routing id"
• "routing igmp-proxy"
• "routing igmp-proxy interface"
• "routing mme"
• "routing ospf area"
• "routing ospf area range"
• "routing ospf instance"
• "routing ospf interface-template"
• "routing ospf static-neighbor"
• "routing pimsm instance"
• "routing pimsm interface-template"
• "routing rip"
• "routing ripng"
• "routing rule"
• "routing table"
• "snmp"
• "snmp community"
• "system clock"
• "system clock manual"
• "system health settings"
• "system identity"
• "system leds settings"
• "system logging"
• "system logging action"
• "system note"
• "system ntp client"
• "system ntp client servers"
• "system ntp server"
• "system package update"
• "system resource irq rps"
• "system routerboard settings"
• "system scheduler"
• "system script"
• "system upgrade mirror"
• "system ups"
• "system watchdog"
• "tool bandwidth-server"
• "tool e-mail"
• "tool graphing"
• "tool graphing interface"
• "tool graphing resource"
• "tool mac-server"
• "tool mac-server mac-winbox"
• "tool mac-server ping"
• "tool netwatch"
• "tool romon"
• "tool sms"
• "tool sniffer"
• "tool traffic-generator"
• "user"
• "user aaa"
• "user group"
• "user settings"

port

целое число

Порт API RouterOS. Если tls установлен, порт будет применяться к TLS/SSL подключению.

Значения по умолчанию 8728 для HTTP API и 8729 для HTTPS API.

restrict

список / элементы=словарь

добавлен в community.routeros 2.18.0

Ограничить вывод записями, соответствующими следующим критериям.

field

строка / обязательно

Поле, значения которого ограничить.

invert

логическое значение

Инвертировать условие. Это влияет на restrict[].match_disabled, restrict[].values, и restrict[].regex.

Варианты:

• false ← (значение по умолчанию)
• true

match_disabled

логическое значение

Указывает, должны ли соответствовать значения отключенных или не заданных элементов.

Варианты:

• false ← (значение по умолчанию)
• true

regex

string

Регулярное выражение, сопоставляющее значения поля для ограничения.

Обратите внимание, что все значения будут преобразованы в строки перед сопоставлением.

Невозможно сопоставить отключенные значения с помощью регулярных выражений. Установите restrict[].match_disabled=true если вы также хотите сопоставить отключенные значения.

values

list / elements=any

Значения поля для ограничения.

Обратите внимание, что типы значений важны. Если вы предоставите строку "0", а librouteros преобразует возвращаемое значение API в целое число 0, то это не будет соответствовать. Если вы не уверены, лучше включить оба варианта: как строку, так и целое число.

timeout

integer

добавлен в community.routeros 2.3.0

Тайм-аут для запроса.

По умолчанию: 10

tls

aliases: ssl

boolean

Если установлено, TLS будет использоваться для подключения к RouterOS API.

Возможные значения:

• false ← (по умолчанию)
• true

unfiltered

boolean

Выводить все поля, а не только те, которые поддерживаются в качестве входных данных для community.routeros.api_modify.

Неотфильтрованный вывод может содержать счетчики и другую информацию о состоянии.

Возможные значения:

• false ← (по умолчанию)
• true

username

string / обязательно

Пользователь для входа в RouterOS.

validate_cert_hostname

boolean

добавлен в community.routeros 1.2.0

Установите значение true для проверки имен хостов в сертификатах.

См. также validate_certs. Используется только при tls=true и validate_certs=true.

Возможные значения:

• false ← (по умолчанию)
• true

validate_certs

boolean

добавлен в community.routeros 1.2.0

Установите значение false для пропуска проверки TLS-сертификатов.

См. также validate_cert_hostname. Используется только при tls=true.

Примечание: вместо простого отключения проверки сертификатов для «работы» рекомендуется создать собственный сертификат CA и использовать его для подписи сертификатов, используемых для вашего маршрутизатора. Вы можете сообщить модулю о своём сертификате CA с помощью параметра ca_path.

Возможные значения:

• false
• true ← (по умолчанию)