Check Status

Check Status of a Droplet Destroy with Associated Resources Request

get/v2/droplets/{droplet_id}/destroy_with_associated_resources/status

To check on the status of a request to destroy a Droplet with its associated resources, send a GET request to the /v2/droplets/$DROPLET_ID/destroy_with_associated_resources/status endpoint.

Path ParametersExpand Collapse

droplet_id: number

ReturnsExpand Collapse

completed_at: optional string

A time value given in ISO8601 combined date and time format indicating when the requested action was completed.

formatdate-time

droplet: optional DestroyedAssociatedResource

An object containing information about a resource scheduled for deletion.

failures: optional number

A count of the associated resources that failed to be destroyed, if any.

resources: optional object { floating_ips, reserved_ips, snapshots, 2 more }

An object containing additional information about resource related to a Droplet requested to be destroyed.

floating_ips: optional array of DestroyedAssociatedResource

reserved_ips: optional array of DestroyedAssociatedResource

snapshots: optional array of DestroyedAssociatedResource

volume_snapshots: optional array of DestroyedAssociatedResource

volumes: optional array of DestroyedAssociatedResource

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

{
  "completed_at": "2020-04-01T18:11:49Z",
  "droplet": {
    "id": "61486916",
    "destroyed_at": "2020-04-01T18:11:49Z",
    "error_message": " ",
    "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
  },
  "failures": 0,
  "resources": {
    "floating_ips": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ],
    "reserved_ips": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ],
    "snapshots": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ],
    "volume_snapshots": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ],
    "volumes": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ]
  }
}

Returns Examples

{
  "completed_at": "2020-04-01T18:11:49Z",
  "droplet": {
    "id": "61486916",
    "destroyed_at": "2020-04-01T18:11:49Z",
    "error_message": " ",
    "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
  },
  "failures": 0,
  "resources": {
    "floating_ips": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ],
    "reserved_ips": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ],
    "snapshots": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ],
    "volume_snapshots": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ],
    "volumes": [
      {
        "id": "61486916",
        "destroyed_at": "2020-04-01T18:11:49Z",
        "error_message": " ",
        "name": "ubuntu-s-1vcpu-1gb-nyc1-01-1585758823330"
      }
    ]
  }
}