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

# POST /v1/{+parent}/backupChannels

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

Creates a new BackupChannel in a given location.

## Path parameters

- `parent` string, required

## Query parameters

- `backupChannelId` string

## Request body

- BackupChannel — A BackupChannel imposes constraints on where clusters can be backed up. The BackupChannel should be in the same project and region as the cluster being backed up. The backup can be created only in destination_project.
  - `destinationProject` string — Required. Immutable. The project where Backups are allowed to be stored. The format is `projects/{projectId}` or `projects/{projectNumber}`.
  - `etag` string — Output only. `etag` is used for optimistic concurrency control as a way to help prevent simultaneous updates of a BackupChannel from overwriting each other. It is strongly suggested that systems make use of the 'etag' in the read-modify-write cycle to perform BackupChannel updates in order to avoid race conditions: An `etag` is returned in the response to `GetBackupChannel`, and systems are expected to put that etag in the request to `UpdateBackupChannel` or `DeleteBackupChannel` to ensure that their change will be applied to the same version of the resource.
  - `name` string — Identifier. The fully qualified name of the BackupChannel. `projects/*/locations/*/backupChannels/*`
  - `createTime` string, google-datetime — Output only. The timestamp when this BackupChannel resource was created.
  - `description` string — Optional. User specified descriptive string for this BackupChannel.
  - `destinationProjectId` string — Output only. The project_id where Backups are allowed to be stored. Example Project ID: "my-project-id". This will be an OUTPUT_ONLY field to return the project_id of the destination project.
  - `labels` object — Optional. A set of custom labels supplied by user.
  - `updateTime` string, google-datetime — Output only. The timestamp when this BackupChannel resource was last updated.
  - `uid` string — Output only. Server generated global unique identifier of [UUID](https://en.wikipedia.org/wiki/Universally_unique_identifier) format.

## Response `200`

Successful response

---

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