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

# POST /v1/{+parent}/backups

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

Creates a backup.

## Path parameters

- `parent` string, required

## Query parameters

- `backupId` string

## Request body

- Backup — A Filestore backup.
  - `capacityGb` string, int64 — Output only. Capacity of the source file share when the backup was created.
  - `satisfiesPzs` boolean — Output only. Reserved for future use.
  - `name` string — Output only. The resource name of the backup, in the format `projects/{project_number}/locations/{location_id}/backups/{backup_id}`.
  - `createTime` string, google-datetime — Output only. The time when the backup was created.
  - `sourceInstance` string — The resource name of the source Filestore instance, in the format `projects/{project_number}/locations/{location_id}/instances/{instance_id}`, used to create this backup.
  - `downloadBytes` string, int64 — Output only. Amount of bytes that will be downloaded if the backup is restored. This may be different than storage bytes, since sequential backups of the same disk will share storage.
  - `kmsKey` string — Immutable. KMS key name used for data encryption.
  - `labels` object — Resource labels to represent user provided metadata.
  - `storageBytes` string, int64 — Output only. The size of the storage used by the backup. As backups share storage, this number is expected to change with backup creation/deletion.
  - `fileSystemProtocol` 'FILE_PROTOCOL_UNSPECIFIED' | 'NFS_V3' | 'NFS_V4_1' — Output only. The file system protocol of the source Filestore instance that this backup is created from.
  - `description` string — A description of the backup with 2048 characters or less. Requests with longer descriptions will be rejected.
  - `state` 'STATE_UNSPECIFIED' | 'CREATING' | 'FINALIZING' | 'READY' | 'DELETING' | 'INVALID' — Output only. The backup state.
  - `sourceFileShare` string — Name of the file share in the source Filestore instance that the backup is created from.
  - `satisfiesPzi` boolean — Output only. Reserved for future use.
  - `sourceInstanceTier` 'TIER_UNSPECIFIED' | 'STANDARD' | 'PREMIUM' | 'BASIC_HDD' | 'BASIC_SSD' | 'HIGH_SCALE_SSD' | 'ENTERPRISE' | 'ZONAL' | 'REGIONAL' — Output only. The service tier of the source Filestore instance that this backup is created from.
  - `tags` object — Optional. Input only. Immutable. Tag key-value pairs bound to this resource. Each key must be a namespaced name and each value a short name. Example: "123456789012/environment" : "production", "123456789013/costCenter" : "marketing" See the documentation for more information: - Namespaced name: https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing#retrieving_tag_key - Short name: https://cloud.google.com/resource-manager/docs/tags/tags-creating-and-managing#retrieving_tag_value

## Response `200`

Successful response

---

[API](https://skmtc.dev/google/apis/file.md) · [All operations](https://skmtc.dev/google/apis/file/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/google/file/revisions/f3d16365a416/schema)