Actions14
Overview
This node interacts with Digital Ocean's API to manage Droplets, which are virtual private servers. The "Get Many" operation for the Droplet resource retrieves multiple Droplets based on optional filters such as name or tag. It supports fetching all droplets or limiting the number of results returned.
Common scenarios include:
- Listing all active Droplets in a Digital Ocean account.
- Filtering Droplets by specific names or tags to organize or audit infrastructure.
- Integrating with workflows that require up-to-date information about server instances.
Example use case: Automatically retrieve and process all Droplets tagged with "production" to monitor their status or perform batch operations.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method used to authenticate with Digital Ocean API. Options: Access Token, OAuth2 |
| Return All | Whether to return all matching Droplets or limit the number of results |
| Limit | Maximum number of Droplets to return when "Return All" is false (minimum 1, default 50) |
| Additional Fields | Optional filters to narrow down results: |
| - Name | Only return Droplets with this exact name |
| - Tag Name | Only return Droplets with this specific tag |
Note: The API does not allow filtering by both Name and Tag Name simultaneously; users must choose one.
Output
The output is an array of JSON objects representing Droplets. Each object contains detailed information about a Droplet as returned by the Digital Ocean API, including but not limited to its ID, name, region, size, image, status, and tags.
No binary data is output by this operation.
Dependencies
- Requires a valid Digital Ocean API authentication credential, either via an access token or OAuth2.
- The node uses internal helper functions to handle pagination and API requests to Digital Ocean endpoints.
- No additional external dependencies beyond the Digital Ocean API and n8n environment.
Troubleshooting
- Error when using both Name and Tag Name filters: The node throws an error because the Digital Ocean API does not support filtering by both simultaneously. To fix, remove one of these filters.
- Limit exceeding 200: If the limit is set above 200, the node automatically fetches all items using pagination. Users should be aware of potential longer execution times.
- Authentication errors: Ensure the provided API key or OAuth2 credentials are valid and have sufficient permissions.
- Empty results: Verify that the filter criteria (Name or Tag Name) match existing Droplets in the account.