---
title: "POST /v1/{+parent}/snapshots"
method: POST
path: "/v1/{+parent}/snapshots"
tags: ["projects"]
---

# POST /v1/{+parent}/snapshots

`POST /v1/{+parent}/snapshots`

Create a new snapshot for a volume.

## Path parameters

- `parent` string, required

## Query parameters

- `snapshotId` string

## Request body

- Snapshot — Snapshot is a point-in-time version of a Volume's content.
  - `labels` object — Resource labels to represent user provided metadata.
  - `name` string — Identifier. The resource name of the snapshot. Format: `projects/{project_id}/locations/{location}/volumes/{volume_id}/snapshots/{snapshot_id}`.
  - `usedBytes` number, double — Output only. Current storage usage for the snapshot in bytes.
  - `createTime` string, google-datetime — Output only. The time when the snapshot was created.
  - `stateDetails` string — Output only. State details of the storage pool
  - `state` 'STATE_UNSPECIFIED' | 'READY' | 'CREATING' | 'DELETING' | 'UPDATING' | 'DISABLED' | 'ERROR' — Output only. The snapshot state.
  - `description` string — A description of the snapshot with 2048 characters or less. Requests with longer descriptions will be rejected.

## Response `200`

Successful response

---

[API](https://skmtc.net/google/apis/netapp.md) · [All operations](https://skmtc.net/google/apis/netapp/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/google/netapp/versions/fa9ebea9e9dc/schema)