Query options customize the results returned by a query method. More complete documentation with examples are covered in the "Query methods" section of the TrueNAS API documentation.
No Additional PropertiesExtra options are defined on a per-endpoint basis and are described in the documentation for the associated query method.
An array of field names describing the manner in which query results should be ordered. The field names may also have one of more of the following special prefixes: - (reverse sort direction), nulls_first: (place any null values at the head of the results list), nulls_last: (place any null values at the tail of the results list).
[
"size",
"-devname",
"nulls_first:-expiretime"
]
An array of field names specifying the exact fields to include in the query return. The dot character . may be used to explicitly select only subkeys of the query result.
[
"username",
"Authentication.status"
]
Return a numeric value representing the number of items that match the specified query-filters.
Return the JSON object of the first result matching the specified query-filters. The query fails if there specified query-filters return no results.
This specifies the beginning offset of the results array. When combined with the limit query-option it may be used to implement pagination of large results arrays. WARNING: some query methods provide volatile results and the onus is on the developer to understand whether pagination is appropriate for a particular query API method.
This specifies the maximum number of results matching the specified query-filters to return. When combined wtih the offset query-option it may be used to implement pagination of large results arrays.
WARNING: Some query methods provide volatile results and the onus is on the developer to understand whether pagination is appropriate for a particular query API method.
Force use of SQL for result filtering to reduce response time. May not work for all methods.
Unique identifier for the network interface.
Name of the network interface.
Whether this is a fake/simulated interface for testing purposes.
Type of interface (PHYSICAL, BRIDGE, LINK_AGGREGATION, VLAN, etc.).
Current runtime state information for the interface.
No Additional PropertiesCurrent name of the network interface.
Original name of the network interface before any renaming.
Human-readable description of the network interface.
Maximum transmission unit size for the interface.
Whether the interface is a cloned/virtual interface.
List of interface flags indicating various states and capabilities. Common flags include UP, DOWN, RUNNING, MULTICAST, BROADCAST, LOOPBACK, and POINTOPOINT.
No Additional ItemsIPv6 neighbor discovery flags. These control IPv6 autoconfiguration behavior and include flags like AUTOLINKLOCAL, ACCEPTRTADV, and PERFORMNUD.
No Additional ItemsList of hardware capabilities supported by the interface. Common capabilities include VLANMTU, JUMBOMTU, VLANHWTAGGING, VLANHWCSUM, and TSO4.
No Additional ItemsCurrent link state of the interface (up, down, etc.).
Type of media/connection for the interface. Examples include Ethernet, 802.11, or loopback.
Subtype of media/connection for the interface. Examples include 1000baseT, 100baseTX, or autoselect.
Currently active media type. This may differ from configured media_type during autonegotiation.
Currently active media subtype. This reflects the actual negotiated connection speed and type.
List of supported media types for the interface. Contains media descriptors like '1000baseT <full-duplex>' or 'autoselect'.
No Additional ItemsAvailable media options for the interface. Options may include 'full-duplex', 'half-duplex', 'flowcontrol', or 'rxpause'.
MAC address of the interface.
Permanent MAC address of the interface if different from current.
Hardware MAC address of the interface.
Number of receive queues configured for the interface.
Number of transmit queues configured for the interface.
List of IP address aliases configured on the interface.
No Additional ItemsThe type of IP address (INET for IPv4, INET6 for IPv6).
The IP address value.
The network mask for the IP address, either as a string or CIDR notation integer.
Broadcast address for the network interface.
VRRP (Virtual Router Redundancy Protocol) configuration for the interface.
Link aggregation protocol used (LACP, FAILOVER, etc.).
List of ports that are members of this link aggregation group.
No Additional ItemsThe name of the port interface.
List of flags associated with the port.
No Additional ItemsTransmit hash policy for load balancing in link aggregation. LAYER2 uses MAC addresses, LAYER2+3 adds IP addresses, and LAYER3+4 includes TCP/UDP ports for distribution.
LACP data unit transmission rate. SLOW sends LACPDUs every 30 seconds, FAST sends every 1 second for quicker link failure detection.
Parent interface for VLAN configuration.
VLAN tag number.
Priority Code Point for VLAN traffic prioritization. Values 0-7 map to different QoS priority levels, with 0 being lowest and 7 highest priority.
List of IP address aliases configured on the interface.
No Additional ItemsThe type of IP address (INET for IPv4, INET6 for IPv6).
The IP address value.
The network mask for the IP address, either as a string or CIDR notation integer.
Whether IPv4 DHCP is enabled for automatic IP address assignment.
Whether IPv6 autoconfiguration is enabled.
Human-readable description of the interface.
Maximum transmission unit size for the interface.
Parent interface for VLAN configuration.
VLAN tag number for VLAN interfaces.
Priority Code Point for VLAN traffic prioritization.
Link aggregation protocol (LACP, FAILOVER, LOADBALANCE, etc.).
List of interface names that are members of this link aggregation group.
No Additional ItemsList of interface names that are members of this bridge.
No Additional ItemsWhether MAC address learning is enabled for bridge interfaces.
Additional Properties of any type are allowed.
Type: object