根据关键词搜索 ZStack API

Args: keywords: 搜索关键词列表，如 ["Query", "Vm"] 或 ["Create", "Volume"] 支持驼峰拆分匹配，如搜索 "vm" 可以匹配 "QueryVmInstance" category: 可选，按分类过滤，如 "vm", "volume", "network" limit: 最多返回数量，默认 15

Returns: 匹配的 API 列表，包含名称、描述、分类、调用类型

获取指定 ZStack API 的详细参数说明

Args: api_name: API 名称，如 "QueryVmInstance"

Returns: API 的精简信息。对于 Query API，仅返回核心参数和 queryableFields。

执行 ZStack API

注意: 默认只允许调用只读 API（Query/Get/List 等）。 如需调用写操作 API，请设置环境变量 ZSTACK_ALLOW_ALL_API=true

Args: api_name: API 名称，如 "QueryVmInstance" parameters: API 参数字典 对于 Query API，conditions 格式为: [{"name": "字段名", "op": "操作符", "value": "值"}, ...] 分页: limit（默认 50）、start（偏移量） 字段选择: fields（减少返回数据量）

Returns: API 执行结果 (JSON 格式)

Example: execute_api( api_name="QueryVmInstance", parameters={ "conditions": [ {"name": "uuid", "op": "like", "value": "ae6e57a0%"} ] } )

搜索可用的 ZStack 监控指标

Args: keywords: 搜索关键词，如 ["CPU", "Usage"] 或 ["Memory"] 支持驼峰拆分匹配 namespace: 可选，按命名空间过滤（支持模糊匹配），如 "ZStack/VM", "vm", "host" limit: 最多返回数量，默认 20 match_mode: 关键词匹配模式，"and" 或 "or"，默认 "or" prefer_namespaces: 优先排序的命名空间列表（默认 ["ZStack/VM","ZStack/Host"]）

Returns: 匹配的监控指标列表，包含名称、描述、命名空间、可用标签

获取 ZStack 监控数据

Args: namespace: 命名空间，如 "ZStack/VM", "ZStack/Host" metric_name: 指标名称，如 "CPUUsedUtilization" start_time: 开始时间（ISO 或秒级时间戳） end_time: 结束时间（ISO 或秒级时间戳） period: 采样周期(秒)，默认 60 labels: 标签过滤，如 ["VMUuid=xxx"] 或 {"VMUuid":"xxx"} summary_only: 仅返回统计信息（点数/最大/最小/平均/方差/标准差）

注意: 返回数据量与时间跨度和 period 成正比。可用估算公式: 点数 ≈ ceil((end_time - start_time) / period) * series_count series_count 为不同 label 组合数量；若不传 labels，可能返回多组系列 （例如指标包含 CPUNum/VMUuid 等 label 时每个组合都会产出一组序列）。 为避免输出过大：缩短时间范围、增大 period 或增加 labels 过滤。

Returns: 监控数据点列表

获取监控指标的聚合 TopN（按 label_key 分组）

Args: namespace: 命名空间，如 "ZStack/VM", "ZStack/Host" metric_name: 指标名称，如 "CPUOccupiedByVm" label_key: 标签键，如 "VMUuid", "HostUuid" metric_names: 可选，多指标合并（如 in/out） start_time: 开始时间（ISO 或秒级时间戳） end_time: 结束时间（ISO 或秒级时间戳） period: 采样周期(秒)，默认 60 aggregate: 单指标聚合方式，可选 "max"|"avg"|"sum"|"min" combine: 多指标合并方式，可选 "sum"|"avg"|"max"|"min" threshold_op: 阈值比较符，如 >,>=,<,<=,==,!= threshold_value: 阈值数值 top_n: 返回条数，默认 10 resolve_resource: 可选 "vm" 或 "host"，用于解析名称

Returns: 聚合后的 TopN 列表