Ikoula VPS API icon

Ikoula VPS API

Interact with Ikoula VPS API. Developed by Ascenzia - www.ascenzia.fr
Join our community

Actions25

Overview

This node integrates with the Ikoula VPS API to manage virtual private servers (VPS) and their snapshots. Specifically, the "Rollback to Snapshot" operation under the "VPS Snapshot" resource allows users to revert a VPS to a previously saved snapshot state. This is useful for restoring a server to a known good configuration after changes or issues.

Common scenarios include:

  • Quickly recovering from a failed update or configuration change by rolling back to a stable snapshot.
  • Testing software or configurations on a VPS and then reverting to the original state.
  • Managing VPS lifecycle by creating, listing, rolling back, or deleting snapshots programmatically.

Example: A user can automate rollback of a VPS to a snapshot named "pre-update" if a deployment causes issues, ensuring minimal downtime.

Properties

Name Meaning
Subscription ID The unique numeric identifier of the VPS subscription to operate on.
Snapshot Name The name of the snapshot to rollback to.
Response Format The format in which the API response is returned. Options: JSON, XML.

Output

The node outputs the API response in the chosen format (json or xml) inside the json field of the output item. For JSON responses, the data is parsed into an object; for XML, it is returned as a string under the data property.

The output structure typically contains details about the rollback operation status or any error messages returned by the API.

No binary data output is produced by this operation.

Dependencies

  • Requires valid credentials for the Ikoula VPS API, including email, password, and optionally a custom API URL.
  • The password is encrypted using RSA public key encryption before being sent.
  • The node makes HTTP requests to the Ikoula API endpoints.
  • No additional external dependencies beyond standard n8n helpers and Node.js crypto module.

Troubleshooting

  • No credentials provided!
    Error thrown if the required API credentials are missing. Ensure that the node has been configured with valid Ikoula API credentials.

  • API request failures
    Could be due to invalid subscription ID, snapshot name, network issues, or incorrect permissions. Verify input parameters and API access rights.

  • Incorrect snapshot name
    If the snapshot name does not exist or is misspelled, the API will return an error. Double-check the snapshot name before rollback.

  • Response format issues
    Selecting XML format returns raw XML string; ensure downstream nodes can handle XML or choose JSON for easier parsing.

Links and References

Discussion