AvantGuard - WebhookSite icon

AvantGuard - WebhookSite

AvantGuard - WebhookSite

Actions100

Overview

This node allows users to create (post) new rack storage items in a system that manages rack storage resources. It is useful for scenarios where you need to programmatically add detailed information about physical or logical storage units within racks, such as in data centers or inventory management systems.

Practical examples include:

  • Adding a new asset to a specific rack location with details like start and end unit positions.
  • Defining power characteristics and status of a rack storage item.
  • Associating roles and metadata such as color coding or reserved messages to rack storage units.

Properties

Name Meaning
Additional Body Fields Optional fields to specify detailed attributes of the rack storage item. These include:
- Id The unique ID of the rack storage item.
- Rack Storage Role Id The unique ID of the rack storage role.
- Asset Id The unique ID of the asset associated with the rack storage item.
- Start Unit The starting unit position of the rack storage item within the rack.
- End Unit The ending unit position of the rack storage item within the rack.
- Status The status code representing the current state of the rack storage item.
- Side The side of the rack where the storage item is located.
- Max Wattage The maximum wattage capacity of the rack storage item.
- Power Draw The actual power draw of the rack storage item.
- Rack Storage Role Name The name of the rack storage role.
- Reserved Message A message indicating reservation status or notes for the rack storage item.
- Rack Storage Role Description A textual description of the rack storage role.
- Rack Storage Role Hex Color The hex color code associated with the rack storage role (for UI or categorization).
- Asset Name The name of the asset linked to the rack storage item.
- Asset Url The URL providing more information about the asset.
- Url The URL related to the rack storage item itself.
- Company Id The unique ID of the company owning or managing the rack storage item.

All these fields are optional and can be added as needed to provide comprehensive details when creating a rack storage item.

Output

The node outputs JSON data representing the newly created rack storage item, including all the properties sent in the request and any additional data returned by the API after creation.

If the node supports binary data output, it would typically represent attachments or files related to the rack storage item, but based on the provided information, this node primarily deals with JSON data.

Dependencies

  • Requires an API key or authentication token configured in n8n credentials to connect to the backend service managing rack storage items.
  • Depends on the base URL and headers set in the node's configuration to communicate with the external API.
  • Uses the @avantguardllc/n8n-openapi-node package for OpenAPI-based request building and execution.

Troubleshooting

  • Common Issues:

    • Missing or invalid authentication credentials will cause authorization errors.
    • Providing invalid or incomplete field values (e.g., negative numbers for unit positions) may result in validation errors from the API.
    • Network connectivity issues can prevent successful API calls.

  • Error Messages:

    • Authorization errors typically indicate missing or incorrect API keys; verify credential setup.
    • Validation errors will specify which fields are incorrect or missing; review input property values accordingly.
    • Timeout or network errors suggest connectivity problems; check your internet connection and API endpoint availability.

Links and References

  • Refer to the API documentation of the rack storage management system for detailed descriptions of each field and their valid values.
  • n8n documentation on creating custom nodes for further customization guidance.
  • OpenAPI specification used by the node can provide insight into supported operations and schemas.

Discussion