Overview

This node interacts with the NetBox API to create a new Power Port resource within the DCIM domain. It is useful for automating the addition of power ports to devices in a data center infrastructure management system. For example, users can specify the device ID and power port name, along with optional fields such as module ID, label, type, maximum and allocated power draw, connection status, description, tags, and custom fields in JSON format.

Use Case Examples

1. Creating a new power port on a specific device by providing the device ID and power port name.
2. Adding detailed attributes to the power port such as type (e.g., IEC 60320 C14), maximum power draw, and custom tags for better inventory management.

Properties

Output

JSON

• id - Unique identifier of the created power port.
• name - Name of the created power port.
• device_id - Identifier of the device to which the power port belongs.
• type - Type of the power port.
• maximum_draw - Maximum power draw in watts.
• allocated_draw - Allocated power draw in watts.
• connected - Connection status of the power port.
• description - Description of the power port.
• tags - Tags associated with the power port.
• custom_fields - Custom metadata fields associated with the power port.

Dependencies

• NetBox API with appropriate authentication credentials

Troubleshooting

• Ensure the device ID provided exists in the NetBox instance; otherwise, the creation will fail.
• Verify that the API credentials have permissions to create power ports in the DCIM domain.
• Check the format of custom fields JSON to avoid parsing errors.
• If 'Continue on Fail' is enabled, errors will be returned as output instead of stopping execution.

Links

• NetBox API Documentation - Power Ports - Official documentation for the Power Ports API endpoint in NetBox.