0

Deleting Droplets by Tag

by
Published Dec 20, 2024

To delete **all** Droplets assigned to a specific tag, include the `tag_name` query parameter set to the name of the tag in your DELETE request. For example, `/v2/droplets?tag_name=$TAG_NAME`. A successful request will receive a 204 status code with no body in response. This indicates that the request was processed successfully.

Script digitalocean Verified

The script

Submitted by hugo697 Bun
Verified 536 days ago
1
//native
2
type Digitalocean = {
3
  token: string;
4
};
5
/**
6
 * Deleting Droplets by Tag
7
 * To delete **all** Droplets assigned to a specific tag, include the `tag_name`
8
query parameter set to the name of the tag in your DELETE request. For
9
example,  `/v2/droplets?tag_name=$TAG_NAME`.
10

11
A successful request will receive a 204 status code with no body in response.
12
This indicates that the request was processed successfully.
13

14
 */
15
export async function main(auth: Digitalocean, tag_name: string | undefined) {
16
  const url = new URL(`https://api.digitalocean.com/v2/droplets`);
17
  for (const [k, v] of [["tag_name", tag_name]]) {
18
    if (v !== undefined && v !== "" && k !== undefined) {
19
      url.searchParams.append(k, v);
20
    }
21
  }
22
  const response = await fetch(url, {
23
    method: "DELETE",
24
    headers: {
25
      Authorization: "Bearer " + auth.token,
26
    },
27
    body: undefined,
28
  });
29
  if (!response.ok) {
30
    const text = await response.text();
31
    throw new Error(`${response.status} ${text}`);
32
  }
33
  return await response.json();
34
}
35