List
List Snapshots for a Volume
get/v2/volumes/{volume_id}/snapshots
To retrieve the snapshots that have been created from a volume, send a GET request to /v2/volumes/$VOLUME_ID/snapshots.
Path Parameters
volume_idstring
formatuuid
Query Parameters
pagenumber
optional
Which 'page' of paginated results to return.
minimum1
per_pagenumber
optional
Number of items returned per page
minimum1
maximum200
Returns
metatotalnumberMetaProperties
Information about the response itself.
snapshotsarray of idstringcreated_atstringmin_disk_sizenumbernamestringregionsarray of stringresource_idstringresource_typeenumsize_gigabytesnumbertagsarray of stringSnapshots
optional
curl https://api.digitalocean.com//v2/volumes/$VOLUME_ID/snapshots \
-H "Authorization: Bearer $GRADIENTAI_API_KEY"200 Example
{
"meta": {
"total": 1
},
"links": {
"pages": {
"last": "https://api.digitalocean.com/v2/images?page=2",
"next": "https://api.digitalocean.com/v2/images?page=2"
}
},
"snapshots": [
{
"id": "8eb4d51a-873f-11e6-96bf-000f53315a41",
"created_at": "2020-09-30T18:56:12Z",
"min_disk_size": 10,
"name": "big-data-snapshot1475261752",
"regions": [
"nyc1"
],
"resource_id": "82a48a18-873f-11e6-96bf-000f53315a41",
"resource_type": "volume",
"size_gigabytes": 0,
"tags": [
"string"
]
}
]
}