v1

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

Creates a new RestoreChannel in a given location.

post/v1/{+parent}/restoreChannels

Path parameters

parentstring required

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

Query parameters

restoreChannelIdstring

Optional. The client-provided short name for the RestoreChannel 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 RestoreChannels in this location If the user does not provide a name, a uuid will be used as the name.

Request body

updateTimestring google-datetime

Output only. The timestamp when this RestoreChannel was last updated.

uidstring

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

destinationProjectIdstring

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.

descriptionstring

Optional. User specified descriptive string for this RestoreChannel.

labelsobject

Optional. A set of custom labels supplied by user.

destinationProjectstring

Required. Immutable. The project into which the backups will be restored. The format is projects/{projectId} or projects/{projectNumber}.

namestring

Identifier. The fully qualified name of the RestoreChannel. projects/*/locations/*/restoreChannels/*

createTimestring google-datetime

Output only. The timestamp when this RestoreChannel was created.

etagstring

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

Successful response