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 ParametersExpand Collapse

droplet_id: number

minimum1

ReturnsExpand Collapse

floating_ips: optional array of AssociatedResource { id, cost, name }

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

id: optional string

The unique identifier for the resource associated with the Droplet.

cost: optional string

The cost of the resource in USD per month if the resource is retained after the Droplet is destroyed.

The name of the resource associated with the Droplet.

reserved_ips: optional array of AssociatedResource { id, cost, name }

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

id: optional string

The unique identifier for the resource associated with the Droplet.

cost: optional string

The cost of the resource in USD per month if the resource is retained after the Droplet is destroyed.

The name of the resource associated with the Droplet.

snapshots: optional array of AssociatedResource { id, cost, name }

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

id: optional string

The unique identifier for the resource associated with the Droplet.

cost: optional string

The cost of the resource in USD per month if the resource is retained after the Droplet is destroyed.

The name of the resource associated with the Droplet.

volume_snapshots: optional array of AssociatedResource { id, cost, name }

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

id: optional string

The unique identifier for the resource associated with the Droplet.

cost: optional string

The cost of the resource in USD per month if the resource is retained after the Droplet is destroyed.

The name of the resource associated with the Droplet.

volumes: optional array of AssociatedResource { id, cost, name }

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

id: optional string

The unique identifier for the resource associated with the Droplet.

cost: optional string

The cost of the resource in USD per month if the resource is retained after the Droplet is destroyed.

The name of the resource associated with the Droplet.

List Associated Resources for a Droplet

curl https://api.digitalocean.com/v2/droplets/$DROPLET_ID/destroy_with_associated_resources \
    -H "Authorization: Bearer $DIGITALOCEAN_ACCESS_TOKEN"

{
  "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"
    }
  ]
}

Returns Examples

{
  "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"
    }
  ]
}