Skip to main content
ZStack
Monitoring & Collection/Monitoring Query & Overview

GetCapacityTrend

Retrieve historical capacity trend data for a given resource type and period

GET/api/v1/monitoring/capacity/trends/{resourceType}

Operation ID

GetCapacityTrend

Since

1.0.0

Execution Mode

Synchronous

Auth Context

Auth Required

Auth Context

Send these values as request headers when calling this API.

AuthorizationstringRequired

Bearer Token

X-Tenant-IDstring

X-Tenant-ID

Request Inputs

Path Parameters

  • resourceType
    StringRequired

    Resource type to query trend for

Query Parameters

  • period
    String

    Period for trend data (e.g. 7d, 30d) Period for trend data (e.g. 7d, 30d)

Responses

200 OK
200 OK

On success, this API returns the following response structure.

  • resourceType
    String

    Resource type this trend covers

    Example: vm

  • period
    String

    Period for this trend (e.g. 7d, 30d)

    Example: 30d

  • dataPoints
    List

    Data points

    Example: (nested array)

    • timestamp
      String

      Timestamp for this resource

      Example: 2026-01-15T08:00:00Z

    • totalCount
      Integer

      Total resource count at this data point

      Example: 490

    • activeCount
      Integer

      Active resource count at this data point

      Example: 470

    • usagePercent
      Long

      Usage percentage at this data point

      Example: 95.9

  • growthRate
    Long

    Growth rate as a decimal fraction (e.g. 0.05 = 5% growth)

    Example: 0.05