netbox/docs/release-notes/version-3.6.md

NetBox v3.6

v3.6.0 (FUTURE)

Breaking Changes

• PostgreSQL 11 is no longer supported (due to adopting Django 4.2). NetBox v3.6 requires PostgreSQL 12 or later.
• The device_role field on the Device model has been renamed to role. The device_role field has been temporarily retained on the REST API serializer for devices for backward compatibility, but is read-only.
• The choices array field has been removed from the CustomField model. Any defined choices are automatically migrated to CustomFieldChoiceSets, accessible via the new choice_set field on the CustomField model.
• The napalm_driver and napalm_args fields (which were deprecated in v3.5) have been removed from the Platform model.

New Features

Relocated Admin Views (#12589, #12590, #12591, #13044)

Management views for the following object types, previously available only under the backend admin interface, have been relocated to the primary user interface:

• Users
• Groups
• Object permissions
• API tokens
• Configuration revisions

The admin UI is scheduled for removal in NetBox v4.0.

Configurable Default Permissions (#13038)

Administrators now have the option of configuring a set of default permissions to be applied to all users, regardless of explicit permission or group assignment. This is accomplished by defining the DEFAULT_PERMISSIONS configuration parameter.

User Bookmarks (#8248)

Users can now bookmark their most commonly-visited objects in NetBox. Bookmarks will display both on the dashboard (if configured) and on a user-specific bookmarks view.

Custom Field Choice Sets (#12988)

Select and multi-select custom fields now employ discrete, reusable choice sets containing the valid options for each field. A choice set may be shared by multiple custom fields. Additionally, each choice within a set can now specify both a value and a human-friendly label (see #13241).

Pre-Defined Location Choices for Custom Fields (#12194)

Users now have the option to employ one of several pre-defined choice sets when creating a custom field. These include:

• IATA airport codes
• ISO 3166 country codes
• UN/LOCODE identifiers

Extra choices may also be appended to the pre-defined sets as needed.

Restrict Tag Usage by Object Type (#11541)

Tags may now be restricted to use with designated object types. Tags that have no specific object types assigned may be used with any object that supports tag assignment.

Enhancements

• #6347 - Cache the number of assigned components for devices and virtual machines
• #8137 - Add a field for designating the out-of-band (OOB) IP address for devices
• #10197 - Cache the number of member devices on each virtual chassis
• #11305 - Add GPS coordinate fields to the device model
• #11519 - Add a SQL index for IP address host values to optimize queries
• #11732 - Prevent inadvertent overwriting of object attributes by competing users
• #11936 - Introduce support for tags and custom fields on webhooks
• #12175 - Permit racks to start numbering at values greater than one
• #12210 - Add tenancy assignment for power feeds
• #12882 - Add tag support for contact assignments
• #13170 - Add rf_role to InterfaceTemplate
• #13269 - Cache the number of assigned component templates for device types

Other Changes

• Work has begun on introducing translation and localization support in NetBox. This work is being performed in preparation for release 4.0.
• #6391 - Rename the device_role field on Device to role for consistency with VirtualMachine
• #9077 - Prevent the errant execution of dangerous instance methods in Django templates
• #11766 - Remove obsolete custom ChoiceField and MultipleChoiceField classes
• #12180 - All API endpoints for available objects (e.g. IP addresses) now inherit from a common parent view
• #12237 - Upgrade Django to v4.2
• #12794 - Avoid direct imports of Django's stock user model
• #12320 - Remove obsolete fields napalm_driver and napalm_args from Platform
• #12964 - Drop support for PostgreSQL 11
• #13309 - User account-specific resources have been moved to a new account app for better organization

REST API Changes

• Introduced the following endpoints:
  • /api/extras/bookmarks/
  • /api/extras/custom-field-choice-sets/
• Added the /api/extras/custom-fields/{id}/choices/ endpoint for select and multi-select custom fields
• dcim.Device
  • Renamed device_role to device. Added a read-only device_role field for limited backward compatibility.
  • Added the latitude and longitude fields (for GPS coordinates)
  • Added the oob_ip field for out-of-band IP address assignment
• dcim.DeviceType
  • Added read-only counter fields for assigned component templates:
    • console_port_template_count
    • console_server_port_template_count
    • power_port_template_count
    • power_outlet_template_count
    • interface_template_count
    • front_port_template_count
    • rear_port_template_count
    • device_bay_template_count
    • module_bay_template_count
    • inventory_item_template_count
• dcim.InterfaceTemplate
  • Added the rf_role field
• dcim.Platform
  • Removed the napalm_driver and napalm_args fields
• dcim.PowerFeed
  • Added the tenant field
• dcim.Rack
  • Added the starting_unit field
• dcim.VirtualChassis
  • Added the read-only member_count field
• extras.CustomField
  • Removed the choices array field
  • Added the choice_set foreign key field (to ChoiceSet)
• extras.Tag
  • Added the object_types field for optional restriction to specific object types
• extras.Webhook
  • Added custom_fields and tags support
• tenancy.ContactAssignment
  • Added tags support
• virtualization.VirtualMachine
  • Added the oob_ip field for out-of-band IP address assignment