droplet_backups

Creates, updates, deletes, gets or lists a droplet_backups resource.

Overview

Name	droplet_backups
Type	Resource
Id	digitalocean.compute.droplet_backups

Fields

The following fields are returned by SELECT queries:

droplets_list_backups

A JSON object with an backups key.

Name	Datatype	Description
id	integer	The unique identifier for the snapshot or backup.
name	string	A human-readable name for the snapshot. (example: web-01-1595954862243)
created_at	string (date-time)	A time value given in ISO8601 combined date and time format that represents when the snapshot was created. (example: 2020-07-28T16:47:44Z)
min_disk_size	integer	The minimum size in GB required for a volume or Droplet to use this snapshot.
regions	array	An array of the regions that the snapshot is available in. The regions are represented by their identifying slug values.
size_gigabytes	number (float)	The billable size of the snapshot in gigabytes.
type	string	Describes the kind of image. It may be one of snapshot or backup. This specifies whether an image is a user-generated Droplet snapshot or automatically created Droplet backup. (example: snapshot)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
droplets_list_backups	select	droplet_id	per_page, page	To retrieve any backups associated with a Droplet, send a GET request to /v2/droplets/$DROPLET_ID/backups. You will get back a JSON object that has a backups key. This will be set to an array of backup objects, each of which contain the standard Droplet backup attributes.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
droplet_id	integer	A unique identifier for a Droplet instance. (example: 3164444)
page	integer	Which 'page' of paginated results to return. (example: 1)
per_page	integer	Number of items returned per page (example: 2)

SELECT examples

droplets_list_backups

To retrieve any backups associated with a Droplet, send a GET request to
/v2/droplets/$DROPLET_ID/backups.

You will get back a JSON object that has a backups key. This will be set to
an array of backup objects, each of which contain the standard
Droplet backup attributes.

SELECT
id,
name,
created_at,
min_disk_size,
regions,
size_gigabytes,
type
FROM digitalocean.compute.droplet_backups
WHERE droplet_id = '{{ droplet_id }}' -- required
AND per_page = '{{ per_page }}'
AND page = '{{ page }}';