Digital Ocean icon

Digital Ocean

Digital Ocean
Join our community

Actions14

Overview

This node interacts with Digital Ocean's API to manage Droplets and their backups. Specifically, the "Get Backups" operation retrieves backup images associated with a specified Droplet. This is useful for scenarios where you want to automate backup management, audit existing backups, or prepare for recovery operations by listing available backups.

Practical examples include:

  • Automatically fetching all backups of a Droplet before performing updates.
  • Monitoring backup availability and retention policies.
  • Integrating backup data into reporting dashboards or alerting systems.

Properties

Name Meaning
Authentication Method used to authenticate with Digital Ocean: either "Access Token" or "OAuth2".
Droplet Name or ID The identifier (name or ID) of the Droplet whose backups you want to retrieve.
Return All Whether to return all backups or limit the number of results.
Limit Maximum number of backup results to return if "Return All" is false.

Output

The output JSON contains an array of backup objects related to the specified Droplet. Each backup object typically includes metadata such as backup ID, name, creation date, size, and status. This structured data allows further processing or filtering within n8n workflows.

The node does not output binary data for this operation.

Dependencies

  • Requires a valid Digital Ocean API authentication token, either via Access Token or OAuth2.
  • The node depends on the Digital Ocean API endpoints for droplets and backups.
  • No additional external services are required beyond Digital Ocean's API.
  • Proper configuration of credentials in n8n is necessary to authenticate requests.

Troubleshooting

  • Common issues:

    • Providing an invalid or expired API token will result in authentication errors.
    • Specifying a non-existent Droplet ID or name will cause the API to return errors or empty results.
    • Setting both "Return All" to false and a very high "Limit" may lead to partial data retrieval due to API pagination limits.

  • Error messages:

    • Authentication failures usually indicate invalid credentials; verify and update your API key or OAuth2 token.
    • "Droplet not found" errors suggest the provided Droplet identifier is incorrect; double-check the Droplet ID or name.
    • Rate limiting errors from the API can occur if too many requests are made in a short time; implement delays or retries as needed.

Links and References

Discussion