mirror of
https://github.com/netbox-community/netbox.git
synced 2025-07-18 21:16:27 -06:00
f74a9a1c76
* VLANTranslationPolicy and VLANTranslationRule models and all associated UI classes
* Change VLANTranslationPolicy to a PrimaryModel and make name unique
* Add serializer classes to InterfaceSerializer
* Remake migrations
* Add GraphQL typing
* Skip tagged models in test
* Missing migration
* Remove get_absolute_url methods
* Remove package-lock.json
* Rebuild migration and add constraints and field options
* Rebuild migrations
* Use DynamicModelChoiceField for policy field
* Make vlan_translation_policy fields on filtersets more consistent with existing __name convention
* Add vlan_translation_table to VMInterface detail page
* Add vlan_translation_policy to VMInterfaceSerializer
* Move vlan_translation_policy fields to model and filterset mixins
* Protect in-use policies against deletion
* Add vlan_translation_policy to fields in VMInterfaceSerializer
* Cleanup indentation
* Remove unnecessary ordering column
* Rebuild migrations
* Search methods and registration
* Ensure 'id' column is present by default
* Add graphql types/filters/schema for VLANTranslationRule
* Filterset tests
* View tests
* API and viewset tests (incomplete)
* Add tags to VLANTranslationRuleForm
* Complete viewset tests for VLANTranslationRule
* Make VLANTranslationRule.policy nullable (but still required)
* Revert "Make VLANTranslationRule.policy nullable (but still required)"
This reverts commit 4c1bb437ef.
* Revert nullability
* Explicitly prefetch policy in graphql
* Documentation of new and affected models
* Add note about select_related in graphql
* Rework policy/rule documentation
* Move vlan_translation_policy into 802.1Q Switching fieldset
* Remove redundant InterfaceVLANTranslationTable
* Conditionally include vlan_translation_table in interface.html and vminterface.html
* Add description field to VLANTranslationRule
* Define vlan_translation_table conditionally
* Add policy (name) filter to VLANTranslationRuleFilterSet
* Revert changes to adding-models.md (moved to another PR)
* Dynamic table for linked rules in vlantranslationpolicy.html
* Misc cleanup
---------
Co-authored-by: Jeremy Stretch <jstretch@netboxlabs.com>
63 lines
2.1 KiB
Markdown
63 lines
2.1 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 services attached to them, 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.
|
|
|
|
### MAC Address
|
|
|
|
The 48-bit MAC address (for Ethernet interfaces).
|
|
|
|
### 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.
|
|
|
|
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.
|
|
|
|
### VRF
|
|
|
|
The [virtual routing and forwarding](../ipam/vrf.md) instance to which this interface is assigned.
|
|
|
|
### VLAN Translation Policy
|
|
|
|
The [VLAN translation policy](../ipam/vlantranslationpolicy.md) that applies to this interface (optional).
|