Restores an existing instance's file share from a backup.
The capacity of the instance needs to be equal to or larger than the capacity of the backup (and also equal to or larger than the minimum capacity of the tier).
HTTP request
POST https://file.googleapis.com/v1beta1/{name=projects/*/locations/*/instances/*}:restore
Required. The resource name of the instance, in the format projects/{projectId}/locations/{locationId}/instances/{instanceId}.
Request body
The request body contains data with the following structure:
JSON representation
{"fileShare": string,// Union field source can be only one of the following:"sourceSnapshot": string,"sourceBackup": string// End of list of possible types for union field source.}
Fields
fileShare
string
Required. Name of the file share in the Filestore instance that the backup is being restored to.
Union field source.
source can be only one of the following:
sourceSnapshot (deprecated)
string
The resource name of the snapshot, in the format projects/{projectId}/locations/{locationId}/snapshots/{snapshotId}.
sourceBackup
string
The resource name of the backup, in the format projects/{projectId}/locations/{locationId}/backups/{backupId}.
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-06-17 UTC."],[[["This endpoint is used to restore an existing file share instance from a backup, requiring the instance's capacity to be equal to or larger than the backup's capacity."],["The HTTP request uses a `POST` method to the provided URL, which follows gRPC Transcoding syntax, including a required `name` path parameter for specifying the instance resource."],["The request body, in JSON format, mandates a `fileShare` field and allows one of either a `sourceSnapshot` or `sourceBackup` field to specify the restore source."],["A successful operation returns an instance of `Operation` in the response body, indicating the completion of the restore process."],["Authorization for this operation requires the OAuth scope `https://www.googleapis.com/auth/cloud-platform`."]]],[]]
