Skip to main content

List the snapshots

Contributors dmp-netapp netapp-aoife
PDFs

You can list the snapshots that have been taken for a specific application.

Before you begin

You must have the ID of the app you want to list the snapshots for. If needed you can use the workflow List the apps to locate the application.

List the snapshots

Perform the following REST API call to list the snapshots.

HTTP method and endpoint

This REST API call uses the following method and endpoint.

HTTP method Path

GET

/accounts/{account_id}/k8s/v1/apps/{app_id}/appSnaps
Additional input parameters

In addition to the parameters common with all REST API calls, the following parameters are also used in the curl examples for this step.

Parameter Type Required Description

app id

Path

Yes

Identifies the application owning the listed snapshots.

count

Query

No

If count=true the number of snapshots is included in the metadata section of the response.
Curl example: Return all snapshots for the app
curl --request GET \
--location "https://astra.netapp.io/accounts/$ACCOUNT_ID/k8s/v1/apps/$APP_ID/appSnaps" \
--include \
--header "Accept: */*" \
--header "Authorization: Bearer $API_TOKEN"
Curl example: Return all snapshots for the app and the count
curl --request GET \
--location "https://astra.netapp.io/accounts/$ACCOUNT_ID/k8s/v1/apps/$APP_ID/appSnaps?count=true" \
--include \
--header "Accept: */*" \
--header "Authorization: Bearer $API_TOKEN"
JSON output example
{
    "items": [
        {
            "type": "application/astra-appSnap",
            "version": "1.1",
            "id": "1ce34da4-bb0a-4926-b925-4a5d85dda8c2",
            "hookState": "success",
            "metadata": {
                "createdBy": "a530e865-23e8-4e2e-8020-e92c419a3867",
                "creationTimestamp": "2022-10-30T22:44:20Z",
                "modificationTimestamp": "2022-10-30T22:44:20Z",
                "labels": []
            },
            "snapshotAppAsset": "0ebfe3f8-40ed-4bdc-88c4-2144fbda85a0",
            "snapshotCreationTimestamp": "2022-10-30T22:44:33Z",
            "name": "snapshot-david-1",
            "state": "completed",
            "stateUnready": []
        }
    ],
    "metadata": {}
}