netbox-community-netbox/docs/release-notes/version-3.3.md

# NetBox v3.3

## v3.3.0 (FUTURE)

### Breaking Changes

* The `nat_outside` relation on the IP address model now returns a list of zero or more related IP addresses, rather than a single instance (or None).

### Enhancements

* [#1202](https://github.com/netbox-community/netbox/issues/1202) - Support overlapping assignment of NAT IP addresses
* [#5303](https://github.com/netbox-community/netbox/issues/5303) - A virtual machine may be assigned to a site and/or cluster
* [#8222](https://github.com/netbox-community/netbox/issues/8222) - Enable the assignment of a VM to a specific host device within a cluster
* [#8471](https://github.com/netbox-community/netbox/issues/8471) - Add `status` field to Cluster
* [#8495](https://github.com/netbox-community/netbox/issues/8495) - Enable custom field grouping
* [#8995](https://github.com/netbox-community/netbox/issues/8995) - Enable arbitrary ordering of REST API results
* [#9166](https://github.com/netbox-community/netbox/issues/9166) - Add UI visibility toggle for custom fields

### Other Changes

* [#9261](https://github.com/netbox-community/netbox/issues/9261) - `NetBoxTable` no longer automatically clears pre-existing calls to `prefetch_related()` on its queryset
* [#9434](https://github.com/netbox-community/netbox/issues/9434) - Enabled `django-rich` test runner for more user-friendly output

### REST API Changes

* extras.CustomField
    * Added `group_name` and `ui_visibility` fields
* ipam.IPAddress
    * The `nat_inside` field no longer requires a unique value
    * The `nat_outside` field has changed from a single IP address instance to a list of multiple IP addresses
* virtualization.Cluster
    * Added required `status` field (default value: `active`)
* virtualization.VirtualMachine
    * Added `device` field
    * The `site` field is now directly writable (rather than being inferred from the assigned cluster)
    * The `cluster` field is now optional. A virtual machine must have a site and/or cluster assigned.
Closes #8995: Enable arbitrary ordering of REST API results 2022-04-08 16:00:33 -04:00			`# NetBox v3.3`

			`## v3.3.0 (FUTURE)`

Closes #1202: Support overlapping assignment of NAT IP addresses 2022-05-11 16:22:07 -04:00			`### Breaking Changes`

			* The `nat_outside` relation on the IP address model now returns a list of zero or more related IP addresses, rather than a single instance (or None).

Closes #8995: Enable arbitrary ordering of REST API results 2022-04-08 16:00:33 -04:00			`### Enhancements`

Closes #1202: Support overlapping assignment of NAT IP addresses 2022-05-11 16:22:07 -04:00			`* [#1202](https://github.com/netbox-community/netbox/issues/1202) - Support overlapping assignment of NAT IP addresses`
Closes #5303: A virtual machine may be assigned to a site and/or cluster 2022-05-26 14:59:49 -04:00			`* [#5303](https://github.com/netbox-community/netbox/issues/5303) - A virtual machine may be assigned to a site and/or cluster`
Closes #8222: Enable the assignment of a VM to a specific host device within a cluster 2022-05-25 16:01:10 -04:00			`* [#8222](https://github.com/netbox-community/netbox/issues/8222) - Enable the assignment of a VM to a specific host device within a cluster`
Closes #8471: Add status field to Cluster 2022-05-19 16:13:22 -04:00			* [#8471](https://github.com/netbox-community/netbox/issues/8471) - Add `status` field to Cluster
Closes #8495: Enable custom field grouping 2022-04-15 14:45:28 -04:00			`* [#8495](https://github.com/netbox-community/netbox/issues/8495) - Enable custom field grouping`
Closes #8995: Enable arbitrary ordering of REST API results 2022-04-08 16:00:33 -04:00			`* [#8995](https://github.com/netbox-community/netbox/issues/8995) - Enable arbitrary ordering of REST API results`
Changelog & cleanup for #9166 2022-05-24 16:39:05 -04:00			`* [#9166](https://github.com/netbox-community/netbox/issues/9166) - Add UI visibility toggle for custom fields`
Closes #8495: Enable custom field grouping 2022-04-15 14:45:28 -04:00
Closes #9261: NetBoxTable no longer automatically clears pre-existing calls to prefetch_related() on its queryset 2022-04-29 13:09:39 -04:00			`### Other Changes`

			* [#9261](https://github.com/netbox-community/netbox/issues/9261) - `NetBoxTable` no longer automatically clears pre-existing calls to `prefetch_related()` on its queryset
Closes #9434: Enabled django-rich test runner for more user-friendly output 2022-06-09 11:48:32 -04:00			* [#9434](https://github.com/netbox-community/netbox/issues/9434) - Enabled `django-rich` test runner for more user-friendly output
Closes #9261: NetBoxTable no longer automatically clears pre-existing calls to prefetch_related() on its queryset 2022-04-29 13:09:39 -04:00
Closes #8495: Enable custom field grouping 2022-04-15 14:45:28 -04:00			`### REST API Changes`

			`* extras.CustomField`
Changelog & cleanup for #9166 2022-05-24 16:39:05 -04:00			* Added `group_name` and `ui_visibility` fields
Closes #1202: Support overlapping assignment of NAT IP addresses 2022-05-11 16:22:07 -04:00			`* ipam.IPAddress`
			* The `nat_inside` field no longer requires a unique value
			* The `nat_outside` field has changed from a single IP address instance to a list of multiple IP addresses
Closes #8471: Add status field to Cluster 2022-05-19 16:13:22 -04:00			`* virtualization.Cluster`
Closes #8222: Enable the assignment of a VM to a specific host device within a cluster 2022-05-25 16:01:10 -04:00			* Added required `status` field (default value: `active`)
			`* virtualization.VirtualMachine`
			* Added `device` field
Closes #5303: A virtual machine may be assigned to a site and/or cluster 2022-05-26 14:59:49 -04:00			* The `site` field is now directly writable (rather than being inferred from the assigned cluster)
			* The `cluster` field is now optional. A virtual machine must have a site and/or cluster assigned.