DELETE /v2/droplets/{droplet_id}/destroy_with_associated_resources/selective
To destroy a Droplet along with a sub-set of its associated resources, send a
DELETE request to the /v2/droplets/$DROPLET_ID/destroy_with_associated_resources/selective
endpoint. The JSON body of the request should include reserved_ips
, snapshots
, volumes
,
or volume_snapshots
keys each set to an array of IDs for the associated
resources to be destroyed. The IDs can be found by querying the Droplet's
associated resources. Any associated resource not included in the request
will remain and continue to accrue changes on your account.
A successful response will include a 202 response code and no content. Use the status endpoint to check on the success or failure of the destruction of the individual resources.
Servers
- https://api.digitalocean.com
Path parameters
Name | Type | Required | Description |
---|---|---|---|
droplet_id |
Integer | Yes |
A unique identifier for a Droplet instance. |
Request headers
Name | Type | Required | Description |
---|---|---|---|
Content-Type |
String | Yes |
The media type of the request body.
Default value: "application/json" |
Request body fields
Name | Type | Required | Description |
---|---|---|---|
floating_ips[] |
Array | No |
An array of unique identifiers for the floating IPs to be scheduled for deletion. |
reserved_ips[] |
Array | No |
An array of unique identifiers for the reserved IPs to be scheduled for deletion. |
snapshots[] |
Array | No |
An array of unique identifiers for the snapshots to be scheduled for deletion. |
volume_snapshots[] |
Array | No |
An array of unique identifiers for the volume snapshots to be scheduled for deletion. |
volumes[] |
Array | No |
An array of unique identifiers for the volumes to be scheduled for deletion. |
How to start integrating
- Add HTTP Task to your workflow definition.
- Search for the API you want to integrate with and click on the name.
- This loads the API reference documentation and prepares the Http request settings.
- Click Test request to test run your request to the API and see the API's response.