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

# POST /v1/{+parent}/backups

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

Creates a backup from the volume specified in the request The backup can be created from the given snapshot if specified in the request. If no snapshot specified, there'll be a new snapshot taken to initiate the backup creation.

## Path parameters

- `parent` string, required

## Query parameters

- `backupId` string

## Request body

- Backup — A NetApp Backup.
  - `sourceSnapshot` string — If specified, backup will be created from the given snapshot. If not specified, there will be a new snapshot taken to initiate the backup creation. Format: `projects/{project_id}/locations/{location}/volumes/{volume_id}/snapshots/{snapshot_id}`
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'UPLOADING' | 'READY' | 'DELETING' | 'ERROR' | 'UPDATING' — Output only. The backup state.
  - `backupType` 'TYPE_UNSPECIFIED' | 'MANUAL' | 'SCHEDULED' — Output only. Type of backup, manually created or created by a backup policy.
  - `chainStorageBytes` string, int64 — Output only. Total size of all backups in a chain in bytes = baseline backup size + sum(incremental backup size)
  - `satisfiesPzs` boolean — Output only. Reserved for future use
  - `satisfiesPzi` boolean — Output only. Reserved for future use
  - `backupRegion` string — Output only. Region in which backup is stored. Format: `projects/{project_id}/locations/{location}`
  - `sourceVolume` string — The resource name of the volume that this backup belongs to. You must provide either `source_volume` or `ontap_source`. Format: `projects/{project_id}/locations/{location}/volumes/{volume_id}`
  - `createTime` string, google-datetime — Output only. The time when the backup was created.
  - `enforcedRetentionEndTime` string, google-datetime — Output only. The time until which the backup is not deletable.
  - `name` string — Identifier. The resource name of the backup. Format: `projects/{project_id}/locations/{location}/backupVaults/{backup_vault_id}/backups/{backup_id}`.
  - `ontapSource` OntapSource — Represents ONTAP source details.
    - `volumeUuid` string — Required. The UUID of the ONTAP source volume.
    - `storagePool` string — Required. Name of the storage pool. This must be specified for creating backups for ONTAP mode volumes. Format: `projects/{projects_id}/locations/{location}/storagePools/{storage_pool_id}`
    - `snapshotUuid` string — Optional. The UUID of the ONTAP source snapshot.
  - `description` string — A description of the backup with 2048 characters or less. Requests with longer descriptions will be rejected.
  - `labels` object — Resource labels to represent user provided metadata.
  - `volumeUsageBytes` string, int64 — Output only. Size of the file system when the backup was created. When creating a new volume from the backup, the volume capacity will have to be at least as big.
  - `volumeRegion` string — Output only. Region of the volume from which the backup was created. Format: `projects/{project_id}/locations/{location}`

## 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)