volume_snapshot

Generated on 18 Jun 2025 from digitalocean.cloud version v1.2.1

Synopsis

Create or delete volume snapshots. View the API documentation at https://docs.digitalocean.com/reference/api/api-reference/#tag/Snapshots.

Requirements

  • pydo >= 0.1.3
  • azure-core >= 1.26.1

Parameters

Parameter Choices / Default Description
client_override_options
dict
Client override options (developer use). For example, can be used to override the DigitalOcean API endpoint for an internal test suite. If provided, these options will knock out existing options.
module_override_options
dict
Module override options (developer use). Can be used to override module options to support experimental or future options. If provided, these options will knock out existing options.
name
str / required
A human-readable name for the volume snapshot.
state
str
Choices:
  • present (default)
  • absent
State of the resource, present to create, absent to destroy.
tags
list / elements=str
A flat array of tag names as strings to be applied to the resource. Tag names may be for either existing or new tags.
timeout
int
Default: 300 Polling timeout in seconds.
token
str
DigitalOcean API token. There are several environment variables which can be used to provide this value. DIGITALOCEAN_ACCESS_TOKEN, DIGITALOCEAN_TOKEN, DO_API_TOKEN, DO_API_KEY, DO_OAUTH_TOKEN and OAUTH_TOKEN
volume_id
str / required
The ID of the block storage volume.

Examples

- name: Create a volume snapshot
  digitalocean.cloud.volume_snapshot:
    token: "{{ token }}"
    state: present
    volume_id: 7724db7c-e098-11e5-b522-000f53304e51
    name: big-data-snapshot1475261774
    tags:
      - aninterestingtag

Return Values

KeyReturnedDescription
error
dict
failure DigitalOcean API error.
Sample:
{
  "Message": "Informational error message.",
  "Reason": "Unauthorized",
  "Status Code": 401
}
msg
str
always Droplet result information.
Sample:
[
  "Created volume snapshot big-data-snapshot1475261774 (8fa70202-873f-11e6-8b68-000f533176b1) of volume 82a48a18-873f-11e6-96bf-000f53315a41",
  "Deleted volume snapshot big-data-snapshot1475261774 (8fa70202-873f-11e6-8b68-000f533176b1) of volume 82a48a18-873f-11e6-96bf-000f53315a41",
  "Volume snapshot big-data-snapshot1475261774 of volume 82a48a18-873f-11e6-96bf-000f53315a41",
  "Volume snapshot big-data-snapshot1475261774 (8fa70202-873f-11e6-8b68-000f533176b1) of volume 82a48a18-873f-11e6-96bf-000f53315a41 exists",
  "Volume snapshot big-data-snapshot1475261774 does not exist",
  "Volume snapshot big-data-snapshot1475261774 (8fa70202-873f-11e6-8b68-000f533176b1) of volume 82a48a18-873f-11e6-96bf-000f53315a41 would be deleted"
]
snapshot
dict
always Volume snapshot information.
Sample:
{
  "created_at": "2020-09-30T18:56:14Z",
  "id": "8fa70202-873f-11e6-8b68-000f533176b1",
  "min_disk_size": 10,
  "name": "big-data-snapshot1475261774",
  "regions": [
    "nyc1"
  ],
  "resource_id": "82a48a18-873f-11e6-96bf-000f53315a41",
  "resource_type": "volume",
  "size_gigabytes": 10,
  "tags": [
    "aninterestingtag"
  ]
}

We can't find any results for your search.

Try using different keywords or simplifying your search terms.