사용량 할당량
할당량은 롤링 윈도 안에서 오퍼레이션을 실행할 수 있는 횟수를 제한합니다. 한도에 도달한 사람은 해당 규칙에 작성해 둔 메시지를 받습니다.
오퍼레이션의 규칙
할당량은 설정에서 오퍼레이션에 규칙 목록으로 선언합니다. 규칙은 points로 윈도 안에서 허용되는 최대 실행 횟수를, duration으로 윈도의 길이를 초 단위로 설정합니다. points가 0이면 무제한을 뜻합니다. 윈도는 이동합니다. 각 실행에 타임스탬프가 기록되고, duration보다 오래된 실행은 집계에서 빠집니다.
집계되는 실행
규칙은 로그인한 사용자별로 집계할 수 있으므로 사람마다 자신의 허용량을 가집니다. 할당량은 더 넓은 풀에서 공유할 수도 있습니다.
한도에 도달했을 때
호출이 RATE_LIMITED 오류와 규칙의 메시지로 실패합니다. 메시지가 없는 규칙은 사용량, 한도, 윈도가 초기화되는 시간을 알려 주는 오류를 반환합니다.
규칙 순서로 만드는 티어
규칙은 위에서 아래로 평가되며 처음 일치하는 것이 적용됩니다. 규칙을 세그먼트의 구성원으로 한정할 수 있으므로 티어 구성이 가능합니다. 유료 사용자 세그먼트에는 무제한 규칙을 두고, 그 뒤에 나머지 모두에게 적용할 계량 규칙을 두는 식입니다.
검사 순서와 실패 처리
할당량은 전제 조건 통과 후에 검사됩니다. 카운터 저장소를 읽을 수 없으면 규칙은 기본적으로 호출을 허용하며, 규칙을 실패 시 닫힘으로 설정해 거부하게 할 수도 있습니다. 할당량은 오퍼레이션만 계량합니다.