기능 플래그 사용자 목록 API 속도 제한
GitLab v19.6Offering: GitLab Self-Managed, GitLab Dedicated
요약
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 한 사용자가 큰 사용자 목록을 반복해서 쓰면 인스턴스에 상당한 부하가 걸릴 수 있습니다. 이 속도 제한은 GitLab UI도 사용하는 기능 플래그 사용자 목록 생성 및 기능 플래그 사용자 목록 업데이트 REST API 엔드포인트에 적용됩니다.
히스토리
- GitLab 19.6에서
rate_limit_feature_flag_user_list_write_bytes라는 기능 플래그와 함께 도입되었습니다. 기본적으로 비활성화되어 있습니다.
이 기능의 사용 가능 여부는 기능 플래그로 제어됩니다. 자세한 내용은 히스토리를 참조합니다.
한 사용자가 큰 사용자 목록을 반복해서 쓰면 인스턴스에 상당한 부하가 걸릴 수 있습니다. 이를 방지하기 위해 사용자별로 쓸 수 있는 사용자 목록의 바이트 수를 제한할 수 있습니다.
이 속도 제한은 GitLab UI도 사용하는 기능 플래그 사용자 목록 생성
및 기능 플래그 사용자 목록 업데이트
REST API 엔드포인트에 적용됩니다.
각 요청은 user_xids 값의 크기(바이트)를 계산합니다.
목록 이름만 바꾸는 요청처럼 사용자 ID를 보내지 않는 요청은 제한에 포함되지 않습니다.
이 속도 제한은 다음과 같습니다.
- 사용자별로 적용됩니다.
- 기본값은 분당
16777216바이트(16 MiB)입니다. 0으로 설정하면 속도 제한이 비활성화됩니다.
제한을 초과하면 REST API는 429 Too Many Requests를 반환합니다.
제한보다 큰 단일 요청은 해당 분에 사용자의 첫 요청이어도 차단됩니다.
속도 제한 변경#
사전 요구 사항:
- 관리자 액세스 권한이 있어야 합니다.
속도 제한을 변경하려면 다음과 같이 합니다.
- 오른쪽 상단 모서리에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > Network를 선택합니다.
- Feature flag user lists API rate limits를 확장합니다.
- Maximum bytes of user lists written per minute per user 텍스트 상자에 값을 입력합니다.
- Save changes를 선택합니다.