Zilliz Cloud CLI Skill

Operate Zilliz Cloud through zilliz-cli. All operations are executed via shell commands.

Prerequisite Check (always run first)

Before any operation, verify in order:

CODEBLOCK0

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.

Command Pattern

CODEBLOCK1

All commands support --output json|table|text (default: text). Use --output json for programmatic parsing.

Cluster Type Capabilities

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.

Reference Files

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 |

Quick-Start Workflow

For new users, guide through setup in order:

1. 1. Install CLI: INLINECODE7
2. Authenticate: user runs zilliz login in their terminal
3. Verify: INLINECODE9
4. List clusters: INLINECODE10
5. Set context: INLINECODE11
6. Verify: INLINECODE12

Common Workflows

Create collection and prepare for search:

1. 1. zilliz collection create --name <name> --dimension <dim> — create
2. INLINECODE14 — index (AUTOINDEX recommended)
3. INLINECODE15 — load into memory
4. INLINECODE16 — search

Status overview (read references/monitoring.md):

1. 1. INLINECODE17
2. INLINECODE18
3. INLINECODE19
4. For each DB: collection list, get-stats, get-load-state, INLINECODE23
5. Present as formatted table

Async Operations

These return immediately; poll for completion:

Operation	Poll command
INLINECODE24	INLINECODE25 until RUNNING
INLINECODE26

backup describe --cluster-id <id> --backup-id <bid> |
| import start | import status --job-id <jid> --cluster-id <id> |

Safety Rules

• - Confirm before destructive ops: drop collection/database, delete cluster/backup, drop user/role
• Sensitive commands in user's terminal: zilliz login, zilliz configure, INLINECODE32
• Never expose credentials in chat or command output