Get an NFS snapshot by ID

nfs.snapshots.retrieve(, ) -> SnapshotRetrieveResponse

get/v2/nfs/snapshots/{nfs_snapshot_id}

To get an NFS snapshot, send a GET request to /v2/nfs/snapshots/{nfs_snapshot_id}?region=${region}.

A successful request will return the NFS snapshot.

ParametersExpand Collapse

nfs_snapshot_id: str

region: str

The DigitalOcean region slug (e.g., nyc2, atl1) where the NFS share resides.

ReturnsExpand Collapse

class SnapshotRetrieveResponse: …

snapshot: Optional[Snapshot]

Represents an NFS snapshot.

id: str

The unique identifier of the snapshot.

created_at: datetime

The timestamp when the snapshot was created.

formatdate-time

name: str

The human-readable name of the snapshot.

region: str

The DigitalOcean region slug where the snapshot is located.

share_id: str

The unique identifier of the share from which this snapshot was created.

formatuuid

size_gib: int

The size of the snapshot in GiB.

formatuint64

status: Literal["UNKNOWN", "CREATING", "ACTIVE", 2 more]

The current status of the snapshot.

Accepts one of the following:

"UNKNOWN"

"CREATING"

"ACTIVE"

"FAILED"

"DELETED"

Get an NFS snapshot by ID

from gradient import Gradient

client = Gradient(
    access_token="My Access Token",
)
snapshot = client.nfs.snapshots.retrieve(
    nfs_snapshot_id="0a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
    region="region",
)
print(snapshot.snapshot)

{
  "snapshot": {
    "id": "0a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
    "created_at": "2023-11-14T16:29:21Z",
    "name": "daily-backup",
    "region": "atl1",
    "share_id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
    "size_gib": 1024,
    "status": "CREATING"
  }
}

Returns Examples

{
  "snapshot": {
    "id": "0a1b2c3d-4e5f-6a7b-8c9d-0e1f2a3b4c5d",
    "created_at": "2023-11-14T16:29:21Z",
    "name": "daily-backup",
    "region": "atl1",
    "share_id": "1a2b3c4d-5e6f-7a8b-9c0d-1e2f3a4b5c6d",
    "size_gib": 1024,
    "status": "CREATING"
  }
}