backups

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

Overview

Name	backups
Type	Resource
Id	digitalocean.droplets.backups

Fields

Name	Datatype	Description
id	integer	The unique identifier for the snapshot or backup.
name	string	A human-readable name for the snapshot.
created_at	string	A time value given in ISO8601 combined date and time format that represents when the snapshot was created.
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	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.

Methods

Name	Accessible by	Required Params	Description
droplets_list_backups	SELECT	droplet_id	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 examples

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.droplets.backups
WHERE droplet_id = '{{ droplet_id }}';