MethodPathDescription
GET/v1/nodes/{uid}/snapshotsGet node snapshots
DELETE/v1/nodes/{uid}/snapshots/{snapshot_name}Delete a node snapshot

Get node snapshots

GET /v1/nodes/{int: uid}/snapshots

Get all cluster node snapshots of the specified node.

Permissions

Permission nameRoles
view_node_infoadmin
cluster_member
cluster_viewer
db_member
db_viewer

Request

Example HTTP request

GET /nodes/1/snapshots

Headers

KeyValueDescription
Hostcnm.cluster.fqdnDomain name
Acceptapplication/jsonAccepted media type

URL parameters

FieldTypeDescription
uidintegerThe unique ID of the node requested.

Response

Returns an array of node snapshot JSON objects.

Example JSON body

[
    {
        "created_time": "2024-01-10 20:55:54",
        "name": "nightly_snapshot_1",
        "node_uid": "1"
    },
    {
        "created_time": "2024-01-11 20:55:54",
        "name": "nightly_snapshot_2",
        "node_uid": "1"
    }
]

Status codes

CodeDescription
200 OKNo error
404 Not FoundNode UID does not exist

Delete node snapshot

DELETE /v1/nodes/{int: uid}/snapshots/{snapshot_name}

Delete a cluster node snapshot. Snapshots created by maintenance mode are not deleted.

Permissions

Permission nameRoles
update_nodeadmin

Request

Example HTTP request

DELETE /nodes/1/snapshots/nightly_snapshot_19

Request headers

KeyValueDescription
Hostcluster.fqdnDomain name
Acceptapplication/jsonAccepted media type

URL parameters

FieldTypeDescription
uidintegerThe unique ID of the updated node.
snapshot_namestringThe unique name of the snapshot to delete.

Response

Returns a JSON object that represents the deleted node snapshot.

Example JSON body

{
    "created_time": "2024-01-11 20:55:54",
    "name": "nightly_snapshot_19",
    "node_uid": "1"
}

Status codes

CodeDescription
200 OKNo error
403 ForbiddenNode snapshot is a maintenance snapshot and cannot be deleted
404 Not FoundNode uid does not exist
404 Not FoundSnapshot name does not exist for this node uid