Operate Zilliz Cloud through zilliz-cli. All operations are executed via shell commands.
Before any operation, verify in order:
python3 -m pip show zilliz-cli # 1. CLI installed? If not: pip install --upgrade zilliz-cli
zilliz auth status # 2. Logged in? If not: guide user to login in their terminal
zilliz context current # 3. Context set? (only for data-plane ops)
CRITICAL: zilliz login, zilliz configure, and zilliz auth switch require interactive input — NEVER run them in a non-interactive shell. Instruct the user to run in their own terminal. NEVER ask for API keys in chat.
zilliz <resource> <action> --flag <value> [--optional-flag <value>]
All commands support --output json|table|text (default: text). Use --output json for programmatic parsing.
| Feature | Free | Serverless | Dedicated |
|---|---|---|---|
| --- | --- | --- | --- |
| Collection CRUD & Vector ops | Yes | Yes | Yes |
| Database create/drop | No | No | Yes |
| User/role management | No | Limited | Yes |
| Backup management | No | Yes | Yes |
| Cluster modify (CU/replica) | No | No | Yes |
Check cluster type first when a command fails with permission errors.
Each reference covers one resource domain with full command syntax, options, and guidance. Read the relevant reference when handling that domain:
| Domain | Reference | When to read |
|---|---|---|
| --- | --- | --- |
| Setup & auth | references/setup.md | Install, login, context, config, troubleshooting |
| Clusters | references/cluster.md | Create, list, describe, modify, suspend, resume, delete clusters |
| Collections | references/collection.md | Create, list, describe, drop, rename, load, release, aliases |
| Vectors | references/vector.md | Search, query, insert, upsert, get, delete, hybrid search, filters |
| Indexes | references/index.md | Create, list, describe, drop indexes |
| Databases | references/database.md | Create, list, describe, drop databases |
| Partitions | references/partition.md | Create, list, load, release, drop partitions |
| Users & roles | references/user-role.md | RBAC: users, roles, privileges (Dedicated only) |
| Backups | references/backup.md | Create, restore, export backups; manage backup policies |
| Import | references/import.md | Bulk data import from cloud storage |
| Billing | references/billing.md | Usage queries, invoices, payment methods |
| Monitoring | references/monitoring.md | Cluster status, collection stats, load states |
| Projects & regions | references/project-region.md | Projects, volumes, cloud providers, regions |
For new users, guide through setup in order:
python3 -m pip install --upgrade zilliz-clizilliz login in their terminalzilliz auth statuszilliz cluster listzilliz context set --cluster-id zilliz context current && zilliz collection listCreate collection and prepare for search:
zilliz collection create --name --dimension — createzilliz index create --collection — index (AUTOINDEX recommended)zilliz collection load --name — load into memoryzilliz vector search --collection --data '[[...]]' — searchStatus overview (read references/monitoring.md):
zilliz context current --output jsonzilliz cluster describe --cluster-id --output json zilliz database list --output jsoncollection list, get-stats, get-load-state, index listThese return immediately; poll for completion:
| Operation | Poll command |
|---|---|
| --- | --- |
cluster create | cluster describe --cluster-id until RUNNING |
backup create/export/restore-* | backup describe --cluster-id |
import start | import status --job-id |
zilliz login, zilliz configure, zilliz billing bind-card共 1 个版本