Manage Cluster

Contact Sales to Enable BYOC

This guide describes the lifecycle of a cluster so that you can make full use of your Zilliz Cloud console to achieve your goals.

Manage serving cluster

You can perform the following operations on a serving cluster.

Rename

Navigate to the Cluster Details page of your target cluster and then follow the instructions below to rename your cluster.

Suspend

You can suspend a cluster via the web console or programmatically.

Cloud Console

Navigate to the Cluster Details page of your target cluster and then follow the instructions below to suspend your Dedicated cluster.

cURL

Your request should resemble the following example, where {API_KEY} is your API key used for authentication.

The following POST request takes a request body and suspends a Dedicated cluster.

curl --request POST \
     --url "https://api.cloud.zilliz.com/v2/clusters/${CLUSTER_ID}/suspend" \
     --header "Authorization: Bearer ${API_KEY}" \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \

# {
#     "code": 0,
#     "data": {
#         "clusterId": "inxx-xxxxxxxxxxxxxxx",
#         "prompt": "Successfully Submitted. The cluster will not incur any computing costs when suspended. You will only be billed for the storage costs during this time."
#     }
# }     

In the command above,

• {API_KEY}: The credential used to authenticate API requests. Replace the value with your own. Note that API keys authenticate Platform API (Control Plane) requests. For data plan connections, use cluster credentials (username:password) instead.

• {CLUSTER_ID}: The ID of the Dedicated cluster to suspend.

For details, refer to Suspend Cluster.

Once the suspend operation is successful, a job record will be generated. You can check the progress on the Jobs page.

Resume

Please note that during resuming, you cannot perform other actions on the cluster.

You can resume a cluster via the web console or programmatically.

Cloud Console

Navigate to the Cluster Details page of your target cluster and then follow the instruction below to resume your cluster.

📘Notes

When clicking Resume in the Resume Cluster dialog box, you will be prompted to check the resource quota for your project. If the resources are sufficient, the dialog box will disappear after the check is complete, otherwise, you can

• Click Go To Project Resource Settings to edit resource settings for the project, or

• Click Back to Last Step to change your cluster settings.

During the process, some additional resources will be required for rolling; these resources will be released after use.

cURL

Your request should resemble the following example, where {API_KEY} is your API key used for authentication.

The following POST request takes a request body and resumes a cluster.

curl --request POST \
     --url "https://api.cloud.zilliz.com/v2/clusters/${CLUSTER_ID}/resume" \
     --header "Authorization: Bearer ${API_KEY}" \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \

# {
#     "code": 0,
#     "data": {
#         "clusterId": "inxx-xxxxxxxxxxxxxxx",
#         "prompt": "successfully Submitted. Cluster is being resumed, which is expected to takes several minutes. You can access data about the creation progress and status of your cluster by DescribeCluster API. Once the cluster status is RUNNING, you may access your vector database using the SDK."
#     }
# }     

In the command above,

• {API_KEY}: The credential used to authenticate API requests. Replace the value with your own. Note that API keys authenticate Platform API (Control Plane) requests. For data plan connections, use cluster credentials (username:password) instead.

• {CLUSTER_ID}: The ID of the cluster to resume.

For details, refer to Resume Cluster.

Once the resume operation is successful, a job record will be generated. You can check the progress on the Jobs page.

Drop

When a cluster is no longer needed, you can drop it. You can drop a cluster via the web console or programatically.

Cloud Console

Navigate to the Cluster Details page of your target cluster and then follow the instruction below to drop your cluster.

cURL

Your request should resemble the following example, where {API_KEY} is your API key used for authentication.

The following DELETE request takes a request body and drops a cluster.

curl --request POST \
     --url "https://api.cloud.zilliz.com/v2/clusters/${CLUSTER_ID}/drop" \
     --header "Authorization: Bearer ${API_KEY}" \
     --header "Accept: application/json" \
     --header "Content-Type: application/json" \

# {
#     "code": 0,
#     "data": {
#         "clusterId": "inxx-xxxxxxxxxxxxxxx",
#         "prompt": "The cluster has been deleted. If you consider this action to be an error, you have the option to restore the deleted cluster from the recycle bin within a 30-day period. Kindly note, this recovery feature does not apply to free clusters."
#     }
# }     

In the command above,

• {API_KEY}: The credential used to authenticate API requests. Replace the value with your own. Note that API keys authenticate Platform API (Control Plane) requests. For data plan connections, use cluster credentials (username:password) instead.

• {CLUSTER_ID}: The ID of the Dedicated cluster to drop.

For details, refer to Drop Cluster.

Manage on-demand cluster ｜PUBLIC

You can perform the following operations on an on-demand cluster.

Drop

• Via RESTful API

  curl --request DELETE \
       --url "https://${BASE_URL}/v2/clusters/onDemandClusters/inxx-xxxxxxxxxxxxxxx" \
       --header "Authorization: Bearer ${API_KEY}" \
       --header "Accept: application/json"

• Via web console