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

查询容量快照列表

列表已存储容量快照可选过滤资源类型租户。

GET/api/v1/monitoring/capacity/snapshots

操作 ID

ListCapacitySnapshots

起始版本

1.0.0

执行模式

同步

认证信息

需要认证

认证信息

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

Authorizationstring必填

Bearer 令牌

X-Tenant-IDstring

X-Tenant-ID

请求参数

查询参数

  • resourceType
    String

    资源类型。

  • tenantId
    String

    租户ID。

  • limit
    Integer

    最多返回的记录数。

    示例： 0

响应状态

200 OK
200 OK

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

  • items
    List

    条目列表。

    示例： (nested array)

    • id
      String

      资源ID。

      示例： snap-001-abc

    • resourceType
      String

      资源类型。

      示例： vm

    • totalCount
      Integer

      总数量。

      示例： 500

    • activeCount
      Integer

      活跃数量。

      示例： 480

    • usagePercent
      Long

      使用量百分比时间快照。

      示例： 96

    • timestamp
      String

      时间戳。

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

    • tenantId
      String

      租户ID。

      示例： tenant-001-xyz

  • total
    Integer

    返回结果总数。

    示例： 100

  • limit
    Integer

    最大返回条目数。

    示例： 20

  • offset
    Integer

    查询起始偏移量。

    示例： 20