calls 使用量

子孫 call を含めて集計し、複数のルート call の集約使用量を計算します。

POST /calls/usage

calls 使用量

cURL

curl --request POST \
  --url https://api.example.com/calls/usage \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "project_id": "<string>",
  "call_ids": [
    "<string>"
  ],
  "include_costs": false,
  "limit": 10000
}
'

200

{
  "call_usage": {},
  "unfinished_call_ids": [
    "<string>"
  ]
}

承認

Authorization · string · header · 必須

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

ボディ

application/json

複数のルート call の集計された使用状況を計算するリクエスト。

この Endpoint は、リクエストされた各ルート call の使用状況メトリクスを返します。各ルートのメトリクスには、そのルート自身の使用状況の合計に加えて、すべての子孫の使用状況の合計も含まれます。

注: 集計のために、条件に一致するすべての call がメモリに読み込まれます。結果セットが非常に大きい場合（>10k calls）は、ルート call ID をバッチ処理するか、application レイヤーでより限定的なフィルターを使用することを検討してください。

project_id · string · 必須

call_ids · string[] · 必須

集計するルート call ID。各結果キーは、それぞれ 1 つの入力 call ID に対応します。

include_costs · boolean · デフォルト: false

true の場合、使用状況にコスト計算を含めます。

limit · integer · デフォルト: 10000

すべてのトレースにわたって処理する call の最大数。メモリ使用量が際限なく増えるのを防ぐための安全上限として機能します。

レスポンス

200

application/json

成功レスポンス

ルート call ごとの集計された使用状況メトリクスを含むレスポンス。

call_usage · Call Usage · object

Show child attributes

unfinished_call_ids · string[]