Skip to main content

Drop Cluster

Deletes a cluster. This operation moves your cluster to the recycle bin. All clusters in the recycle bin are pending permanent deletion in 30 days.


DELETE
https://controller.api.{cloud-region}.zillizcloud.com/v1/clusters/{CLUSTER_ID}/drop

Example

Notes
  • This API requires an API Key as the authentication token.
curl --request DELETE \
--url "https://controller.api.${CLOUD_REGION}.zillizcloud.com/v1/clusters/${clusterId}/drop" \
--header "Authorization: Bearer ${API_KEY}" \
--header "accept: application/json" \
--header "content-type: application/json"

Success response:

{
"code": 200,
"data": {
"clusterId": "in01-***************",
"prompt": "The Cluster has been deleted. If you believe this was a mistake, you can restore the Cluster from the recycle bin within 30 days (this not include serverless)."
}
}

Request

Parameters

  • No query parameters required

  • Path parameters

    ParameterDescription
    CLUSTER_IDstring(required)

Request Body

No request body required

Response

Returns the ID of the deleted cluster.

Response Bodies

  • Response body if we process your request successfully
{
"code": "integer",
"data": {
"clusterId": "string",
"prompt": "string"
}
}
  • Response body if we failed to process your request
{
"code": integer,
"message": string
}

Properties

The properties in the returned response are listed in the following table.

PropertyDescription
codeinteger
Indicates whether the request succeeds.
  • 200: The request succeeds.
  • Others: Some error occurs.
codeinteger
dataobject
data.clusterIdstring
The ID of a cluster.
data.promptstring
The statement indicating that the current operation succeeds.
messagestring
Indicates the possible reason for the reported error.

Possible Errors

CodeError Message
80001The token is illegal
80002The token is invalid
80020Cluster not exist or you don't have permission.
80021Serverless cluster not support this operation.
90102The cluster does not exist in current region.
90103The clusterId parameter is empty in the request path.