跳转到主要内容
ZStack
监控与采集相关接口/监控查询与概览

查询模板列表

列表可用查询模板组织分类。

GET/api/v1/monitoring/query-builder/templates

操作 ID

GetQueryTemplates

起始版本

1.0.0

执行模式

同步

认证信息

需要认证

认证信息

调用该 API 时需要在请求头中携带以下认证信息。

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

此接口无需请求参数。

响应状态

200 OK
200 OK

该 API 成功时返回以下响应结构。

  • items
    List

    条目列表。

    示例： (nested array)

    • uuid
      String

      资源的UUID，唯一标识该资源。

      示例： tpl-001-abc

    • name
      String

      资源名称。

      示例： Average CPU by VM

    • description
      String

      资源的详细描述。

      示例： Computes average CPU utilization per VM over the selected time range

    • category
      String

      类型分类。

      示例： compute

    • query
      Object

      查询语句。

      • metric
        String

        指标名称。

        示例： cpu_usage_percent

      • filters
        LinkedHashMap

        过滤条件列表。

        示例： (nested object)

      • condition
        String

        条件表达式。

        示例： resource_type='vm'

      • timeRange
        String

        时间范围。

        示例： 1h

      • aggregation
        String

        聚合方式。

        示例： avg

      • groupBy
        List

        分组字段。

        示例： item1,item2

    • createDate
      String

      创建时间。

      示例： 2026-01-15T08:00:00Z

    • usageCount
      Integer

      使用率数量。

      示例： 17