netbox/docs/models/dcim/rackreservation.md

1.2 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.

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.