mirror of
https://github.com/netbox-community/netbox.git
synced 2025-07-21 11:37:21 -06:00
59e1d3a607
* Closes: #18588: Relabel Service model to Application Service Updates the `verbose_name` of the `Service` and `ServiceTemplate` models to "Application Service" and "Application Service Template" respectively. This serves as the foundational change for relabeling the model throughout the user interface to reduce ambiguity. To preserve backward compatibility for the REST and GraphQL APIs, the test suites have been updated to assert the stability of the original field and parameter names. This includes: * Using `filter_name_map` in the filterset test case to ensure API query parameters remain `service` and `service_id`. * Employing the GraphQL test suite's aliasing mechanism to ensure the public schema remains unchanged despite the underlying `verbose_name` modification. Subsequent commits will address UI-specific labels in navigation, tables, forms, and templates. * Rename to Application Services/Application Service Templates in nav menu * Rename ~service to ~'Application Service' in templates This was done for both the Service model and Service Template model appearances in templates where the word was hardcoded. * Change ~service to ~'application service' hardcoded strings in Python files * Update ~service to ~'application service' in docs
75 lines
2.7 KiB
Markdown
75 lines
2.7 KiB
Markdown
## Interfaces
|
|
|
|
[Virtual machine](./virtualmachine.md) interfaces behave similarly to device [interfaces](../dcim/interface.md): They can be assigned to VRFs, may have IP addresses, VLANs, and so on. However, given their virtual nature, they lack properties pertaining to physical attributes. For example, VM interfaces do not have a physical type and cannot have cables attached to them.
|
|
|
|
## Fields
|
|
|
|
### Virtual Machine
|
|
|
|
The [virtual machine](./virtualmachine.md) to which this interface is assigned.
|
|
|
|
### Name
|
|
|
|
The interface's name. Must be unique to the assigned VM.
|
|
|
|
### Parent Interface
|
|
|
|
Identifies the parent interface of a subinterface (e.g. used to employ encapsulation).
|
|
|
|
!!! note
|
|
An interface with one or more child interfaces assigned cannot be deleted until all its child interfaces have been deleted or reassigned.
|
|
|
|
### Bridged Interface
|
|
|
|
An interface on the same VM with which this interface is bridged.
|
|
|
|
### Enabled
|
|
|
|
If not selected, this interface will be treated as disabled/inoperative.
|
|
|
|
### Primary MAC Address
|
|
|
|
The [MAC address](../dcim/macaddress.md) assigned to this interface which is designated as its primary.
|
|
|
|
!!! note "Changed in NetBox v4.2"
|
|
The MAC address of an interface (formerly a concrete database field) is available as a property, `mac_address`, which reflects the value of the primary linked [MAC address](../dcim/macaddress.md) object.
|
|
|
|
### MTU
|
|
|
|
The interface's configured maximum transmissible unit (MTU).
|
|
|
|
### 802.1Q Mode
|
|
|
|
For switched Ethernet interfaces, this identifies the 802.1Q encapsulation strategy in effect. Options include:
|
|
|
|
* **Access:** All traffic is assigned to a single VLAN, with no tagging.
|
|
* **Tagged:** One untagged "native" VLAN is allowed, as well as any number of tagged VLANs.
|
|
* **Tagged (all):** Implies that all VLANs are carried by the interface. One untagged VLAN may be designated.
|
|
* **Q-in-Q:** Q-in-Q (IEEE 802.1ad) encapsulation is performed using the assigned SVLAN.
|
|
|
|
This field must be left blank for routed interfaces which do employ 802.1Q encapsulation.
|
|
|
|
### Untagged VLAN
|
|
|
|
The "native" (untagged) VLAN for the interface. Valid only when one of the above 802.1Q mode is selected.
|
|
|
|
### Tagged VLANs
|
|
|
|
The tagged VLANs which are configured to be carried by this interface. Valid only for the "tagged" 802.1Q mode above.
|
|
|
|
### Q-in-Q SVLAN
|
|
|
|
!!! info "This field was introduced in NetBox v4.2."
|
|
|
|
The assigned service VLAN (for Q-in-Q/802.1ad interfaces).
|
|
|
|
### VRF
|
|
|
|
The [virtual routing and forwarding](../ipam/vrf.md) instance to which this interface is assigned.
|
|
|
|
### VLAN Translation Policy
|
|
|
|
!!! info "This field was introduced in NetBox v4.2."
|
|
|
|
The [VLAN translation policy](../ipam/vlantranslationpolicy.md) that applies to this interface (optional).
|