Method: projects.locations.instances.create

Creates an instance. When creating from a backup, the capacity of the new 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


The URL uses gRPC Transcoding syntax.

Path parameters



Required. The instance's project and location, in the format projects/{projectId}/locations/{location}. In Filestore, locations map to Google Cloud zones, for example us-west1-b.

Query parameters



Required. The ID of the instance to create. The ID must be unique within the specified project and location.

This value must start with a lowercase letter followed by up to 62 lowercase letters, numbers, or hyphens, and cannot end with a hyphen.

Request body

The request body contains an instance of Instance.

Response body

If successful, the response body contains a newly created instance of Operation.

Authorization scopes

Requires the following OAuth scope:


For more information, see the Authentication Overview.