Files
netbox/docs/models/dcim/rackreservation.md

1.4 KiB

Rack Reservations

Users can reserve specific units within a rack for future use. An arbitrary set of units within a rack can be associated with a single reservation, but reservations cannot span multiple racks. A description is required for each reservation, reservations may optionally be associated with a specific tenant.

Fields

Rack

The rack being reserved.

Units

The rack unit or units being reserved. Multiple units can be expressed using commas and/or hyphens. For example, 1,3,5-7 specifies units 1, 3, 5, 6, and 7.

Total U's

A calculated (read-only) field that reflects the total number of units in the reservation. Can be filtered upon using unit_count_min and unit_count_max parameters in the UI or API.

Status

The current status of the reservation. (This is for documentation only: The status of a reservation has no impact on the installation of devices within a reserved rack unit.)

!!! tip Additional statuses may be defined by setting RackReservation.status under the FIELD_CHOICES configuration parameter.

User

The NetBox user account associated with the reservation. Note that users with sufficient permission can make rack reservations for other users.

Description

Every rack reservation must include a description of its purpose.