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 List Secondary DNS operation, it retrieves a list of all secondary DNS entries associated with a given server IP address. This is useful for users who need to programmatically view or audit their secondary DNS configurations on Ikoula VPS servers.

Practical scenarios include:

  • Automating DNS management workflows by fetching current secondary DNS records.
  • Integrating DNS data retrieval into monitoring or reporting systems.
  • Preparing data for further DNS modifications or validations.

Properties

Name Meaning
Subscription ID The VPS subscription ID (not used in this operation but relevant for other operations).
Server IP The IP address of the server whose secondary DNS entries you want to list.
Response Format The format of the API response; can be either JSON or XML.

Output

The node outputs an array of items where each item contains a json property holding the API response data.

  • For the List Secondary DNS operation, the json field contains the list of secondary DNS entries retrieved from the Ikoula VPS API.
  • If the response format is JSON, the output will be parsed JSON objects representing the DNS entries.
  • If the response format is XML, the raw XML string is returned inside the data property of the JSON output.
  • No binary data is produced by this node.

Example output structure (simplified):

[
  {
    "json": {
      "secondaryDnsEntries": [
        {
          "id": 123,
          "dns_name": "example-secondary-dns.com",
          "other_properties": "..."
        },
        ...
      ]
    }
  }
]

Dependencies

  • Requires an API key credential for authenticating with the Ikoula VPS API.
  • 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.
  • The node uses HTTP requests with appropriate headers depending on the requested response format.

Troubleshooting

  • No credentials provided!: The node requires valid API credentials to authenticate. Ensure that the API key credential is configured correctly in n8n.
  • Invalid server IP or subscription ID: Providing incorrect or missing server IP may cause the API to return errors or empty results.
  • Unsupported response format: Only json and xml are supported. Selecting an unsupported format will cause request failures.
  • API errors: If the API returns an error (e.g., unauthorized, not found), the node will throw an error unless "Continue On Fail" is enabled, in which case the error message will be included in the output JSON.
  • Encryption issues: The password is encrypted using a fixed RSA public key. If the API changes its key or encryption method, authentication will fail.

Links and References

If you need details about other resources or operations, feel free to ask!

Discussion