Digital Ocean icon

Digital Ocean

Digital Ocean
Join our community

Actions14

Overview

This node integrates with Digital Ocean's API to manage Droplets, which are virtual private servers. Specifically, the "Get" operation for the "Droplet" resource retrieves detailed information about one or more Droplets by their ID or name. This is useful for scenarios where you want to fetch the current state, configuration, or metadata of a specific Droplet or list multiple Droplets for monitoring, reporting, or automation purposes.

Practical examples include:

  • Fetching details of a particular Droplet before performing maintenance.
  • Retrieving a list of all Droplets to generate an inventory report.
  • Checking Droplet status as part of an automated workflow that manages infrastructure.

Properties

Name Meaning
Authentication Method used to authenticate with Digital Ocean API. Options: Access Token, OAuth2.
Droplet Name or ID Select a Droplet from a dropdown list or specify its ID via expression to identify the target Droplet for the operation.

Output

The output JSON contains detailed information about the requested Droplet(s). For the "Get" operation on Droplets, the response includes an array of Droplet objects under the droplets field. Each Droplet object typically contains properties such as ID, name, region, size, image, status, networks, and other metadata describing the Droplet's configuration and state.

No binary data output is involved in this operation.

Dependencies

  • Requires a valid Digital Ocean API authentication token, either via an access token or OAuth2 credentials.
  • The node depends on the Digital Ocean API endpoints for Droplet management.
  • No additional external services beyond Digital Ocean are required.

Troubleshooting

  • Common issues:

    • Providing both a tag name and a Droplet name when filtering multiple Droplets will cause an error because the API does not support using both simultaneously.
    • Using an invalid or expired API token will result in authentication errors.
    • Specifying a non-existent Droplet ID or name will lead to "not found" errors.

  • Error messages and resolutions:

    • "The Digital Ocean API does not allow both Tag Name and Name to be used...": Remove one of these filters to proceed.
    • Authentication errors: Verify that the API key or OAuth2 token is correctly configured and has sufficient permissions.
    • Not found errors: Confirm the Droplet ID or name exists and is accessible with the provided credentials.

Links and References

Discussion