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/v1beta1/{parent=projects/*/locations/*}/instances
Required. The instance's project and location, in the formatprojects/{projectId}/locations/{location}. In Filestore, locations map to Google Cloud zones, for exampleus-west1-b.
Query parameters
Parameters
instanceId
string
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.
[[["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 API endpoint facilitates the creation of a new instance within a specified project and location, where the \u003ccode\u003eparent\u003c/code\u003e path parameter determines the project and location.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003einstanceId\u003c/code\u003e query parameter is mandatory and defines the unique identifier for the new instance, adhering to specific formatting rules.\u003c/p\u003e\n"],["\u003cp\u003eThe request body must include details for a new instance using the \u003ca href=\"/filestore/docs/reference/rest/v1beta1/projects.locations.instances#Instance\"\u003eInstance\u003c/a\u003e format, and when creating from a backup, the capacity of the new instance should be equal to or larger than the backup's capacity.\u003c/p\u003e\n"],["\u003cp\u003eUpon successful execution, the API returns a response body containing an instance of \u003ca href=\"/filestore/docs/reference/rest/Shared.Types/ListOperationsResponse#Operation\"\u003eOperation\u003c/a\u003e.\u003c/p\u003e\n"],["\u003cp\u003eAuthorization to use this endpoint 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/v1beta1/{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/v1beta1/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)."]]
