호출 사용량

여러 루트 호출 전반에 대해, 하위 항목 롤업을 포함한 집계 사용량을 계산합니다.

POST /calls/usage

호출 사용량

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": {}
}

인증

Authorization · string · header · 필수

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

본문

application/json

여러 루트 호출에 대한 집계 사용량을 계산합니다.

이 엔드포인트는 요청된 각 루트 호출에 대한 사용량 메트릭을 반환합니다. 각 루트의 메트릭에는 해당 루트 자체의 사용량과 모든 하위 호출(자식 호출)의 사용량 합계가 포함됩니다.

참고: 집계를 위해 조건에 맞는 모든 호출을 메모리에 로드합니다. 결과 집합이 매우 큰 경우(호출 수가 10k개를 초과하는 경우) 루트 호출 ID를 여러 배치로 나누거나, 애플리케이션 계층에서 보다 제한적인 필터를 사용하는 것을 고려하십시오.

project_id · string · 필수

call_ids · string[] · 필수

집계할 루트 호출 ID입니다. 각 결과 키는 하나의 입력 호출 ID에 대응합니다.

include_costs · boolean · 기본값: false

true인 경우 사용량을 비용 계산에 포함합니다.

limit · integer · 기본값: 10000

모든 트레이스에 걸쳐 처리할 수 있는 최대 호출 수입니다. 무제한 메모리 사용을 방지하기 위한 안전 한계값으로 동작합니다.

응답

200

application/json

성공 응답

루트 호출별로 집계된 사용량 메트릭이 포함된 응답입니다.

call_usage · Call Usage · object

Show child attributes