Retrieve Policy

Retrieve the Backup Policy for an Existing Droplet

get/v2/droplets/{droplet_id}/backups/policy

To show information about an individual Droplet's backup policy, send a GET request to /v2/droplets/$DROPLET_ID/backups/policy.

Path Parameters

droplet_idnumber

minimum1

Returns

policyobject

optional

Hide ParametersShow Parameters

backup_enabledboolean

optional

A boolean value indicating whether backups are enabled for the Droplet.

backup_policyhourenumplanenumretention_period_daysnumberweekdayenumwindow_length_hoursnumberDropletBackupPolicy

optional

An object specifying the backup policy for the Droplet.

droplet_idnumber

optional

The unique identifier for the Droplet.

next_backup_windowendstringstartstringDropletNextBackupWindow

optional

An object containing keys with the start and end times of the window during which the backup will occur.

HTTPPython

curl https://api.digitalocean.com//v2/droplets/$DROPLET_ID/backups/policy \
    -H "Authorization: Bearer $GRADIENTAI_API_KEY"

200 Example

{
  "policy": {
    "backup_enabled": true,
    "backup_policy": {
      "hour": 0,
      "plan": "daily",
      "weekday": "SUN"
    },
    "droplet_id": 7101383,
    "next_backup_window": {
      "end": "2019-12-04T23:00:00Z",
      "start": "2019-12-04T00:00:00Z"
    }
  }
}