Projects API 속도 제한
GitLab v19.6Offering: GitLab Self-Managed, GitLab Dedicated
요약
GitLab 18.0 이상으로 업그레이드하면 이 API에 대해 구성할 수 있는 속도 제한이 0으로 설정됩니다. 다음 Projects API 엔드포인트에 대한 요청의 IP 주소별 및 사용자별 속도 제한을 구성합니다. 속도 제한을 변경하려면 다음을 수행합니다.
GitLab 18.0 이상으로 업그레이드하면 이 API에 대해 구성할 수 있는 속도 제한이 0으로 설정됩니다. 관리자는 필요에 따라 속도 제한을 조정할 수 있습니다. 영향을 받는 속도 제한은 Projects, Groups, Users API에 대해 공지된 속도 제한을 참고합니다.
Projects API 속도 제한 구성#
히스토리
다음 Projects API 엔드포인트에 대한 요청의 IP 주소별 및 사용자별 속도 제한을 구성합니다.
| 제한 | 기본값 | 간격 |
|---|---|---|
GET /projects (인증되지 않은 요청) |
400 | 10분 |
GET /projects (인증된 요청) |
2000 | 10분 |
GET /projects/:id |
400 | 1분 |
GET /users/:user_id/projects |
300 | 1분 |
GET /users/:user_id/contributed_projects |
100 | 1분 |
GET /users/:user_id/starred_projects |
100 | 1분 |
POST /projects |
200 | 1일 |
사전 요구 사항:
- 관리자 접근 권한.
속도 제한을 변경하려면 다음을 수행합니다.
- 오른쪽 위 모서리에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > Network를 선택합니다.
- Projects API rate limits를 확장합니다.
- 속도 제한 값을 변경하거나, 속도 제한을 비활성화하려면
0으로 설정합니다. - Save changes를 선택합니다.
속도 제한은 다음과 같이 적용됩니다.
- 인증된 각 사용자에게 적용됩니다. 요청이 인증되지 않았다면 속도 제한은 IP 주소에 적용됩니다.
속도 제한을 초과한 요청은 auth.log 파일에 기록됩니다.
예를 들어 GET /projects/:id에 400의 제한을 설정하면, 분당 400개의 요청 속도를
초과하는 API 엔드포인트 요청은 차단됩니다. 엔드포인트 접근은 1분 후에 복원됩니다.
프로젝트 API 엔드포인트에 대한 자세한 내용은 프로젝트 API를 참고합니다.
프로젝트 구성원 삭제에 대한 속도 제한 구성#
구성원 삭제 엔드포인트에 대한 요청의 프로젝트별 및 사용자별 속도 제한을 구성합니다.
사전 요구 사항:
- 관리자 접근 권한.
속도 제한을 변경하려면 다음을 수행합니다.
- 오른쪽 위 모서리에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > Network를 선택합니다.
- Members API rate limits를 확장합니다.
- Maximum requests per minute per group / project 텍스트 상자에 값을 입력합니다.
- Save changes를 선택합니다.
이 속도 제한은 다음과 같습니다.
- 기본값은 분당 60개 요청입니다.
- 각 프로젝트와 사용자에게 적용됩니다.
- 속도 제한을 비활성화하려면
0으로 설정할 수 있습니다.
속도 제한을 초과한 요청은 auth.log 파일에 기록됩니다.
예를 들어 60의 제한을 설정하면, 분당 60개의 요청 속도를 초과하는 API 엔드포인트 요청은 차단됩니다. 엔드포인트 접근은 1분 후에 재개됩니다.
프로젝트 구성원 목록 조회에 대한 속도 제한 구성#
히스토리
- GitLab 18.6에서 도입되었습니다.
프로젝트 구성원 목록 조회 엔드포인트에 대한 요청의 속도 제한을 구성합니다.
GET /projects/:id/members/all과 GET /groups/:id/members/all
API 엔드포인트는 같은 속도 제한 구성을 공유합니다. 프로젝트 엔드포인트에 속도 제한을 설정하면
그룹 엔드포인트에도 해당 속도 제한이 적용됩니다.
사전 요구 사항:
- 관리자 접근 권한.
속도 제한을 변경하려면 다음을 수행합니다.
- 오른쪽 위 모서리에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > Network를 선택합니다.
- Projects API rate limits를 확장합니다.
- Maximum requests to the
GET /projects/:id/members/allAPI per minute per user or IP address 텍스트 상자에 값을 입력합니다. - Save changes를 선택합니다.
이 속도 제한은 다음과 같습니다.
- 기본값은 분당 200개 요청입니다.
- 인증된 각 사용자에게 적용됩니다. 요청이 인증되지 않았다면 속도 제한은 IP 주소에 적용됩니다.
- 속도 제한을 비활성화하려면
0으로 설정할 수 있습니다.
속도 제한을 초과한 요청은 auth.log 파일에 기록됩니다.
예를 들어 200의 제한을 설정하면, 분당 200개의 요청 속도를 초과하는 API 엔드포인트 요청은 차단됩니다. 엔드포인트 접근은 1분 후에 재개됩니다.