Digital Ocean icon

Digital Ocean

Digital Ocean
Join our community

Actions14

Overview

This node integrates with DigitalOcean's API to manage Droplets and their snapshots. Specifically, the "Get Snapshots" operation retrieves snapshot images associated with a specified Droplet. This is useful for backup management, disaster recovery, or cloning environments.

Common scenarios include:

  • Automating retrieval of all snapshots for a given Droplet to monitor backups.
  • Fetching a limited number of recent snapshots for reporting or auditing.
  • Integrating snapshot data into workflows that manage infrastructure lifecycle.

Example: Automatically fetch all snapshots of a Droplet before performing an update, ensuring you have recent backups.

Properties

Name Meaning
Authentication Method used to authenticate with DigitalOcean API. Options: Access Token, OAuth2
Droplet Name or ID Select or specify the Droplet by name or ID whose snapshots you want to retrieve
Return All Whether to return all available snapshots (true) or limit the number of results (false)
Limit Maximum number of snapshot results to return when "Return All" is false (minimum 1, default 50)

Output

The output is a JSON array where each item represents a snapshot object related to the specified Droplet. Each snapshot object contains metadata such as snapshot ID, name, creation date, size, regions, and other relevant details provided by the DigitalOcean API.

No binary data is output by this operation.

Dependencies

  • Requires a valid DigitalOcean API authentication token, either via Access Token or OAuth2.
  • The node depends on the DigitalOcean API endpoints for droplets and snapshots.
  • No additional external services are required beyond DigitalOcean.
  • Proper credentials must be configured in n8n for authentication.

Troubleshooting

  • Error: Both Tag Name and Name specified — This error occurs if filtering options conflict; ensure only one filter is used when retrieving droplets.
  • API Rate Limits — If many requests are made rapidly, DigitalOcean may throttle API calls. Use "Return All" judiciously or implement delays.
  • Invalid Droplet ID or Name — Ensure the Droplet identifier exists and is accessible with your credentials.
  • Authentication Failures — Verify that the API key or OAuth2 token is valid and has sufficient permissions.
  • Limit Exceeds Maximum — The API may restrict maximum results per request; use "Return All" to paginate automatically.

Links and References

Discussion