Deleting an Sharded PostgreSQL cluster
Written by
Updated at January 22, 2026
Note
This feature is at the Preview stage.
You can delete an Sharded PostgreSQL cluster if you no longer need it.
Deleting a cluster
Before deleting a cluster, disable its deletion protection if it is enabled.
Management console
REST API
gRPC API
- In the management console, select the folder where you want to delete a cluster.
- Select Yandex Managed Service for Sharded PostgreSQL.
- Click for the cluster in question and select Delete.
- In the window that opens, confirm the deletion and click Delete.
-
Get an IAM token for API authentication and put it into an environment variable:
export IAM_TOKEN="<IAM_token>" -
Use the Cluster.Delete method and send the following request, e.g., via cURL:
curl \ --request DELETE \ --header "Authorization: Bearer $IAM_TOKEN" \ --header "Content-Type: application/json" \ --url 'https://mdb.api.cloud.yandex.net/managed-spqr/v1/clusters/<cluster_ID>' -
View the server response to make sure your request was successful.
-
Get an IAM token for API authentication and put it into an environment variable:
export IAM_TOKEN="<IAM_token>" -
Clone the cloudapi repository:
cd ~/ && git clone --depth=1 https://github.com/yandex-cloud/cloudapiBelow, we assume that the repository contents reside in the
~/cloudapi/directory. -
Call the ClusterService.Delete method, e.g., via the following gRPCurl request:
grpcurl \ -format json \ -import-path ~/cloudapi/ \ -import-path ~/cloudapi/third_party/googleapis/ \ -proto ~/cloudapi/yandex/cloud/mdb/spqr/v1/cluster_service.proto \ -rpc-header "Authorization: Bearer $IAM_TOKEN" \ -d '{ "cluster_id": <cluster_ID> }' \ mdb.api.cloud.yandex.net:443 \ yandex.cloud.mdb.spqr.v1.ClusterService.Delete -
View the server response to make sure your request was successful.