Skip to content
  • Auto
  • Light
  • Dark

List

List Associated Resources for a Droplet
get/v2/droplets/{droplet_id}/destroy_with_associated_resources

To list the associated billable resources that can be destroyed along with a Droplet, send a GET request to the /v2/droplets/$DROPLET_ID/destroy_with_associated_resources endpoint.

This endpoint will only return resources that you are authorized to see. For example, to see associated Reserved IPs, include the reserved_ip:read scope.

The response will be a JSON object containing snapshots, volumes, and volume_snapshots keys. Each will be set to an array of objects containing information about the associated resources.

Path Parameters
droplet_idnumber
minimum1
Returns
floating_ipsarray of idstringcoststringnamestringAssociatedResource
optional

Floating IPs that are associated with this Droplet.
Requires reserved_ip:read scope.

reserved_ipsarray of idstringcoststringnamestringAssociatedResource
optional

Reserved IPs that are associated with this Droplet.
Requires reserved_ip:read scope.

snapshotsarray of idstringcoststringnamestringAssociatedResource
optional

Snapshots that are associated with this Droplet.
Requires image:read scope.

volume_snapshotsarray of idstringcoststringnamestringAssociatedResource
optional

Volume Snapshots that are associated with this Droplet.
Requires block_storage_snapshot:read scope.

volumesarray of idstringcoststringnamestringAssociatedResource
optional

Volumes that are associated with this Droplet.
Requires block_storage:read scope.

curl https://api.digitalocean.com//v2/droplets/$DROPLET_ID/destroy_with_associated_resources \
    -H "Authorization: Bearer $GRADIENTAI_API_KEY"
200 Example
{
  "floating_ips": [
    {
      "id": "61486916",
      "cost": "0.05",
      "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
    }
  ],
  "reserved_ips": [
    {
      "id": "61486916",
      "cost": "0.05",
      "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
    }
  ],
  "snapshots": [
    {
      "id": "61486916",
      "cost": "0.05",
      "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
    }
  ],
  "volume_snapshots": [
    {
      "id": "61486916",
      "cost": "0.05",
      "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
    }
  ],
  "volumes": [
    {
      "id": "61486916",
      "cost": "0.05",
      "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
    }
  ]
}