A AuthMS API Wiki API Reference iam.tianv.com →

GET /billing/usage/{tenant_id}/timeline

查询指定天数内的用量变化时间序列数据,按日返回用户数、API调用量、存储和带宽使用量,用于趋势分析图表

计费服务 `bearerAuth` application/json

Request Parameters

NameInTypeRequiredDefaultExampleConstraintsDescription
tenant_id path string Yes 租户ID
app_id query string No 应用ID(可选)
days query integer No 30 统计天数

Responses

StatusDescriptionSchema
200用量时间序列查询成功dto.UsageTimelineDetailResponse
400请求参数错误object
401未授权object
500服务器内部错误object

Referenced Schemas

dto.UsageTimelineDetailResponse

FieldTypeRequiredExampleConstraintsDescription
code integer No
data dto.UsageTimelineResponse No
message string No
timestamp string No

dto.UsageTimelinePoint

FieldTypeRequiredExampleConstraintsDescription
api_requests integer No 15000
bandwidth_gb number No 15
date string No 2026-05-01
storage_gb number No 2.5
users integer No 120

dto.UsageTimelineResponse

FieldTypeRequiredExampleConstraintsDescription
app_id string No app_001
days integer No 30
tenant_id string No tnt_xyz789
timeline array of

See dto.UsageTimelinePoint

No