Ikoula API Dedicated ServerInstall

Overview

This node interacts with the Ikoula Dedicated Server API to manage network boot (netboot) operations among other server management tasks. Specifically, for the Network Boot - Cancel Netboot operation, it allows users to cancel a previously requested netboot on a dedicated server identified by its IP address and a netboot ID.

Typical use cases include:

• Cancelling a netboot request if it was made in error or is no longer needed.
• Managing server boot states remotely via API calls.
• Integrating server lifecycle management into automated workflows.

For example, if you have scheduled a netboot to troubleshoot a server but decide to abort it before it executes, this node can send the cancellation request to the Ikoula API.

Properties

Output

The node outputs the response from the Ikoula API after attempting to cancel the netboot request. The output is available in the json field of the node's output data and contains either:

• A JSON object representing the API response confirming the cancellation or providing details about the cancellation status.
• If the response format is set to XML, the raw XML string is wrapped inside the data property of the JSON output.

No binary data is produced by this operation.

Example output structure (in JSON mode):

{
  "json": {
    // API response fields indicating success or failure of cancellation
  }
}

Dependencies

• Requires an API key credential for authenticating with the Ikoula Dedicated Server API.
• The node uses the Ikoula API endpoint, defaulting to https://api.ikoula.com unless overridden in credentials.
• The password used for authentication is encrypted using RSA public key encryption before sending.
• No additional external dependencies beyond standard HTTP requests and cryptographic functions bundled with n8n.

Troubleshooting

• No credentials provided!
  This error occurs if the node is executed without valid API credentials configured. Ensure you have set up the required API authentication token in n8n credentials.

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

• API Response Errors
  The node passes through any errors returned by the Ikoula API. Common issues might include permission denied, invalid request format, or resource not found. Check the API response message for details.

• Network Issues
  Connectivity problems to the Ikoula API endpoint may cause timeouts or failures. Confirm network access and correct API URL configuration.

Links and References

• Ikoula Dedicated Server API Documentation (general reference for API endpoints and usage)
• n8n Documentation for general guidance on setting up credentials and using HTTP Request nodes.

This summary focuses solely on the Network Boot - Cancel Netboot operation as requested.