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
POST https://file.googleapis.com/v1/{parent=projects/*/locations/*}/instances
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
Parameters
instanceId
string
Required. The name of the instance to create. The name must be unique for the specified project and location.
Request body
The request body contains an instance of Instance.
Response body
If successful, the response body contains a newly created 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."],[[["\u003cp\u003eThis document describes how to create a new instance, specifying that instances created from backups must have a capacity equal to or larger than the backup and the minimum tier capacity.\u003c/p\u003e\n"],["\u003cp\u003eThe process involves a POST HTTP request to a specified URL, including path parameters for the project and location, along with a required instance ID as a query parameter.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must contain instance details, while a successful response will include an operation instance.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization to create a new instance requires the \u003ccode\u003ehttps://www.googleapis.com/auth/cloud-platform\u003c/code\u003e OAuth scope.\u003c/p\u003e\n"]]],[],null,["# Method: projects.locations.instances.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates 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).\n\n### HTTP request\n\n`POST https://file.googleapis.com/v1/{parent=projects/*/locations/*}/instances`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n### Query parameters\n\n### Request body\n\nThe request body contains an instance of [Instance](/filestore/docs/reference/rest/v1/projects.locations.instances#Instance).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Operation](/filestore/docs/reference/rest/Shared.Types/ListOperationsResponse#Operation).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/cloud-platform`\n\nFor more information, see the [Authentication Overview](/docs/authentication#authorization-gcp)."]]
