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 various aspects of virtual private servers (VPS). Specifically, for the VPS DNS Secondary resource and the Add Secondary DNS operation, it allows users to add a new secondary DNS entry to a VPS server by specifying the server IP and the DNS name to add.

Common scenarios where this node is beneficial include automating DNS management tasks for VPS instances, such as adding secondary DNS entries programmatically during deployment or configuration changes. For example, when setting up redundancy or failover DNS configurations, this node can be used to add secondary DNS records without manual intervention.

Properties

Name Meaning
Subscription ID The VPS subscription ID (number). Required for most operations except listing services.
Server IP The IP address of the VPS server where the secondary DNS will be managed.
DNS Name The DNS name to add or modify as a secondary DNS entry.
Response Format The format of the API response. Options: JSON or XML. Default is JSON.

Output

The node outputs an array of JSON objects corresponding to each input item processed. Each output item contains a json field with the API response data:

  • For the Add Secondary DNS operation, the json field includes the result of the API call confirming the addition of the secondary DNS entry.
  • If the response format is XML, the raw XML string is returned inside the data property of the json object.
  • In case of errors (if "Continue On Fail" is enabled), the output includes an error message in the json.error field.

No binary data output is produced by this node.

Dependencies

  • Requires an API key credential for authenticating with the Ikoula VPS API.
  • The node uses RSA public key encryption to encrypt the password before sending requests.
  • The base URL for the API defaults to https://api.ikoula.com but can be overridden via credentials.
  • Proper network access to the Ikoula API endpoint is necessary.

Troubleshooting

  • No credentials provided!
    This error occurs if the required API authentication credentials are missing. Ensure that valid API credentials are configured in n8n before running the node.

  • API request failures
    Errors from the Ikoula API may occur due to invalid parameters (e.g., incorrect server IP or DNS name), network issues, or permission problems. Verify all input properties and network connectivity.

  • Incorrect response format
    If the response format is set to XML but downstream nodes expect JSON, parsing errors may occur. Choose the appropriate response format based on your workflow needs.

  • Encryption issues
    The node encrypts the password using a hardcoded RSA public key. If the API changes its key or encryption method, authentication will fail. Update the node accordingly if needed.

Links and References

Discussion