Create Cluster

Zilliz Cloud provides various cluster plan tiers to accommodate the distinct business needs of users. For guidance on selecting an appropriate cluster type, consult Free Trials and Understand Cluster Plans.

This topic describes how to create a cluster.

Prerequisites

Ensure:

• Registration with Zilliz Cloud. Refer to Register with Zilliz Cloud for instructions.

• Ownership of the organization or project where the cluster is to be established. For details on roles and permissions, see User Roles.

Set up a free cluster

Cloud Console

1. Navigate to Zilliz Cloud console and log in.

2. Select the appropriate organization and project.

3. Click + Free Cluster.

   

4. In the Create New Cluster section, choose the Free plan and fill in the required parameters.

   📘Notes

   Each user is permitted one free cluster. For additional clusters, opt for the Serverless or Dedicated plans.

   Parameter	Description
   Cluster Name	Name of the cluster.
   Cloud Provider & Region	The cluster's location and the cloud provider it is hosted on. At present, our free clusters are available on Google Cloud Platform (GCP). For more information, see Cloud Providers & Regions.

   

5. Click Create. You'll be redirected to the Cluster Details page showcasing the public endpoint and API key for the cluster. Record these details for future access.

cURL

Your request should resemble the following example, where {CLOUD_REGION_ID is the ID of the cloud region where the cluster resides and {API_KEY} is your API key used for authentication.

The following POST request takes a request body and creates a free cluster named cluster-free in the project with ID 8342669010291064832.

curl --request POST \
     --url "https://controller.api.${CLOUD_REGION}.zillizcloud.com/v1/clusters/createServerless" \
     --header "Authorization: Bearer ${API_KEY}" \
     --header "accept: application/json" \
     --header "content-type: application/json" \
     --data-raw "{
     \"plan\": \"Free\",
     \"clusterName\": \"cluster-free\",
     \"projectId\": \"${PROJECT_ID}\"
 }"
     
#   "code": 200,
#   "data": {
#       "clusterId": "in03-XXXXXXXXXXXXXXX",
#       "username": "db_XXXXXXXXXXXXXXX",
#       "password": "XXXXXXXXXXXXXXXX",
#       "prompt": "Submission successful, Cluster is being created, You can use the DescribeCluster interface to obtain the creation progress and the status of the Cluster. When the Cluster status is RUNNING, you can access your vector database using the SDK with the admin account and the initialization password you provided."
#   }
# }

In the command above,

• {CLOUD_REGION_ID: The ID of the cloud region where you want to create a cluster. Currently, free clusters can be created only on GCP. To obtain available cloud region IDs, call the List Cloud Regions operation.

• {API_KEY}: The credential used to authenticate API requests. Replace the value with your own.

• plan: The cluster plan. Valid values: Free and Serverless.

• clusterName: The name of the cluster to create.

• projectId: The ID of the project in which you want to create a cluster. To list project IDs, call the List Projects operation.

Set up a serverless cluster

Cloud Console

1. Navigate to Zilliz Cloud console and log in.

2. Select the appropriate organization and project.

3. Click + Cluster.

   

4. In the Create New Cluster section, choose the Serverless plan and fill in the required parameters.

   Parameter	Description
   Cluster Name	Name of the cluster.
   Cloud Provider & Region	The cluster's location and the cloud provider it is hosted on. At present, our serverless clusters are available on Google Cloud Platform (GCP). For more information, see Cloud Providers & Regions.

   

5. Click Create. You'll be redirected to the Cluster Details page showcasing the public endpoint and API key for the cluster. Record these details for future access.

cURL

Your request should resemble the following example, where {CLOUD_REGION_ID is the ID of the cloud region where the cluster resides and {API_KEY} is your API key used for authentication.

The following POST request takes a request body and creates a serverless cluster named cluster-severless in the project with ID 8342669010291064832.

curl --request POST \
     --url "https://controller.api.${CLOUD_REGION}.zillizcloud.com/v1/clusters/createServerless" \
     --header "Authorization: Bearer ${API_KEY}" \
     --header "accept: application/json" \
     --header "content-type: application/json" \
     --data-raw "{
     \"plan\": \"Serverless\",
     \"clusterName\": \"cluster-serverless\",
     \"projectId\": \"${PROJECT_ID}\"
 }"
     
#   "code": 200,
#   "data": {
#       "clusterId": "in03-XXXXXXXXXXXXXXX",
#       "username": "db_XXXXXXXXXXXXXXX",
#       "password": "XXXXXXXXXXXXXXXX",
#       "prompt": "Submission successful, Cluster is being created, You can use the DescribeCluster interface to obtain the creation progress and the status of the Cluster. When the Cluster status is RUNNING, you can access your vector database using the SDK with the admin account and the initialization password you provided."
#   }
# }

In the command above,

• {CLOUD_REGION_ID: The ID of the cloud region where you want to create a cluster. Currently, serverless clusters can be created only on GCP. To obtain available cloud region IDs, call the List Cloud Regions operation.

• {API_KEY}: The credential used to authenticate API requests. Replace the value with your own.

• plan: The cluster plan. Valid values: Free and Serverless.

• clusterName: The name of the cluster to create.

• projectId: The ID of the project in which you want to create a cluster. To list project IDs, call the List Projects operation.

Create a dedicated cluster

Cloud Console

1. Log in to the Zilliz Cloud console.

2. Enter the desired organization and project.

3. Click + Free Cluster.

   

4. On the Create New Cluster page, opt for the Standard or Enterprise plan and fill out the relevant parameters.

   

   • Cluster Name: Assign a unique identifier for your cluster.

   • Cloud Provider Settings: Choose the cloud service provider and the specific region where your cluster will be deployed. For more information, see Cloud Providers & Regions.

   • CU Settings:

     • CU Type: Select a CU Type that aligns with your cluster's performance requirements. For more information, refer to Select the Right CU.

     • CU Size: Select the total size of the cluster in terms of CUs.

   • Cloud Backup: Decide whether to enable automatic cloud backup for safeguarding the data stored within your cluster, ensuring data persistence and recovery capabilities in case of failures.

5. Click Create Cluster. You'll be redirected to a dialog showcasing the public endpoint and token for your cluster access. Keep these details safe.

cURL

Your request should resemble the following example, where {CLOUD_REGION_ID is the ID of the cloud region where the cluster resides and {API_KEY} is your API key used for authentication.

The following POST request takes a request body and creates a dedicated cluster named cluster-02 with one Performance-optimized CU.

curl --request POST \
     --url "https://controller.api.${CLOUD_REGION}.zillizcloud.com/v1/clusters/create" \
     --header "Authorization: Bearer ${API_KEY}" \
     --header "accept: application/json" \
     --header "content-type: application/json" \
     --data-raw "{
     \"plan\": \"Standard\",
     \"clusterName\": \"cluster-02\",
     \"cuSize\": 1,
     \"cuType\": \"Performance-optimized\",
     \"projectId\": \"${PROJECT_ID}\"
 }"
     
# {
#   "code": 200,
#   "data": {
#       "clusterId": "in01-XXXXXXXXXXXXXXX",
#       "username": "db_admin",
#       "password": "XXXXXXXXXXXXXXXX",
#       "prompt": "Submission successful, Cluster is being created, You can use the DescribeCluster interface to obtain the creation progress and the status of the Cluster. When the Cluster status is RUNNING, you can access your vector database using the SDK with the admin account and the initialization password you provided."
#   }
# }

In the command above,

• {CLOUD_REGION_ID: The ID of the cloud region where you want to create a cluster. To obtain available cloud region IDs, call the List Cloud Regions operation.

• {API_KEY}: The credential used to authenticate API requests. Replace the value with your own.

• plan: The plan tier of the Zilliz Cloud service you subscribe to. Valid values: Standard and Enterprise.

• clusterName: The name of the cluster to create.

• cuSize: The size of the CU used for the cluster. Value range: 1 to 256. By calling Create Cluster, you can create a cluster with up to 32 CUs. To create a cluster with more than 32 CUs, contact us.

• cuType: The type of the CU used for the cluster. Valid values: **Performance-optimized and Capacity-optimized.

• projectId: The ID of the project in which you want to create a cluster. To list project IDs, call the List Projects operation.

Verification

After you create the cluster, you can check its status on the cluster list page. A cluster in the Running state indicates successful creation.