NetBox icon

NetBox

Consume NetBox API

Actions243

Power Outlet → Create

AI-generated

Overview

This node interacts with the NetBox API to create a new power outlet resource within the DCIM domain. It is useful for automating the management of power outlets associated with devices in a data center or network infrastructure. For example, users can create power outlets by specifying the device ID, outlet name, and additional optional details such as module ID, label, outlet type, feed leg, power port ID, connection status, description, tags, and custom fields.

Use Case Examples

  1. Creating a power outlet for a specific device by providing the device ID and outlet name.
  2. Adding detailed information to a power outlet such as its type (e.g., IEC 60320 C13), physical label, and custom tags for better organization.

Properties

Name Meaning
Domain Specifies the domain of the NetBox API to use, here it is set to 'dcim' for data center infrastructure management.
Device ID The ID of the device to which the power outlet belongs, required to associate the outlet with a device.
Name The name of the power outlet, used to identify it uniquely within the device.
Additional Fields Optional additional details for the power outlet such as module ID, label, type, feed leg, power port ID, connection status, description, tags, and custom fields.

Output

JSON

  • id - Unique identifier of the created power outlet
  • name - Name of the created power outlet
  • device_id - ID of the device the power outlet belongs to
  • type - Type of the power outlet
  • label - Physical label on the power outlet
  • feed_leg - Feed leg for three-phase power
  • power_port - ID of the associated power port
  • mark_connected - Indicates if the outlet is marked as connected
  • description - Description of the power outlet
  • tags - Tags associated with the power outlet
  • custom_fields - Custom metadata fields associated with the power outlet

Dependencies

  • NetBox API
  • API key credential for authentication

Troubleshooting

  • Common issues include invalid device ID or missing required fields such as the power outlet name, which will cause API errors.
  • Errors related to authentication failure if the API key credential is incorrect or missing.
  • Network connectivity issues to the NetBox API endpoint can cause request failures.

Links

Discussion