Actions243
- Cable Actions
- Cable Termination Actions
- Connected Device Actions
- Console Port Actions
- Console Port Template Actions
- Console Server Port Actions
- Console Server Port Template Actions
- Device Actions
- Device Bay Actions
- Device Bay Template Actions
- Device Role Actions
- Device Type Actions
- Front Port Actions
- Front Port Template Actions
- Interface Actions
- Interface Template Actions
- Inventory Item Actions
- Inventory Item Role Actions
- Inventory Item Template Actions
- Location Actions
- MAC Address Actions
- Manufacturer Actions
- Module Actions
- Module Bay Actions
- Module Bay Template Actions
- Module Type Actions
- Module Type Profile Actions
- Platform Actions
- Power Feed Actions
- Power Outlet Actions
- Power Outlet Template Actions
- Power Panel Actions
- Power Port Actions
- Power Port Template Actions
- Rack Actions
- Rack Reservation Actions
- Rack Role Actions
- Rack Type Actions
- Rear Port Actions
- Rear Port Template Actions
- Region Actions
- Site Actions
- Site Group Actions
- Virtual Chassis Actions
- Virtual Device Context Actions
- Virtual Link Actions
Rack Reservation → Create
AI-generatedOverview
This node interacts with the NetBox API to create a rack reservation within the DCIM domain. It is useful for automating the process of reserving specific units in a rack for a user, including optional details like tenant, tags, and custom fields. Practical examples include reserving rack units for new hardware installations or managing rack space allocation in data centers.
Use Case Examples
- Reserve units 1, 2, and 3 in rack ID 10 for user ID 5 with a description 'Reserved for new servers'.
- Create a rack reservation with additional tenant information and tags for better organization.
Properties
| Name | Meaning |
|---|---|
| Domain | Specifies the domain of the NetBox API to use, here it is 'dcim' for data center infrastructure management. |
| Rack ID | The identifier of the rack where units are to be reserved. |
| Units | Comma-separated list of unit numbers to reserve in the rack. |
| User ID | The identifier of the user for whom the rack units are reserved. |
| Description | A textual description of the rack reservation. |
| Additional Fields | Optional additional information such as Tenant ID, Tags, and Custom Fields in JSON format. |
Output
JSON
id- Unique identifier of the created rack reservation.rack_id- ID of the rack where the reservation was made.units- List of reserved unit numbers.user_id- ID of the user associated with the reservation.description- Description provided for the reservation.tenant- Tenant ID if specified.tags- Tags associated with the reservation.custom_fields- Custom fields data in JSON format.
Dependencies
- NetBox API
- API key credential for authentication
Troubleshooting
- Ensure the Rack ID and User ID are valid and exist in the NetBox system to avoid errors.
- Verify that the units specified are available and not already reserved to prevent conflicts.
- Check API credentials and permissions if authentication errors occur.
- If the node throws an error, enabling 'Continue on Fail' will output the error message as JSON instead of stopping execution.
Links
- NetBox API Documentation - Official documentation for the NetBox API, useful for understanding available endpoints and data structures.