Required. The name of the destination cluster that will contain the backup copy. The cluster must already exist. Values are of the form: projects/{project}/instances/{instance}/clusters/{cluster}.
Authorization requires the following IAM permission on the specified resource parent:
bigtable.backups.create
Request body
The request body contains data with the following structure:
Required. The id of the new backup. The backupId along with parent are combined as {parent}/backups/{backupId} to create the full backup name, of the form: projects/{project}/instances/{instance}/clusters/{cluster}/backups/{backupId}. This string must be between 1 and 50 characters in length and match the regex [_a-zA-Z0-9][-_.a-zA-Z0-9]*.
sourceBackup
string
Required. The source backup to be copied from. The source backup needs to be in READY state for it to be copied. Copying a copied backup is not allowed. Once backups.copy is in progress, the source backup cannot be deleted or cleaned up on expiration until backups.copy is finished. Values are of the form: projects/<project>/instances/<instance>/clusters/<cluster>/backups/<backup>.
Authorization requires the following IAM permission on the specified resource sourceBackup:
Required. Required. The expiration time of the copied backup with microsecond granularity that must be at least 6 hours and at most 30 days from the time the request is received. Once the expireTime has passed, Cloud Bigtable will delete the backup and free the resources used by the backup.
Uses RFC 3339, where generated output will always be Z-normalized and uses 0, 3, 6 or 9 fractional digits. Offsets other than "Z" are also accepted. Examples: "2014-10-02T15:01:23Z", "2014-10-02T15:01:23.045123456Z" or "2014-10-02T15:01:23+05:30".
Response body
If successful, the response body contains an instance of Operation.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-05-08 UTC."],[[["\u003cp\u003eThis API operation copies a Cloud Bigtable backup to a new backup within a specified destination cluster, instance, and project.\u003c/p\u003e\n"],["\u003cp\u003eThe destination cluster must already exist, and the caller must have the \u003ccode\u003ebigtable.backups.create\u003c/code\u003e IAM permission on the destination cluster.\u003c/p\u003e\n"],["\u003cp\u003eThe source backup must be in the READY state and the caller requires the \u003ccode\u003ebigtable.backups.read\u003c/code\u003e IAM permission on the source backup.\u003c/p\u003e\n"],["\u003cp\u003eThe new backup's ID must be between 1 and 50 characters long and follow a specific regex pattern, and its expiration time must be set between 6 hours and 30 days from the request time.\u003c/p\u003e\n"],["\u003cp\u003eThe response, upon success, will provide details about the ongoing Operation that is copying the backup.\u003c/p\u003e\n"]]],[],null,["# Method: projects.instances.clusters.backups.copy\n\nCopy a Cloud Bigtable backup to a new backup in the destination cluster located in the destination instance and project.\n\n### HTTP request\n\n`POST https://bigtableadmin.googleapis.com/v2/{parent=projects/*/instances/*/clusters/*}/backups:copy`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Request body\n\nThe request body contains data with the following structure:\n\n### Response body\n\nIf successful, the response body contains an instance of [Operation](/bigtable/docs/reference/admin/rest/v2/operations#Operation).\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://www.googleapis.com/auth/bigtable.admin`\n- `https://www.googleapis.com/auth/bigtable.admin.table`\n- `https://www.googleapis.com/auth/cloud-bigtable.admin`\n- `https://www.googleapis.com/auth/cloud-bigtable.admin.table`\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]