Ikoula API VeeamInstall

Overview

This node integrates with the Ikoula Veeam API to manage backup operations and policies. Specifically, the Assign Backup Policy operation allows users to assign an existing backup policy to a particular backup agent within a Veeam subscription.

Typical use cases include automating backup management workflows such as:

• Assigning predefined backup policies to new or existing backup agents.
• Streamlining backup configuration across multiple agents in a subscription.
• Integrating backup policy assignment into larger automation pipelines for IT infrastructure management.

For example, after creating a backup policy, you can use this node to assign that policy to a specific backup agent automatically, ensuring consistent backup settings without manual intervention.

Properties

Output

The node outputs the API response from the Ikoula Veeam service in the selected 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 success or failure of the policy assignment operation.

If XML is selected, the raw XML response is provided as a string inside the json.data field.

No binary data output is produced by this operation.

Example JSON output structure (simplified):

{
  "json": {
    "status": "success",
    "message": "Backup policy assigned successfully",
    "data": {
      "backupId": 123,
      "policyId": "policy-abc-123"
    }
  }
}

Dependencies

• Requires valid credentials for the Ikoula Veeam API, including email, password, and optionally a custom API URL.
• The password is encrypted using RSA public key encryption before being sent.
• The node makes HTTP requests to the Ikoula API endpoints.
• No additional external dependencies beyond standard n8n credential and HTTP request helpers.

Troubleshooting

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

• Invalid Subscription ID, Backup ID, or Policy ID
  If any of these IDs are incorrect or do not exist, the API may return errors indicating resource not found or invalid parameters. Verify the IDs before running the node.

• API Response Errors
  The node returns the API's error messages in the output JSON. Common issues might include permission errors, invalid policy assignment, or network connectivity problems. Review the message for guidance.

• Response Format Issues
  Selecting XML format requires handling XML output downstream. If your workflow expects JSON, ensure the format property is set accordingly.

Links and References

• Ikoula Veeam API Documentation (example placeholder, replace with actual if available)
• Veeam Backup & Replication Documentation
• n8n HTTP Request Node Documentation (for understanding underlying HTTP calls)

This summary covers the static analysis of the node’s execute method focusing on the Backup resource and Assign Backup Policy operation.