CloudAlly icon

CloudAlly

Work with the CloudAlly API

Actions5

Overview

This node integrates with the CloudAlly API to retrieve information about backup tasks associated with reseller accounts. Specifically, the "Backup Task - Get" operation allows users to fetch details of a particular backup task by specifying its unique Task ID within a reseller's account.

Common scenarios for this node include:

  • Monitoring or auditing backup tasks for specific reseller accounts.
  • Fetching detailed status or metadata of a backup task for reporting or troubleshooting.
  • Integrating backup task data into workflows that automate backup management or alerting.

For example, a user might use this node to get the status of a backup task before triggering a notification if the backup failed or to log backup task details into an external system.

Properties

Name Meaning
Resource Type The type of resource to work with; currently only "Reseller" is supported.
Account Name or ID Select or specify the reseller account by name or ID from which to retrieve the backup task.
Task ID The unique identifier of the backup task to retrieve. This is a required string input.

Output

The node outputs JSON data representing the details of the specified backup task. This typically includes metadata such as task status, timestamps, and other relevant properties returned by the CloudAlly API for that backup task.

If the API supports binary data related to backup tasks (e.g., logs or reports), the node would handle it accordingly, but based on the provided code and properties, the output focuses on JSON structured data describing the backup task.

Dependencies

  • Requires an API key credential for authenticating with the CloudAlly API. This includes an access token and client credentials configured in n8n.
  • The base URL for API requests is https://api.cloudally.com/v2/resellers when working with reseller resources.
  • The node depends on internal utility functions for pagination and loading account options, which interact with the CloudAlly API.

Troubleshooting

  • Missing or invalid Task ID: Since Task ID is required, omitting it or providing an incorrect ID will likely cause errors. Ensure the Task ID is correct and corresponds to an existing backup task.
  • Authentication errors: If API credentials are missing, expired, or incorrect, the node will fail to authenticate. Verify that the API key and client credentials are properly set up in n8n.
  • Account selection issues: If the Account Name or ID is not correctly selected or loaded, the node may not find the backup task. Use the load options feature or provide the exact account ID via expression.
  • API rate limits or connectivity problems: Network issues or hitting API rate limits can cause failures. Check network connectivity and API usage quotas.

Links and References

Discussion