Ikoula API Dedicated Server icon

Ikoula API Dedicated Server

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

Actions32

Security Scan → Cancel Security Scan

AI-generated

Overview

This node interacts with the Ikoula Dedicated Server API to manage security scans on dedicated servers. Specifically, the "Cancel Security Scan" operation allows users to cancel an ongoing or scheduled security scan on a server identified by its IP address and scan ID. Users can specify how the cancellation should be handled (e.g., stop immediately, pause, restart) and optionally reschedule the scan for a new date.

Practical scenarios include:

  • Stopping a security scan that is no longer needed or was started by mistake.
  • Pausing a scan temporarily due to server load or maintenance.
  • Rescheduling a scan to a more convenient time without losing the scan configuration.

Example use case: A system administrator wants to abort a running security scan on a server because urgent maintenance is required. They use this node to send a cancellation request with the "Stop" action.

Properties

Name Meaning
Server IP The IP address of the dedicated server where the security scan is running.
Scan ID The unique identifier of the security scan to be canceled.
Cancel Type The type of cancellation action to perform. Options: Abort Delayed, Pause, Restart, Restart Delayed, Stop, Update Delayed.
New Date Optional new date/time to reschedule the scan if applicable. Format: YYYY-MM-DD HH:mm:ss.
Response Format The format of the API response. Options: JSON, XML. Defaults to JSON.

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 response typically contains information about the result of the cancellation request, such as confirmation of the action or error details.

No binary data output is produced by this operation.

Example output structure (JSON):

{
  "json": {
    "status": "success",
    "message": "Security scan canceled successfully",
    "scanId": 12345,
    "cancelType": "STOP"
  }
}

Dependencies

  • Requires valid credentials for the Ikoula API, including email, password, and optionally a custom API URL.
  • The node uses RSA public key encryption to secure the password before sending it to the API.
  • Network connectivity to the Ikoula API endpoint (https://api.ikoula.com by default).
  • No additional external dependencies beyond standard n8n HTTP request helpers.

Troubleshooting

  • No credentials provided!
    Error thrown if the node is executed without proper API credentials configured. Ensure that the API authentication details are set up correctly in n8n.

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

  • Unsupported Cancel Type
    Using an invalid cancel type option may cause the API to reject the request. Use one of the predefined options exactly as listed.

  • Date Format Issues
    If specifying a new date, ensure it matches the required format YYYY-MM-DD HH:mm:ss. Incorrect formatting may lead to API errors.

  • API Connectivity Problems
    Network issues or incorrect API URL configuration can prevent successful requests. Confirm network access and API endpoint correctness.

Links and References

Discussion