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

# POST /v1/{+parent}/restoreChannels

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

Creates a new RestoreChannel in a given location.

## Path parameters

- `parent` string, required

## Query parameters

- `restoreChannelId` string

## Request body

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

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