NetBox icon

NetBox

Consume NetBox API

Actions243

Power Feed → Update

AI-generated

Overview

This node updates an existing Power Feed record in the NetBox API under the DCIM domain. It is useful for managing power infrastructure in data centers, allowing users to modify attributes of power feeds such as power panel association, name, rack, status, type, supply, phase, voltage, amperage, utilization, connection status, description, tags, and custom fields. For example, a user can update the status of a power feed to 'active' or change its voltage rating.

Use Case Examples

  1. Updating the status and description of a power feed to reflect maintenance work.
  2. Changing the power supply type from AC to DC for a specific power feed.
  3. Adding custom tags to a power feed for better categorization.

Properties

Name Meaning
Domain Specifies the domain of the NetBox API to use, here it is 'dcim' for data center infrastructure management.
Power Feed ID The unique identifier of the power feed record to update.
Update Fields A collection of fields to update on the power feed record, including power panel ID, name, rack ID, status, type, supply, phase, voltage, amperage, max utilization percentage, mark connected flag, description, tags, and custom fields.

Output

JSON

  • id - The unique identifier of the updated power feed record.
  • name - The name of the updated power feed.
  • status - The operational status of the updated power feed.
  • type - The feed type of the updated power feed.
  • supply - The power supply type of the updated power feed.
  • phase - The phase configuration of the updated power feed.
  • voltage - The voltage rating of the updated power feed.
  • amperage - The amperage rating of the updated power feed.
  • max_utilization - The maximum utilization percentage of the updated power feed.
  • description - The description of the updated power feed.
  • tags - Tags associated with the updated power feed.
  • custom_fields - Custom fields data of the updated power feed.

Dependencies

  • NetBox API
  • An API key credential for authentication

Troubleshooting

  • Ensure the Power Feed ID is correct and exists in the NetBox instance to avoid 'not found' errors.
  • Verify that the API key credential is valid and has sufficient permissions to update power feed records.
  • Check that the update fields conform to the expected data types and constraints (e.g., max utilization between 0 and 100).
  • If the node throws an error, enabling 'Continue on Fail' can allow the workflow to proceed while capturing the error message in the output.

Links

Discussion