Ikoula API Dedicated Server icon

Ikoula API Dedicated Server

Interact with Ikoula Dedicated Server API. Developed by Ascenzia - www.ascenzia.fr

DNS Secondary → Modify Secondary DNS

AI-generated

Overview

This node interacts with the Ikoula Dedicated Server API to manage secondary DNS entries among other dedicated server-related resources. Specifically, the "Modify Secondary DNS" operation allows users to update an existing secondary DNS entry for a dedicated server by specifying the server IP, the DNS entry ID, and the new DNS name.

Common scenarios where this node is beneficial include automating DNS management tasks for dedicated servers, such as updating secondary DNS records when infrastructure changes occur or integrating DNS updates into broader server management workflows.

Practical example: A user wants to update the secondary DNS name associated with a particular dedicated server's IP address. By providing the server IP, the ID of the DNS record to modify, and the new DNS name, the node sends the appropriate API request to update the DNS entry seamlessly.

Properties

Name Meaning
Server IP The IP address of the dedicated server on which the secondary DNS entry exists.
DNS ID The unique identifier of the secondary DNS entry to be modified.
DNS Name The new DNS name to assign to the secondary DNS entry.
Response Format The format in which the API response should be returned. Options: JSON, XML.

Output

The node outputs the API response in the specified format (JSON or XML). When JSON is selected, the output is parsed into a JavaScript object under the json field. This typically contains details about the updated secondary DNS entry or any error messages from the API.

If the response format is XML, the raw XML string is provided in the json.data field as a string.

No binary data output is produced by this operation.

Example JSON output structure:

{
  "json": {
    "id": 123,
    "dns_name": "new-secondary.example.com",
    "status": "updated"
  }
}

Dependencies

  • Requires an API key credential for authenticating with the Ikoula API.
  • The node uses RSA public key encryption to encrypt the password before sending it to the API.
  • The base URL for the API defaults to https://api.ikoula.com but can be overridden via credentials.
  • No additional external dependencies beyond standard HTTP requests and cryptographic operations bundled with the node.

Troubleshooting

  • No credentials provided!
    Error occurs if the required API authentication credentials are missing. Ensure that valid credentials with email, password, and optionally API URL are configured in n8n.

  • Invalid DNS ID or Server IP
    If the DNS ID or server IP is incorrect or does not exist, the API will return an error. Verify these values carefully.

  • API response errors
    Errors returned by the API (e.g., permission denied, invalid parameters) will be included in the node output. Review the error message for guidance.

  • Response format issues
    Selecting XML format returns raw XML strings which may require additional parsing downstream.

Links and References


This summary focuses exclusively on the "Modify Secondary DNS" operation within the "DNS Secondary" resource based on the provided source code and property definitions.

Discussion