Usage API
컴퓨트 사용량을 프로그램으로 읽습니다. 오늘은 잡 단위 사용량 API, 프로젝트 단위와 전용 호스트는 준비 중입니다.
지금 쓸 수 있는 것
콘솔 API · MCP 탭에서 만든 계정 API 키로 사용량을 읽습니다. 키는 조직 단위이며 Authorization: Bearer로만 전달합니다. 키 값은 만들 때 한 번만 보이고 이후에는 접두사만 표시됩니다.
# per-job usage and charges for the current period
curl -sS https://cicd.im/api/ci/v1/usage \
-H "Authorization: Bearer $CICD_CI_TOKEN"
# the rate card the charges are computed from
curl -sS https://cicd.im/api/ci/v1/rates \
-H "Authorization: Bearer $CICD_CI_TOKEN"같은 숫자를 콘솔 사용량 · 한도 화면에서 KST 일별로 보거나 CSV로 내려받을 수 있고, 월 사용 한도와 동시 실행 상한도 거기서 설정합니다. 이 값은 고객의 사용량이며 호스트나 러너 대수와는 무관합니다.
프로젝트 단위 사용량
프로젝트 단위 사용량은 GET /api/v1/projects/{id}/usage로 호출할 수 있습니다. 응답에는 이번 결제 기간의 포함 분 사용량과 동시 실행 인스턴스 수, 기간 시작·종료가 들어 있고, 계정 API 키 또는 콘솔 세션으로 읽습니다.
| 필드 | 의미 |
|---|---|
instance_minutes_used | 기간 내 종료된 잡의 과금 분과 실행 중 리스의 현재까지 활성 분의 합계. |
instance_minutes_limit | 플랜의 compute_minutes_limit. |
instance_count_used · instance_count_limit | 동시에 살아 있는 인스턴스 수와 플랜 상한. 정지·삭제 상태는 세지 않습니다. |
billing_period_start · billing_period_end | UTC 기준 구독 기간. |
계획 중: 전용 호스트
사용량 전용 엔드포인트 usage.cicd.im/v1/usage는 계획입니다. 아직 서비스되지 않으며, 준비되면 변경 기록에 공지합니다. 그때까지는 위의 /api/ci/v1/usage를 쓰세요.