Sign in

v1

latestOpenAPI 3.0.0Creative Commons Attribution 3.02026-07-132876147.9 KB
projects

Creates a new BackupChannel in a given location.

post/v1/{+parent}/backupChannels

Path parameters

parentstring required

Required. The location within which to create the BackupChannel. Format: projects/*/locations/*

Query parameters

backupChannelIdstring

Optional. The client-provided short name for the BackupChannel resource. This name must: - be between 1 and 63 characters long (inclusive) - consist of only lower-case ASCII letters, numbers, and dashes - start with a lower-case letter - end with a lower-case letter or number - be unique within the set of BackupChannels in this location If the user does not provide a name, a uuid will be used as the name.

Request body

destinationProjectstring

Required. Immutable. The project where Backups are allowed to be stored. The format is projects/{projectId} or projects/{projectNumber}.

etagstring

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.

namestring

Identifier. The fully qualified name of the BackupChannel. projects/*/locations/*/backupChannels/*

createTimestring google-datetime

Output only. The timestamp when this BackupChannel resource was created.

descriptionstring

Optional. User specified descriptive string for this BackupChannel.

destinationProjectIdstring

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.

labelsobject

Optional. A set of custom labels supplied by user.

updateTimestring google-datetime

Output only. The timestamp when this BackupChannel resource was last updated.

uidstring

Output only. Server generated global unique identifier of UUID format.

Response

Successful response