API 레퍼런스
로그인
본문으로 건너뛰기

조직 티어의 동시 실행과 월 지출 공유 할당량

GET/v1/organizations/{org_id}/limits/quotas

기존 잡과 원장에서 실제 티어 한도와 최근 24시간 피크를 집계합니다, 월 지출은 USD이고 실행 중 예약 사용액을 포함합니다, 월 상한이 없는 Custom은 월 지출 할당량을 생략합니다, 실제 속도 제한이 없는 API 알림 임계값은 반환하지 않습니다, owner와 admin은 워크스페이스를 골라도 조직 전체 값, developer와 API 키는 허용된 워크스페이스 값만 받습니다

API 키 권한 read 또는 콘솔 세션으로 부릅니다, 콘솔 세션은 조직 역할 owner, admin, developer만 됩니다

Headers

  • Authorization: optional string
    Bearer xci_live_… 워크스페이스 API 키, 키 권한 read(run 키도 가능), 콘솔 세션 쿠키로 대신할 수 있습니다

Parameters

  • org_id: string
    조직 ID
    형식 ^org_[A-Za-z0-9]+$
  • workspace_id: optional string
    볼 수 있는 워크스페이스 ID, owner와 admin의 조직 공유 사용량은 유지

Returns

200 application/json

  • 응답 본문: object
    • window: "24h"
      최대 사용률을 관측하는 기간, 최근 24시간
    • quotas: array of object { id, label, metric, … }
      조직 티어의 실제 공유 한도 목록
      • id: "concurrent_jobs" or "monthly_spend"
        할당량 ID, concurrent_jobs 또는 monthly_spend
      • label: string
        할당량의 한국어 이름
      • metric: "concurrent_jobs" or "monthly_spend"
        동시 실행 잡 수 또는 월 지출 지표
      • limit: number
        현재 티어의 공유 상한, 단위는 unit
        최소 0
      • used: number
        호출자가 볼 수 있는 현재 사용량, 월 지출에는 실행 중 예약 사용액 포함
        최소 0
      • peak_percent: number
        최근 24시간 최대 사용량을 현재 상한으로 나눈 백분율
        최소 0
      • unit: "jobs" or "USD"
        잡 수는 jobs, 월 지출은 USD
      • shared: boolean
        조직 전체 워크스페이스에서 공유하는 상한인지

오류

  • invalid_request: HTTP 400
    본문이나 쿼리가 검증에 실패했습니다, error.details.fields에 문제 필드가 있습니다
  • api_key_required: HTTP 401
    API 키 엔드포인트에 Authorization: Bearer 헤더가 없습니다
  • api_key_revoked_leaked: HTTP 401
    공개 유출 신고로 자동 폐기된 키입니다, 새 키를 발급하세요
  • invalid_api_key: HTTP 401
    모르는 키이거나 폐기, 만료, 체크섬 불일치입니다(종료된 xeno_ 접두사 포함)
  • session_required: HTTP 401
    콘솔 엔드포인트를 유효한 콘솔 세션 쿠키 없이 불렀습니다
  • insufficient_permission: HTTP 403
    역할이나 키 권한(run/read)이 이 요청을 허용하지 않습니다
  • ip_not_allowed: HTTP 403
    요청 IP가 조직 또는 API 키의 IP 허용 목록 밖입니다, details.ip와 details.list(organization 또는 api_key)에 있습니다
  • organization_suspended: HTTP 403
    운영자가 조직을 정지했습니다, 키는 거부되고 실행 중인 잡은 멈춥니다
  • not_found: HTTP 404
    자원이 없거나 이 호출자에게 보이지 않습니다
  • rate_limited: HTTP 429, 다시 시도 가능
    이 키 또는 조직의 요청이 너무 많습니다, retry_after_s만큼 기다리세요
  • internal_error: HTTP 500, 다시 시도 가능
    예상하지 못한 오류입니다, 다시 시도하고 반복되면 request_id와 함께 알려 주세요