VyOS icon

VyOS

Interact with VyOS router via HTTP API

Actions20

Overview

This node interacts with a VyOS router via its HTTP API, specifically managing system images in this context. The "Delete Image" operation allows users to remove a specified system image from the VyOS router. This is useful for maintaining storage hygiene by removing outdated or unused images, freeing up space, or preparing the system for new image deployments.

Practical examples include:

  • Automatically deleting old backup images after successful deployment of new ones.
  • Cleaning up images that are no longer needed to prevent clutter and potential confusion.
  • Forcing deletion of images that might be locked or require confirmation bypass.

Properties

Name Meaning
Image Name The exact name of the image to delete, as shown in the system's image list.
Force Delete Whether to force deletion without requiring confirmation (true/false).
Format Output Whether to format the output for better readability (true/false).

Note: The "Force Delete" property is specific to the delete operation under the Image resource.

Output

The node outputs JSON data representing the result of the delete operation. This typically includes status information about whether the image was successfully deleted or if any errors occurred. The output is optionally formatted for readability based on the "Format Output" property.

There is no indication that the node outputs binary data for this operation.

Dependencies

  • Requires an API key credential to authenticate with the VyOS router's HTTP API.
  • The node expects the base URL and SSL validation settings to be configured via credentials.
  • No additional external services are required beyond access to the VyOS router API.

Troubleshooting

  • Common Issues:

    • Providing an incorrect or non-existent image name will likely cause the operation to fail.
    • Insufficient permissions or invalid API credentials can lead to authentication errors.
    • Network connectivity issues between n8n and the VyOS router may cause request failures.
    • Trying to delete an image that is currently in use or set as default might be blocked unless "Force Delete" is enabled.

  • Error Messages:

    • Errors related to "image not found" indicate the specified image name does not exist; verify the exact name.
    • Authentication errors suggest checking the API key or credentials configuration.
    • SSL certificate errors can be resolved by enabling the option to ignore SSL issues in credentials if appropriate.
    • If deletion fails due to confirmation requirements, enabling "Force Delete" may resolve the issue.

Links and References

Discussion