リファレンスAPI
使用量
usage カテゴリの 1 個の API 操作をカバーします。
| メソッド | パス | 説明 |
|---|---|---|
| GET | /v1/orgs/{orgSlug}/projects/{projectName}/usage | 時間単位の使用量(runlot usage) |
GET /v1/orgs/{orgSlug}/projects/{projectName}/usage
ノードが報告する usage_hourly です(docs/phase6.md D)。リクエスト数と CPU ms は時間バケット内で累積し、storage bytes は最後の観測値です。返されるのは直近 hours 時間分の行のみです — 空の時間バケットには行がありません(ゼロ埋めはされません。ゼロ埋めすると「レポートが来なかった」ことと「値がゼロだった」ことが同じに見えてしまいます)。
これをレート制限に使用しないでください。 ローカル MVP はこの値に基づいてリクエストをブロックしません(docs/local-mvp.md §3)。viewer 以上が必要です。
operationId getUsage
| パラメーター | 場所 | 必須 | 型 | 説明 |
|---|---|---|---|---|
hours | query | 不可 | integer | — |
| ステータスコード | 説明 | レスポンスボディ |
|---|---|---|
| 200 | 使用量 | Usage |
| 403 | — | — |
| 404 | — | — |