Skill: imjoey/ovirt-mcp (version 0.1.0)

--- name: ovirt-mcp description: Manage oVirt/RHV virtualization infrastructure via MCP. Provides 186 tools for VMs, hosts, clusters, networks, storage, templates, snapshots, disks, events, RBAC, quotas, and more. Use when the user asks to manage oVirt virtual machines, create/delete/modify VMs, check host status, manage storage domains, handle templates, configure networks, manage user permissions, view events/alerts, or any oVirt/RHV infrastructure operations. Triggers on "oVirt", "RHV", "virtual machine", "VM management", "storage domain", "cluster", "host management". --- # oVirt MCP Server MCP server for oVirt/RHV virtualization management. 186 tools covering the full infrastructure lifecycle. **Version**: 0.1.0 | **License**: MIT | **Author**: Joey Ma (@imjoey) ## Quick Start ### Install ```bash pip install ovirt-engine-mcp-server ``` Or from source: ```bash git clone https://github.com/imjoey/ovirt-engine-mcp-server.git cd ovirt-engine-mcp-server pip install -e . ``` ### Configure Environment variables (recommended): ```bash export OVIRT_ENGINE_URL="https://ovirt-engine.example.com" export OVIRT_ENGINE_USER="admin@internal" export OVIRT_ENGINE_PASSWORD="your-password" ``` Or create a `config.yaml`: ```yaml OVIRT_ENGINE_URL: https://ovirt-engine.example.com OVIRT_ENGINE_USER: admin@internal # OVIRT_ENGINE_PASSWORD should be set via environment variable ``` ### Run ```bash ovirt-engine-mcp ``` ### Claude Desktop / OpenClaw Integration ```json { "mcpServers": { "ovirt": { "command": "ovirt-engine-mcp", "env": { "OVIRT_ENGINE_URL": "https://ovirt-engine.example.com", "OVIRT_ENGINE_USER": "admin@internal", "OVIRT_ENGINE_PASSWORD": "your-password" } } } } ``` ### Docker ```bash docker build -t ovirt-engine-mcp-server . docker run -e OVIRT_ENGINE_URL=... -e OVIRT_ENGINE_USER=... -e OVIRT_ENGINE_PASSWORD=... ovirt-engine-mcp-server ``` ## Architecture ``` MCP Client (Claude / OpenClaw / etc.) │ stdio (JSON-RPC) ▼ MCP Server (server.py) ┌─────────────────────────────┐ │ OvirtMCP (ovirt_mcp.py) │ ← Core SDK wrapper (ovirtsdk4) │ 186 methods │ ├─────────────────────────────┤ │ Extension Modules: │ │ NetworkMCP · ClusterMCP │ │ TemplateMCP · DataCenterMCP│ │ HostExtendedMCP │ │ StorageExtendedMCP │ │ DiskExtendedMCP │ │ EventsMCP · AffinityMCP │ │ RbacMCP · VmExtendedMCP │ │ TemplateExtendedMCP │ │ QuotaMCP · SystemMCP │ └─────────────────────────────┘ │ ▼ oVirt Engine REST API ``` ## Error Handling All errors return structured JSON with error code, message, and retry guidance: | Code | Retryable | Description | |------|-----------|-------------| | `CONNECTION_ERROR` | ✅ | Failed to connect to oVirt Engine | | `NOT_FOUND` | ❌ | Requested resource not found | | `PERMISSION_DENIED` | ❌ | Insufficient permissions | | `VALIDATION_ERROR` | ❌ | Invalid input parameters | | `TIMEOUT` | ✅ | Operation timed out | | `SDK_ERROR` | ✅ | oVirt SDK internal error | **Retry strategy**: Only retry on `retryable: true` errors. Use exponential backoff (1s → 2s → 4s). `NOT_FOUND` and `PERMISSION_DENIED` require user intervention. ## Available Tools 186 tools across 27 categories. Each reference file is self-contained with its own index: | File | Tools | Covers | |------|-------|--------| | [vm.md](references/vm.md) | 35 | VM lifecycle, pools, checkpoints, snapshots | | [host.md](references/host.md) | 19 | Host management, fencing, iSCSI | | [cluster.md](references/cluster.md) | 11 | Clusters, CPU profiles | | [datacenter.md](references/datacenter.md) | 5 | Data centers | | [instance-types.md](references/instance-types.md) | 2 | Instance types | | [storage.md](references/storage.md) | 16 | Storage domains, connections, iSCSI bonds | | [disk.md](references/disk.md) | 13 | Disk lifecycle, snapshots, move, resize | | [network.md](references/network.md) | 16 | Networks, VNIC profiles, QoS, MAC pools | | [template.md](references/template.md) | 8 | Template lifecycle, disk/NIC lists | | [system.md](references/system.md) | 6 | System info, jobs | | [events.md](references/events.md) | 11 | Events, bookmarks, alerts | | [rbac.md](references/rbac.md) | 24 | Users, groups, roles, permissions, tags, filters | | [quota.md](references/quota.md) | 7 | Data center quotas | | [affinity.md](references/affinity.md) | 13 | Affinity groups and labels | ### Quick Category Reference | Category | Count | Key Tools | |----------|-------|-----------| | VM Core | 9 | `vm_list`, `vm_create`, `vm_start`, `vm_stop`, `vm_delete` | | VM Extended | 16 | `vm_migrate`, `vm_console`, `vm_cdrom_*`, `vm_watchdog_*`, `vm_pin_to_host` | | VM Pools | 5 | `vm_pool_list`, `vm_pool_create`, `vm_pool_update`, `vm_pool_delete` | | VM Checkpoints | 4 | [REDACTED_SECRET] | | Snapshots | 4 | [REDACTED_SECRET] | | Disks Core | 3 | `disk_list`, `disk_create`, `disk_attach` | | Disks Extended | 9 | `disk_get`, `disk_resize`, `disk_move`, `disk_sparsify`, `disk_export` | | Networks | 9 | [REDACTED_SECRET], `nic_list/add/remove` | | VNIC Profiles | 5 | [REDACTED_SECRET] | | Network Filters & QoS | 3 | `network_filter_list`, `mac_pool_list`, `qos_list` | | Hosts Core | 3 | `host_list`, `host_activate`, `host_deactivate` | | Hosts Extended | 16 | `host_add`, `host_fence`, `host_iscsi_*`, `host_install`, `host_nic_*` | | Clusters | 10 | [REDACTED_SECRET], `cluster_cpu_load`, `cluster_memory_usage` | | CPU Profiles | 2 | `cpu_profile_list`, `cpu_profile_get` | | Data Centers | 5 | [REDACTED_SECRET] | | Storage Core | 8 | [REDACTED_SECRET] | | Storage Extended | 10 | `storage_refresh`, `storage_import_vm`, `storage_files`, `iscsi_bond_list` | | Templates Core | 2 | `template_list`, `template_vm_create` | | Templates Extended | 6 | [REDACTED_SECRET], `template_disk_list`, `template_nic_list` | | Instance Types | 2 | `instance_type_list`, `instance_type_get` | | Affinity Groups | 7 | [REDACTED_SECRET] | | Affinity Labels | 6 | [REDACTED_SECRET] | | Events | 11 | `event_list`, `event_search`, `event_alerts/errors/warnings`, `event_summary` | | RBAC | 24 | `user_*`, `group_*`, `role_*`, `permission_*`, `tag_*`, `filter_list` | | Quotas | 7 | `quota_list/create/update/delete`, `quota_*_limit_list` | | System & Jobs | 6 | `system_get`, `job_list`, `job_cancel`, `system_statistics` | ## Common Workflows ### Create VM from Template ``` 1. template_list → find template ID 2. cluster_list → find cluster ID 3. template_vm_create(name, template, cluster, ...) 4. vm_start(name_or_id) ``` ### Migrate VM ``` 1. vm_list(status="up") → find running VM 2. host_list() → find target host 3. vm_migrate(name_or_id, target_host) ``` ### Create Snapshot & Restore ``` 1. snapshot_create(name_or_id, description="before-patch") 2. ... perform changes ... 3. snapshot_restore(name_or_id, snapshot_id) # if needed ``` ### Storage Health Check ``` 1. storage_list → list all domains 2. storage_stats(name_or_id) → check each domain 3. event_errors → check for storage-related errors ``` ### RBAC Audit ``` 1. permission_list(resource_type="cluster", resource_id="...") → list perms 2. user_list → list users 3. tag_list → list tags ``` ## Requirements - Python >= 3.10 - oVirt Engine 4.4+ - Dependencies: `mcp>=1.0.0`, `ovirtsdk4>=4.6.0`, `pyyaml>=6.0`, `requests>=2.31.0`, `colorlog>=6.8.0` ## Development ```bash # Install dev dependencies pip install -e ".[dev]" # Run tests pytest tests/ -v # Lint ruff check src/ tests/ ``` ## Related Projects - [oVirt](https://www.ovirt.org/) — Open-source virtualization management - [ovirtsdk4](https://github.com/oVirt/ovirt-engine-sdk-python) — Official oVirt Python SDK - [Model Context Protocol](https://modelcontextprotocol.io/) — The MCP specification

path: README.md
content: # ovirt-mcp

[OpenClaw](https://github.com/openclaw/openclaw) Agent Skill for [oVirt MCP Server](https://github.com/imjoey/ovirt-engine-mcp-server) — comprehensive reference documentation for 186 oVirt/RHV infrastructure management tools.

## What is this?

This skill helps AI agents (Claude, GPT, etc.) understand and use the oVirt MCP Server's full toolset. It provides:

- **Quick Start** — install and configure the MCP server in under a minute
- **Tool Reference** — all 186 tools organized by domain with parameter schemas
- **Error Handling** — error codes, retry strategies, and troubleshooting
- **Common Workflows** — ready-to-use patterns for frequent operations

## Structure

```
ovirt-mcp/
├── SKILL.md                              # Entry point: quick start, architecture, tool index
└── references/
    ├── vm.md              (35 tools)      # VM lifecycle, pools, checkpoints, snapshots
    ├── host.md            (19 tools)      # Host management, fencing, iSCSI
    ├── cluster.md         (11 tools)      # Clusters, CPU profiles
    ├── datacenter.md       (5 tools)      # Data centers
    ├── instance-types.md   (2 tools)      # Instance types
    ├── storage.md         (16 tools)      # Storage domains, connections, iSCSI bonds
    ├── disk.md            (13 tools)      # Disk lifecycle, snapshots, move, resize
    ├── network.md         (16 tools)      # Networks, VNIC profiles, QoS, MAC pools
    ├── template.md         (8 tools)      # Template lifecycle, disk/NIC lists
    ├── system.md           (6 tools)      # System info, jobs
    ├── events.md          (11 tools)      # Events, bookmarks, alerts
    ├── rbac.md            (24 tools)      # Users, groups, roles, permissions, tags
    ├── quota.md            (7 tools)      # Data center quotas
    └── affinity.md        (13 tools)      # Affinity groups and labels
```

## Install

### Via ClawHub

```bash
clawhub install ovirt-mcp
```

### From Source

```bash
git clone https://github.com/imjoey/ovirt-mcp-skill.git
cp -r ovirt-mcp-skill ~/.openclaw/skills/ovirt-mcp
```

## Prerequisites

- [oVirt MCP Server](https://github.com/imjoey/ovirt-engine-mcp-server) installed and configured
- oVirt Engine 4.4+
- Python >= 3.10

## Tool Coverage

| Domain | Tools | Examples |
|--------|-------|---------|
| Virtual Machines | 35 | `vm_create`, `vm_start`, `vm_migrate`, `vm_console` |
| Hosts | 19 | `host_add`, `host_fence`, `host_install` |
| Clusters | 11 | `cluster_create`, `cluster_cpu_load` |
| Networks | 16 | `network_create`, `vnic_profile_*` |
| Storage | 16 | `storage_create`, `storage_import_vm` |
| Disks | 13 | `disk_create`, `disk_resize`, `disk_move` |
| RBAC | 24 | `user_create`, `permission_assign`, `role_*` |
| Events | 11 | `event_search`, `event_alerts` |
| Templates | 8 | `template_vm_create`, `template_disk_list` |
| Other | 33 | Affinity, quotas, system, datacenter, instance types |
| **Total** | **186** | |

## Related Projects

- [oVirt MCP Server](https://github.com/imjoey/ovirt-engine-mcp-server) — The MCP server this skill documents
- [oVirt](https://www.ovirt.org/) — Open-source virtualization management
- [ovirtsdk4](https://github.com/oVirt/ovirt-engine-sdk-python) — Official oVirt Python SDK
- [Model Context Protocol](https://modelcontextprotocol.io/) — The MCP specification

## License

MIT


path: references/affinity.md
content: # 目录索引

| 工具 | 分类 |
|------|------|
| [affinity_group_list](#affinity_group_list) | Affinity Groups |
| [affinity_group_get](#affinity_group_get) | Affinity Groups |
| [affinity_group_create](#affinity_group_create) | Affinity Groups |
| [affinity_group_update](#affinity_group_update) | Affinity Groups |
| [affinity_group_delete](#affinity_group_delete) | Affinity Groups |
| [affinity_group_add_vm](#affinity_group_add_vm) | Affinity Groups |
| [affinity_group_remove_vm](#affinity_group_remove_vm) | Affinity Groups |
| [affinity_label_list](#affinity_label_list) | Affinity Labels |
| [affinity_label_get](#affinity_label_get) | Affinity Labels |
| [affinity_label_create](#affinity_label_create) | Affinity Labels |
| [affinity_label_delete](#affinity_label_delete) | Affinity Labels |
| [affinity_label_assign](#affinity_label_assign) | Affinity Labels |
| [affinity_label_unassign](#affinity_label_unassign) | Affinity Labels |

---

## Affinity Groups

### affinity_group_list
列出亲和性组

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `cluster` | string | **是** | 集群名称 |

---

### affinity_group_get
获取亲和性组详情

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `cluster` | string | **是** | 集群名称 |
| `name_or_id` | string | **是** | 亲和性组名称或 ID |

---

### affinity_group_create
创建亲和性组

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | 亲和性组名称 |
| `cluster` | string | **是** | 集群名称 |
| `positive` | boolean | 否 | True=亲和性，False=反亲和性，默认 True |
| `enforcing` | boolean | 否 | True=强制执行，False=软性规则，默认 False |
| `vms` | string[] | 否 | VM 名称或 ID 列表 |

---

### affinity_group_update
更新亲和性组

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `cluster` | string | **是** | 集群名称 |
| `name_or_id` | string | **是** | 亲和性组名称或 ID |
| `new_name` | string | 否 | 新名称（可选） |
| `positive` | boolean | 否 | True=亲和性，False=反亲和性 |
| `enforcing` | boolean | 否 | True=强制执行，False=软性规则 |

---

### affinity_group_delete
删除亲和性组

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `cluster` | string | **是** | 集群名称 |
| `name_or_id` | string | **是** | 亲和性组名称或 ID |

---

### affinity_group_add_vm
添加 VM 到亲和性组

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `cluster` | string | **是** | 集群名称 |
| `affinity_group` | string | **是** | 亲和性组名称或 ID |
| `vm` | string | **是** | VM 名称或 ID |

---

### affinity_group_remove_vm
从亲和性组移除 VM

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `cluster` | string | **是** | 集群名称 |
| `affinity_group` | string | **是** | 亲和性组名称或 ID |
| `vm` | string | **是** | VM 名称或 ID |

---

## Affinity Labels

### affinity_label_list
列出亲和性标签

**参数：**（无参数）

---

### affinity_label_get
获取亲和性标签详情

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 标签名称或 ID |

---

### affinity_label_create
创建亲和性标签

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | 标签名称 |

---

### affinity_label_delete
删除亲和性标签

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 标签名称或 ID |

---

### affinity_label_assign
为资源分配亲和性标签

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `label` | string | **是** | 标签名称或 ID |
| `resource_type` | string | **是** | 资源类型（vm 或 host） |
| `resource` | string | **是** | 资源名称或 ID |

---

### affinity_label_unassign
移除资源的亲和性标签

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `label` | string | **是** | 标签名称或 ID |
| `resource_type` | string | **是** | 资源类型（vm 或 host） |
| `resource` | string | **是** | 资源名称或 ID |



path: references/cluster.md
content: # 目录索引

| 工具 | 分类 |
|------|------|
| [cluster_list](#cluster_list) | Clusters |
| [cluster_get](#cluster_get) | Clusters |
| [cluster_create](#cluster_create) | Clusters |
| [cluster_update](#cluster_update) | Clusters |
| [cluster_delete](#cluster_delete) | Clusters |
| [cluster_hosts](#cluster_hosts) | Clusters |
| [cluster_vms](#cluster_vms) | Clusters |
| [cluster_cpu_load](#cluster_cpu_load) | Clusters |
| [cluster_memory_usage](#cluster_memory_usage) | Clusters |
| [cpu_profile_list](#cpu_profile_list) | CPU Profiles |
| [cpu_profile_get](#cpu_profile_get) | CPU Profiles |

---

## Clusters

### cluster_list
列出集群

**参数：**（无参数）

---

### cluster_get
获取集群详情

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | 集群名称 |

---

### cluster_create
创建集群

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | 集群名称 |
| `datacenter` | string | **是** | 数据中心名称 |
| `cpu_type` | string | **是** | CPU 类型 |
| `description` | string | 否 | 描述 |
| `gluster_service` | boolean | 否 | 是否启用 Gluster 服务 |
| `threads_per_core` | number | 否 | 每核心线程数 |

---

### cluster_update
更新集群

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 集群名称或 ID |
| `new_name` | string | 否 | 新名称 |
| `description` | string | 否 | 新描述 |
| `threads_per_core` | number | 否 | 每核心线程数 |

---

### cluster_delete
删除集群

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 集群名称或 ID |

---

### cluster_hosts
集群主机

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | 集群名称 |

---

### cluster_vms
集群 VM

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | 集群名称 |
| `status` | string | 否 | VM 状态过滤（可选） |

---

### cluster_cpu_load
集群 CPU 负载

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | 集群名称 |

---

### cluster_memory_usage
集群内存使用

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | 集群名称 |

---

## CPU Profiles

### cpu_profile_list
列出 CPU Profile

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `cluster` | string | **是** | 集群名称或 ID |

---

### cpu_profile_get
获取 CPU Profile 详情

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `cluster` | string | **是** | 集群名称或 ID |
| `name_or_id` | string | **是** | Profile 名称或 ID |





path: references/datacenter.md
content: # 目录索引

| 工具 | 分类 |
|------|------|
| [datacenter_list](#datacenter_list) | Data Centers |
| [datacenter_get](#datacenter_get) | Data Centers |
| [datacenter_create](#datacenter_create) | Data Centers |
| [datacenter_update](#datacenter_update) | Data Centers |
| [datacenter_delete](#datacenter_delete) | Data Centers |

---

## Data Centers

### datacenter_list
列出数据中心

**参数：**（无参数）

---

### datacenter_get
获取数据中心详情

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 数据中心名称或 ID |

---

### datacenter_create
创建数据中心

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | 数据中心名称 |
| `storage_type` | string | 否 | 存储类型（nfs/fc/iscsi等），默认 nfs |
| `description` | string | 否 | 描述 |

---

### datacenter_update
更新数据中心

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 数据中心名称或 ID |
| `new_name` | string | 否 | 新名称（可选） |
| `description` | string | 否 | 新描述（可选） |

---

### datacenter_delete
删除数据中心

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 数据中心名称或 ID |


path: references/disk.md
content: # 目录索引

| 工具 | 分类 |
|------|------|
| [disk_list](#disk_list) | Disks Core |
| [disk_create](#disk_create) | Disks Core |
| [disk_attach](#disk_attach) | Disks Core |
| [disk_get](#disk_get) | Disks Extended |
| [disk_delete](#disk_delete) | Disks Extended |
| [disk_resize](#disk_resize) | Disks Extended |
| [disk_detach](#disk_detach) | Disks Extended |
| [disk_move](#disk_move) | Disks Extended |
| [disk_stats](#disk_stats) | Disks Extended |
| [disk_update](#disk_update) | Disks Extended |
| [disk_sparsify](#disk_sparsify) | Disks Extended |
| [disk_export](#disk_export) | Disks Extended |
| [disk_snapshot_list](#disk_snapshot_list) | Disks Extended |

---

## Disks Core

### disk_list
列出磁盘

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | 否 | VM 名称或 ID（可选） |
| `storage_domain` | string | 否 | 存储域名称（可选） |

---

### disk_create
创建磁盘

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | 磁盘名称 |
| `size_gb` | number | **是** | 磁盘大小（GB） |
| `storage_domain` | string | 否 | 存储域名称 |
| `format` | string | 否 | 磁盘格式（cow/raw），默认 cow |

---

### disk_attach
附加磁盘

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | VM 名称或 ID |
| `disk_id` | string | **是** | 磁盘 ID |

---

## Disks Extended

### disk_get
获取磁盘详情

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 磁盘名称或 ID |

---

### disk_delete
删除磁盘

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 磁盘名称或 ID |
| `force` | boolean | 否 | 强制删除，默认 false |

---

### disk_resize
调整磁盘大小

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 磁盘名称或 ID |
| `new_size_gb` | number | **是** | 新大小（GB） |

---

### disk_detach
从虚拟机分离磁盘

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 磁盘名称或 ID |
| `vm_name_or_id` | string | **是** | VM 名称或 ID |

---

### disk_move
移动磁盘到另一个存储域

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 磁盘名称或 ID |
| `target_storage_domain` | string | **是** | 目标存储域名称 |

---

### disk_stats
获取磁盘统计信息

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 磁盘名称或 ID |

---

### disk_update
更新磁盘配置

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 磁盘名称或 ID |
| `new_name` | string | 否 | 新名称 |
| `description` | string | 否 | 新描述 |
| `shareable` | boolean | 否 | 是否可共享 |
| `wipe_after_delete` | boolean | 否 | 删除后擦除 |

---

### disk_sparsify
精简磁盘（消除空白块）

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 磁盘名称或 ID |

---

### disk_export
导出磁盘到导出域

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 磁盘名称或 ID |
| `export_domain` | string | **是** | 导出域名称 |

---

### disk_snapshot_list
列出磁盘快照

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `disk_name_or_id` | string | **是** | 磁盘名称或 ID |



path: references/events.md
content: # 目录索引

| 工具 | 分类 |
|------|------|
| [event_list](#event_list) | Events |
| [event_get](#event_get) | Events |
| [event_search](#event_search) | Events |
| [event_alerts](#event_alerts) | Events |
| [event_errors](#event_errors) | Events |
| [event_warnings](#event_warnings) | Events |
| [event_summary](#event_summary) | Events |
| [event_acknowledge](#event_acknowledge) | Events |
| [event_clear_alerts](#event_clear_alerts) | Events |
| [event_subscription_list](#event_subscription_list) | Events |
| [bookmark_list](#bookmark_list) | Events |

---

## Events

### event_list
列出事件

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `search` | string | 否 | 搜索条件（可选） |
| `severity` | string | 否 | 严重级别过滤（error/warning/info/alert） |
| `page` | number | 否 | 页码，默认 1 |
| `page_size` | number | 否 | 每页数量，默认 50 |

---

### event_get
获取事件详情

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `event_id` | string | **是** | 事件 ID |

---

### event_search
搜索事件

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `query` | string | **是** | 搜索查询 |
| `page` | number | 否 | 页码，默认 1 |
| `page_size` | number | 否 | 每页数量，默认 50 |

---

### event_alerts
获取告警事件

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `page` | number | 否 | 页码，默认 1 |
| `page_size` | number | 否 | 每页数量，默认 50 |

---

### event_errors
获取错误事件

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `page` | number | 否 | 页码，默认 1 |
| `page_size` | number | 否 | 每页数量，默认 50 |

---

### event_warnings
获取警告事件

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `page` | number | 否 | 页码，默认 1 |
| `page_size` | number | 否 | 每页数量，默认 50 |

---

### event_summary
获取事件统计摘要

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `hours` | number | 否 | 统计最近 N 小时，默认 24 |

---

### event_acknowledge
确认事件

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `event_id` | string | **是** | 事件 ID |

---

### event_clear_alerts
清除告警事件

**参数：**（无参数）

---

### event_subscription_list
列出事件订阅

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `user` | string | 否 | 用户名称（可选） |

---

### bookmark_list
列出书签

**参数：**（无参数）



path: references/host.md
content: # 目录索引

| 工具 | 分类 |
|------|------|
| [host_list](#host_list) | Hosts Core |
| [host_activate](#host_activate) | Hosts Core |
| [host_deactivate](#host_deactivate) | Hosts Core |
| [host_get](#host_get) | Hosts Extended |
| [host_add](#host_add) | Hosts Extended |
| [host_remove](#host_remove) | Hosts Extended |
| [host_stats](#host_stats) | Hosts Extended |
| [host_devices](#host_devices) | Hosts Extended |
| [host_nic_list](#host_nic_list) | Hosts Extended |
| [host_nic_update](#host_nic_update) | Hosts Extended |
| [host_numa_get](#host_numa_get) | Hosts Extended |
| [host_hook_list](#host_hook_list) | Hosts Extended |
| [host_fence](#host_fence) | Hosts Extended |
| [host_network_update](#host_network_update) | Hosts Extended |
| [host_device_update](#host_device_update) | Hosts Extended |
| [host_storage_list](#host_storage_list) | Hosts Extended |
| [host_install](#host_install) | Hosts Extended |
| [host_iscsi_discover](#host_iscsi_discover) | Hosts Extended |
| [host_iscsi_login](#host_iscsi_login) | Hosts Extended |

---

## Hosts Core

### host_list
列出主机

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `cluster` | string | 否 | 集群名称（可选） |

---

### host_activate
激活主机

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 主机名称或 ID |

---

### host_deactivate
维护主机

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 主机名称或 ID |

---

## Hosts Extended

### host_get
获取主机详情

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 主机名称或 ID |

---

### host_add
添加主机

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | 主机名称 |
| `cluster` | string | **是** | 集群名称 |
| `address` | string | **是** | 主机地址 |
| `password` | string | 否 | SSH 密码（可选） |
| `ssh_port` | number | 否 | SSH 端口，默认 22 |

---

### host_remove
移除主机

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 主机名称或 ID |
| `force` | boolean | 否 | 强制移除，默认 false |

---

### host_stats
获取主机统计信息

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 主机名称或 ID |

---

### host_devices
获取主机设备列表

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 主机名称或 ID |

---

### host_nic_list
列出主机网卡

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 主机名称或 ID |

---

### host_nic_update
更新主机网卡配置

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 主机名称或 ID |
| `nic_name` | string | **是** | 网卡名称 |
| `custom_properties` | object | 否 | 自定义属性 |

---

### host_numa_get
获取主机 NUMA 拓扑

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 主机名称或 ID |

---

### host_hook_list
列出主机 Hook

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 主机名称或 ID |

---

### host_fence
对主机执行 Fence 操作

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 主机名称或 ID |
| `action` | string | **是** | 操作类型（restart/start/stop/status） |

---

### host_network_update
更新主机网络配置

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 主机名称或 ID |
| `network` | string | **是** | 网络名称 |
| `nic` | string | 否 | 网卡名称（可选） |
| `vlan_id` | number | 否 | VLAN ID（可选） |
| `bond` | string | 否 | 绑定接口名称（可选） |

---

### host_device_update
更新主机设备配置

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 主机名称或 ID |
| `device_name` | string | **是** | 设备名称 |
| `enabled` | boolean | 否 | 是否启用 |

---

### host_storage_list
列出主机存储

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 主机名称或 ID |

---

### host_install
安装/重新安装主机

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 主机名称或 ID |
| `root_password` | string | 否 | root 密码 |
| `ssh_key` | string | 否 | SSH 公钥 |
| `override_iptables` | boolean | 否 | 覆盖 iptables 规则 |

---

### host_iscsi_discover
发现 iSCSI 目标

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 主机名称或 ID |
| `address` | string | **是** | iSCSI 目标地址 |
| `port` | number | 否 | 端口号，默认 3260 |
| `username` | string | 否 | CHAP 用户名（可选） |
| `password` | string | 否 | CHAP 密码（可选） |

---

### host_iscsi_login
登录到 iSCSI 目标

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 主机名称或 ID |
| `address` | string | **是** | iSCSI 目标地址 |
| `target` | string | **是** | 目标名称 |
| `port` | number | 否 | 端口号，默认 3260 |
| `username` | string | 否 | CHAP 用户名（可选） |
| `password` | string | 否 | CHAP 密码（可选） |



path: references/instance-types.md
content: # 目录索引

| 工具 | 分类 |
|------|------|
| [instance_type_list](#instance_type_list) | Instance Types |
| [instance_type_get](#instance_type_get) | Instance Types |

---

## Instance Types

### instance_type_list
列出实例类型

**参数：**（无参数）

---

### instance_type_get
获取实例类型详情

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 实例类型名称或 ID |



path: references/network.md
content: # 目录索引

| 工具 | 分类 |
|------|------|
| [network_list](#network_list) | Networks |
| [network_get](#network_get) | Networks |
| [network_create](#network_create) | Networks |
| [network_update](#network_update) | Networks |
| [network_delete](#network_delete) | Networks |
| [nic_list](#nic_list) | Networks |
| [nic_add](#nic_add) | Networks |
| [nic_remove](#nic_remove) | Networks |
| [vnic_profile_list](#vnic_profile_list) | VNIC Profiles |
| [vnic_profile_get](#vnic_profile_get) | VNIC Profiles |
| [vnic_profile_create](#vnic_profile_create) | VNIC Profiles |
| [vnic_profile_update](#vnic_profile_update) | VNIC Profiles |
| [vnic_profile_delete](#vnic_profile_delete) | VNIC Profiles |
| [network_filter_list](#network_filter_list) | Network Filters & QoS |
| [mac_pool_list](#mac_pool_list) | Network Filters & QoS |
| [qos_list](#qos_list) | Network Filters & QoS |

---

## Networks

### network_list
列出网络

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `cluster` | string | 否 | 集群名称（可选） |

---

### network_get
获取网络详情

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 网络名称或 ID |

---

### network_create
创建网络

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | 网络名称 |
| `cluster` | string | 否 | 集群名称（可选） |
| `datacenter` | string | 否 | 数据中心名称（可选） |
| `description` | string | 否 | 描述 |
| `mtu` | number | 否 | MTU 值 |

---

### network_update
更新网络

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | 网络名称 |
| `new_name` | string | 否 | 新名称 |
| `description` | string | 否 | 新描述 |

---

### network_delete
删除网络

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 网络名称或 ID |

---

### nic_list
列出网卡

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | VM 名称或 ID |

---

### nic_add
添加网卡

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | VM 名称或 ID |
| `nic_name` | string | **是** | 网卡名称 |
| `network` | string | **是** | 网络名称 |

---

### nic_remove
移除网卡

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | VM 名称或 ID |
| `nic_name` | string | **是** | 网卡名称 |

---

## VNIC Profiles

### vnic_profile_list
列出 VNIC Profile

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `network` | string | 否 | 网络名称（可选） |

---

### vnic_profile_get
获取 VNIC Profile 详情

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | Profile 名称或 ID |

---

### vnic_profile_create
创建 VNIC Profile

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | Profile 名称 |
| `network` | string | **是** | 网络名称 |
| `description` | string | 否 | 描述 |
| `port_mirroring` | boolean | 否 | 是否启用端口镜像 |

---

### vnic_profile_update
更新 VNIC Profile

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | Profile 名称或 ID |
| `new_name` | string | 否 | 新名称 |
| `description` | string | 否 | 新描述 |
| `port_mirroring` | boolean | 否 | 端口镜像设置 |

---

### vnic_profile_delete
删除 VNIC Profile

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | Profile 名称或 ID |

---

## Network Filters & QoS

### network_filter_list
列出网络过滤器

**参数：**（无参数）

---

### mac_pool_list
列出 MAC 地址池

**参数：**（无参数）

---

### qos_list
列出 QoS 配置

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `datacenter` | string | 否 | 数据中心名称（可选） |



path: references/quota.md
content: # 目录索引

| 工具 | 分类 |
|------|------|
| [quota_list](#quota_list) | Quota |
| [quota_get](#quota_get) | Quota |
| [quota_create](#quota_create) | Quota |
| [quota_update](#quota_update) | Quota |
| [quota_delete](#quota_delete) | Quota |
| [quota_cluster_limit_list](#quota_cluster_limit_list) | Quota |
| [quota_storage_limit_list](#quota_storage_limit_list) | Quota |

---

## Quota

### quota_list
列出数据中心的配额

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `datacenter` | string | **是** | 数据中心名称或 ID |

---

### quota_get
获取配额详情

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `datacenter` | string | **是** | 数据中心名称或 ID |
| `name_or_id` | string | **是** | 配额名称或 ID |

---

### quota_create
创建配额

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | 配额名称 |
| `datacenter` | string | **是** | 数据中心名称 |
| `description` | string | 否 | 描述 |
| `cluster_hard_limit_pct` | number | 否 | 集群硬限制百分比 |
| `storage_hard_limit_pct` | number | 否 | 存储硬限制百分比 |

---

### quota_update
更新配额

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `datacenter` | string | **是** | 数据中心名称或 ID |
| `name_or_id` | string | **是** | 配额名称或 ID |
| `new_name` | string | 否 | 新名称 |
| `description` | string | 否 | 新描述 |
| `cluster_hard_limit_pct` | number | 否 | 集群硬限制百分比 |
| `storage_hard_limit_pct` | number | 否 | 存储硬限制百分比 |

---

### quota_delete
删除配额

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `datacenter` | string | **是** | 数据中心名称或 ID |
| `name_or_id` | string | **是** | 配额名称或 ID |

---

### quota_cluster_limit_list
列出配额的集群限制

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `datacenter` | string | **是** | 数据中心名称或 ID |
| `name_or_id` | string | **是** | 配额名称或 ID |

---

### quota_storage_limit_list
列出配额的存储限制

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `datacenter` | string | **是** | 数据中心名称或 ID |
| `name_or_id` | string | **是** | 配额名称或 ID |



path: references/rbac.md
content: # 目录索引

| 工具 | 分类 |
|------|------|
| [user_list](#user_list) | RBAC Users |
| [user_get](#user_get) | RBAC Users |
| [user_create](#user_create) | RBAC Users |
| [user_update](#user_update) | RBAC Users |
| [user_delete](#user_delete) | RBAC Users |
| [user_groups](#user_groups) | RBAC Users |
| [group_list](#group_list) | RBAC Groups |
| [group_get](#group_get) | RBAC Groups |
| [role_list](#role_list) | RBAC Roles |
| [role_get](#role_get) | RBAC Roles |
| [role_create](#role_create) | RBAC Roles |
| [role_update](#role_update) | RBAC Roles |
| [role_delete](#role_delete) | RBAC Roles |
| [permit_list](#permit_list) | RBAC Permissions |
| [permission_list](#permission_list) | RBAC Permissions |
| [permission_assign](#permission_assign) | RBAC Permissions |
| [permission_revoke](#permission_revoke) | RBAC Permissions |
| [tag_list](#tag_list) | RBAC Tags |
| [tag_create](#tag_create) | RBAC Tags |
| [tag_delete](#tag_delete) | RBAC Tags |
| [tag_assign](#tag_assign) | RBAC Tags |
| [tag_unassign](#tag_unassign) | RBAC Tags |
| [tag_list_resources](#tag_list_resources) | RBAC Tags |
| [filter_list](#filter_list) | RBAC Filters |

---

## RBAC Users

### user_list
列出用户

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `search` | string | 否 | 搜索条件（可选） |

---

### user_get
获取用户详情

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 用户名称或 ID |

---

### user_create
创建用户

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `username` | string | **是** | 用户名 |
| `email` | string | 否 | 邮箱 |
| `first_name` | string | 否 | 名 |
| `last_name` | string | 否 | 姓 |

---

### user_update
更新用户

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 用户名称或 ID |
| `email` | string | 否 | 新邮箱 |
| `first_name` | string | 否 | 新名 |
| `last_name` | string | 否 | 新姓 |

---

### user_delete
删除用户

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 用户名称或 ID |

---

### user_groups
列出用户所属的组

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 用户名称或 ID |

---

## RBAC Groups

### group_list
列出用户组

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `search` | string | 否 | 搜索条件（可选） |

---

### group_get
获取用户组详情

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 组名称或 ID |

---

## RBAC Roles

### role_list
列出角色

**参数：**（无参数）

---

### role_get
获取角色详情

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 角色名称或 ID |

---

### role_create
创建角色

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | 角色名称 |
| `description` | string | 否 | 描述（可选） |
| `administrative` | boolean | 否 | 是否为管理员角色，默认 false |
| `permit_ids` | string[] | 否 | 权限 ID 列表 |

---

### role_update
更新角色

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 角色名称或 ID |
| `new_name` | string | 否 | 新名称 |
| `description` | string | 否 | 新描述 |

---

### role_delete
删除角色

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 角色名称或 ID |

---

## RBAC Permissions

### permit_list
列出所有权限单元

**参数：**（无参数）

---

### permission_list
列出资源的权限

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `resource_type` | string | **是** | 资源类型（vm/host/cluster/datacenter/network/storagedomain/template） |
| `resource_id` | string | **是** | 资源 ID 或名称 |

---

### permission_assign
分配权限

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `resource_type` | string | **是** | 资源类型（vm/host/cluster/datacenter/network/storagedomain/template） |
| `resource_id` | string | **是** | 资源 ID 或名称 |
| `user_or_group` | string | **是** | 主体类型（user 或 group） |
| `role_name` | string | **是** | 角色名称或 ID |
| `principal_name` | string | **是** | 用户名或组名 |

---

### permission_revoke
撤销权限

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `resource_type` | string | **是** | 资源类型 |
| `resource_id` | string | **是** | 资源 ID 或名称 |
| `permission_id` | string | **是** | 权限 ID |

---

## RBAC Tags

### tag_list
列出所有标签

**参数：**（无参数）

---

### tag_create
创建标签

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | 标签名称 |
| `description` | string | 否 | 描述（可选） |
| `parent_name` | string | 否 | 父标签名称（可选） |

---

### tag_delete
删除标签

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 标签名称或 ID |

---

### tag_assign
为资源分配标签

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `resource_type` | string | **是** | 资源类型（vm/host/cluster/datacenter/network/storagedomain/template） |
| `resource_id` | string | **是** | 资源 ID 或名称 |
| `tag_name` | string | **是** | 标签名称或 ID |

---

### tag_unassign
移除资源的标签

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `resource_type` | string | **是** | 资源类型 |
| `resource_id` | string | **是** | 资源 ID 或名称 |
| `tag_name` | string | **是** | 标签名称或 ID |

---

### tag_list_resources
列出资源的标签

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `resource_type` | string | **是** | 资源类型 |
| `resource_id` | string | **是** | 资源 ID 或名称 |

---

## RBAC Filters

### filter_list
列出权限过滤器

**参数：**（无参数）



path: references/storage.md
content: # 目录索引

| 工具 | 分类 |
|------|------|
| [storage_list](#storage_list) | Storage Core |
| [storage_attach](#storage_attach) | Storage Core |
| [storage_get](#storage_get) | Storage Extended |
| [storage_create](#storage_create) | Storage Extended |
| [storage_delete](#storage_delete) | Storage Extended |
| [storage_detach](#storage_detach) | Storage Extended |
| [storage_attach_to_dc](#storage_attach_to_dc) | Storage Extended |
| [storage_stats](#storage_stats) | Storage Extended |
| [storage_refresh](#storage_refresh) | Storage Extended |
| [storage_update](#storage_update) | Storage Extended |
| [storage_files](#storage_files) | Storage Extended |
| [storage_connections_list](#storage_connections_list) | Storage Extended |
| [storage_available_disks](#storage_available_disks) | Storage Extended |
| [storage_export_vms](#storage_export_vms) | Storage Extended |
| [storage_import_vm](#storage_import_vm) | Storage Extended |
| [iscsi_bond_list](#iscsi_bond_list) | Storage Extended |

---

## Storage Core

### storage_list
列出存储域

**参数：**（无参数）

---

### storage_attach
挂载存储

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `storage_name` | string | **是** | 存储域名称 |
| `dc_name` | string | **是** | 数据中心名称 |

---

## Storage Extended

### storage_get
获取存储域详情

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 存储域名称或 ID |

---

### storage_create
创建存储域

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | 存储域名称 |
| `storage_type` | string | **是** | 存储类型（nfs/fc/iscsi等） |
| `host` | string | **是** | 主机名称 |
| `path` | string | **是** | 存储路径 |
| `datacenter` | string | 否 | 数据中心名称（可选） |
| `description` | string | 否 | 描述 |
| `domain_type` | string | 否 | 域类型（data/iso/export），默认 data |

---

### storage_delete
删除存储域

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 存储域名称或 ID |
| `force` | boolean | 否 | 强制删除，默认 false |

---

### storage_detach
分离存储域

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 存储域名称或 ID |
| `datacenter` | string | 否 | 数据中心名称（可选） |

---

### storage_attach_to_dc
附加存储域到数据中心

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 存储域名称或 ID |
| `datacenter` | string | **是** | 数据中心名称 |

---

### storage_stats
获取存储域统计信息

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 存储域名称或 ID |

---

### storage_refresh
刷新存储域

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 存储域名称或 ID |

---

### storage_update
更新存储域配置

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 存储域名称或 ID |
| `new_name` | string | 否 | 新名称 |
| `description` | string | 否 | 新描述 |
| `warning_low_space` | number | 否 | 低空间警告阈值（GB） |
| `critical_low_space` | number | 否 | 临界空间阈值（GB） |

---

### storage_files
列出存储域的文件

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 存储域名称或 ID |

---

### storage_connections_list
列出存储连接

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | 否 | 存储域名称或 ID（可选） |

---

### storage_available_disks
列出存储域上的可用磁盘

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 存储域名称或 ID |

---

### storage_export_vms
列出导出域上的 VM

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 导出域名称或 ID |

---

### storage_import_vm
从导出域导入 VM

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 导出域名称或 ID |
| `vm_name` | string | **是** | 要导入的 VM 名称 |
| `cluster` | string | **是** | 目标集群 |
| `storage_domain` | string | 否 | 目标存储域（可选） |
| `clone` | boolean | 否 | 是否克隆 |

---

### iscsi_bond_list
列出 iSCSI Bond

**参数：**（无参数）



path: references/system.md
content: # 目录索引

| 工具 | 分类 |
|------|------|
| [system_get](#system_get) | System & Jobs |
| [system_option_list](#system_option_list) | System & Jobs |
| [job_list](#job_list) | System & Jobs |
| [job_get](#job_get) | System & Jobs |
| [job_cancel](#job_cancel) | System & Jobs |
| [system_statistics](#system_statistics) | System & Jobs |

---

## System & Jobs

### system_get
获取系统信息

**参数：**（无参数）

---

### system_option_list
列出系统选项

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `category` | string | 否 | 选项分类（可选） |

---

### job_list
列出任务

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `page` | number | 否 | 页码 |
| `page_size` | number | 否 | 每页数量 |

---

### job_get
获取任务详情

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `job_id` | string | **是** | 任务 ID |

---

### job_cancel
取消任务

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `job_id` | string | **是** | 任务 ID |
| `force` | boolean | 否 | 强制取消 |

---

### system_statistics
获取系统统计信息

**参数：**（无参数）



path: references/template.md
content: # 目录索引

| 工具 | 分类 |
|------|------|
| [template_disk_list](#template_disk_list) | Templates |
| [template_nic_list](#template_nic_list) | Templates |
| [template_list](#template_list) | Templates |
| [template_vm_create](#template_vm_create) | Templates |
| [template_get](#template_get) | Templates |
| [template_create](#template_create) | Templates |
| [template_delete](#template_delete) | Templates |
| [template_update](#template_update) | Templates |

---

## Templates

### template_disk_list
列出模板的磁盘

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 模板名称或 ID |

---

### template_nic_list
列出模板的网卡

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 模板名称或 ID |

---

### template_list
列出模板

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `cluster` | string | 否 | 集群名称（可选） |

---

### template_vm_create
从模板创建 VM

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | VM 名称 |
| `template` | string | **是** | 模板名称 |
| `cluster` | string | **是** | 目标集群 |
| `memory_mb` | number | 否 | 内存（MB），可选 |
| `cpu_cores` | number | 否 | CPU 核数，可选 |

---

### template_get
获取模板详情

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 模板名称或 ID |

---

### template_create
从虚拟机创建模板

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name` | string | **是** | 模板名称 |
| `vm` | string | **是** | 源虚拟机名称或 ID |
| `description` | string | 否 | 描述 |
| `cluster` | string | 否 | 目标集群（可选） |

---

### template_delete
删除模板

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 模板名称或 ID |
| `force` | boolean | 否 | 强制删除 |

---

### template_update
更新模板

**参数：**
| 参数 | 类型 | 必填 | 描述 |
|------|------|------|------|
| `name_or_id` | string | **是** | 模板名称或 ID |
| `new_name` | string | 否 | 新名称 |
| `description` | string | 否 | 新描述 |
| `memory_mb` | number | 否 | 内存（MB） |
| `cpu_cores` | number | 否 | CPU 核数 |



Security scan verdicts — ClawScan: suspicious | static analysis: clean | VirusTotal: stale | SkillSpector: suspicious (CRITICAL)