Skip to main content

create

This operation creates a new cluster.

Description

Regarding dedicated clusters, Zilliz Cloud offers the following cluster types: Performance-optimized, Capacity-optimized, and Tiered-storage.

Performance-optimized cluster

  • Tailored for scenarios emphasizing low latency and high throughput.

  • Ideal for real-time applications like generative AI, recommendation systems, chatbots, and more.

Capacity-optimized cluster

  • Crafted for handling vast datasets, boasting five times the data capacity of its Performance-optimized counterpart, albeit with subdued search performance.

  • Ideal for large-scale unstructured data search, copyright detection, and identity verification.

Tiered-storage cluster

  • Best for ultra-large-scale, cost-sensitive workloads.

  • Ideal for applications that need to store massive volumes of data at a low cost. The capacity of a Tiered-storage cluster is 4 times that of a Capacity-optimized cluster.

Running this command without any options triggers a set of interactive prompts.

📘Notes

Tiered-storage clusters are unavailable in BYOC projects.

Synopsis

bash
zilliz cluster create
--name <value>
--type <serverless | free | dedicated>
[--project-id <value>]
[--region <value>]
[--cu-type <Performance-optimized | Capacity-optimized | Tiered-storage>]
[--cu-size <value>]
[--plan <Free | Serverless | Standard | Enterprise>]
[--output <value>]

Options

  • --name (string) -

    [REQUIRED]

    Indicates the cluster display name.

    The value is an alphanumeric string of no more than 255 characters that starts with a letter.

  • --type (string) -

    [REQUIRED]

    Indicates the cluster type.

    Possible values:

    • serverless,

    • free, and

    • dedicated.

  • --project-id (string) -

    Indicates the project to create the cluster in.

  • --region (string) -

    Indicates a cloud region.

    Possible values:

    • aws-us-east-1

    • aws-us-east-2

    • aws-us-west-2

    • aws-ca-central-1

    • aws-eu-central-1

    • aws-eu-west-1

    • aws-ap-northeast-1

    • aws-ap-southeast-1

    • aws-ap-southeast-2

    • gcp-us-west1

    • gcp-us-east4

    • gcp-us-central1

    • gcp-asia-southeast1

    • az-eastus

    • az-eastus2

    • az-centralus

    • az-germanywestcentral

    • az-northeurope

    • az-centralindia

    📘Notes

    For available regions in your BYOC project, consult with your organization owner.

  • --cu-type (string) -

    Indicates the compute unit type (dedicated only).

    Possible Values:

    • Performance-optimized,

    • Capacity-optimized,

    • Tiered-storage.

  • --cu-size (integer) -

    Indicates the number of compute units (dedicated only).

    A CU is the basic unit of compute resources used for parallel processing of data, and different CU types comprise varying combinations of CPU, memory, and storage. The concept of CU only applies to Dedicated clusters.

    • For a Dedicated cluster in a Standard project, the product of its CU size and the number of replicas must be less than or equal to 32.

    • For a Dedicated cluster in an Enterprise project, the product of its CU size and the number of replicas must be less than or equal to 1,024.

  • --plan (string) -

    Indicates the subscription plan (dedicated only).

    Possible values:

    • Free,

    • Serverless,

    • Standard,

    • Enterprise.

  • --output, -o (string) -

    Output format.

    Possible values:

    • json,

    • table,

    • text.

Example

bash
zilliz cluster create --name my-cluster \
--type serverless \
--region aws-us-west-2
Ctrl I