Actions88
- Module Actions
- Platform Actions
- Device Actions
- Device Bay Actions
- Device Bay Template Actions
- Device Role Actions
- Device Type Actions
- Interface Actions
- Manufacturer Actions
- Module Bay Actions
- Module Bay Template Actions
- Module Type Actions
- Region Actions
- Site Actions
- Virtual Chassis Actions
- Virtual Device Context Actions
Overview
This node integrates with the NetBox API, a popular infrastructure resource modeling tool. Specifically, for the Region - Delete operation, it allows users to delete a region record from the NetBox DCIM domain. This is useful in scenarios where regions are no longer relevant or need to be cleaned up from the inventory.
Practical examples include:
- Removing deprecated geographical regions from your data center management system.
- Automating cleanup of regions as part of infrastructure lifecycle management workflows.
Properties
| Name | Meaning |
|---|---|
| Domain | The domain of the NetBox API to interact with. Options include: DCIM, IPAM, Tenancy, Extras, Virtualization, Circuits, Core, Users, Plugins, VPN, Wireless, Status. For this operation, "DCIM" is relevant. |
| Region ID | The unique identifier (ID) of the region to delete within the DCIM domain. This is required to specify which region record to remove. |
Output
The node outputs JSON data representing the result of the delete operation. Typically, this will be an empty response or confirmation that the deletion was successful. If an error occurs, the output JSON will contain an error field with the error message.
No binary data output is involved in this operation.
Dependencies
- Requires connection to a NetBox instance via its REST API.
- Requires an API authentication token credential configured in n8n to authorize requests.
- The node depends on internal helper functions to execute the HTTP DELETE request against the NetBox API endpoint corresponding to the specified region.
Troubleshooting
Common issues:
- Invalid or missing Region ID: Ensure the Region ID provided exists and is correct.
- Insufficient permissions: The API token must have rights to delete regions.
- Network connectivity problems to the NetBox server.
- Incorrect Domain selection (must be "DCIM" for regions).
Error messages:
"404 Not Found": The specified Region ID does not exist."401 Unauthorized"or"403 Forbidden": Authentication failed or insufficient permissions."400 Bad Request": Malformed request, possibly due to invalid parameters.
Resolutions:
- Verify the Region ID is correct by listing regions first.
- Check API credentials and permissions.
- Confirm network access to the NetBox API endpoint.
- Ensure the Domain property is set to "DCIM".