Method: projects.instances.delete

Deletes an instance.

Immediately upon completion of the request:

  • Billing ceases for all of the instance's reserved resources.

Soon afterward:

  • The instance and all of its databases immediately and irrevocably disappear from the API. All data in the databases is permanently deleted.

HTTP request


The URL uses Google API HTTP annotation syntax.

Path parameters



Required. The name of the instance to be deleted. Values are of the form projects/<project>/instances/<instance>

Authorization requires the following Google IAM permission on the specified resource name:

  • spanner.instances.delete

Request body

The request body must be empty.

Response body

If successful, the response body will be empty.

Authorization Scopes

Requires one of the following OAuth scopes:


For more information, see the Auth Guide.

Try it!

Send feedback about...

Cloud Spanner Documentation