Groups API 속도 제한
Offering: GitLab Self-Managed, GitLab Dedicated
GitLab 18.0 이상으로 업그레이드할 때, 이 API에 대한 구성 가능한 속도 제한은 0으로 설정됩니다. 다음 Groups API 엔드포인트에 대한 요청의 각 IP 주소 및 사용자별 속도 제한을 구성합니다: 속도 제한을 초과하는 요청은 auth.log 파일에 기록됩니다.
GitLab 18.0 이상으로 업그레이드할 때, 이 API에 대한 구성 가능한 속도 제한은 0으로 설정됩니다. 관리자는 필요에 따라 속도 제한을 조정할 수 있습니다. 영향을 받는 속도 제한에 대한 정보는 Projects, Groups, Users API에 대해 발표된 속도 제한을 참조하세요.
Groups API 속도 제한 구성#
히스토리
- GitLab 17.1에서
rate_limit_groups_and_projects_api라는 플래그와 함께 그룹 및 프로젝트 API에 대한 속도 제한이 도입됨. 기본적으로 비활성화됨. - GitLab 18.1에서 일반적으로 사용 가능해짐. 기능 플래그
rate_limit_groups_and_projects_api가 제거됨.
다음 Groups API 엔드포인트에 대한 요청의 각 IP 주소 및 사용자별 속도 제한을 구성합니다:
| 제한 | 기본값 | 간격 |
|---|---|---|
GET /groups |
200 | 1분 |
GET /groups/:id |
400 | 1분 |
GET /groups/:id/groups/shared |
0 | 1분 |
GET /groups/:id/invited_groups |
60 | 1분 |
GET /groups/:id/projects |
600 | 1분 |
POST /groups/:id/archive |
60 | 1분 |
필수 요건:
- 관리자 액세스.
속도 제한을 변경하려면:
- 오른쪽 상단 모서리에서 관리자를 선택합니다.
- 왼쪽 사이드바에서 설정 > 네트워크를 선택합니다.
- Groups API 속도 제한을 펼칩니다.
- 속도 제한 값을 변경하거나, 비활성화하려면 속도 제한을
0으로 설정합니다. - 변경 사항 저장을 선택합니다.
속도 제한:
- 각 인증된 사용자에게 적용됩니다. 요청이 인증되지 않은 경우, 속도 제한은 IP 주소에 적용됩니다.
- 속도 제한을 비활성화하려면 0으로 설정할 수 있습니다.
속도 제한을 초과하는 요청은 auth.log 파일에 기록됩니다.
예를 들어, GET /groups/:id에 400 제한을 설정하면, 분당 400을 초과하는 API 엔드포인트에 대한 요청이 차단됩니다. 엔드포인트에 대한 액세스는 1분 후에 복원됩니다.
그룹 멤버 목록 조회 속도 제한#
히스토리
- GitLab 18.6에서 도입됨.
모든 그룹 멤버 목록 API 엔드포인트에 속도 제한이 설정됩니다.
GET /projects/:id/members/all 및 GET /groups/:id/members/all API 엔드포인트는
동일한 속도 제한 구성을 공유합니다. 프로젝트 엔드포인트에 속도 제한을 설정하면,
속도 제한은 그룹 엔드포인트에도 적용됩니다.
필수 요건:
- 관리자 액세스.
두 엔드포인트의 속도 제한을 수정하려면:
- 오른쪽 상단 모서리에서 관리자를 선택합니다.
- 왼쪽 사이드바에서 설정 > 네트워크를 선택합니다.
- Projects API 속도 제한을 펼칩니다.
- 사용자 또는 IP 주소당 분당
GET /projects/:id/members/allAPI에 대한 최대 요청 수 텍스트 상자에 값을 입력합니다. - 변경 사항 저장을 선택합니다.
속도 제한:
- 기본값은 분당 200 요청입니다.
- 각 그룹 및 사용자에 적용됩니다.
- Projects API 속도 제한 설정을 통해 구성됩니다. 자세한 내용은 프로젝트 멤버 목록 조회 속도 제한 구성을 참조하세요.
- 두 엔드포인트의 속도 제한을 비활성화하려면
0으로 설정할 수 있습니다.
속도 제한을 초과하는 요청은 auth.log 파일에 기록됩니다.
예를 들어, 분당 200 요청을 초과하는 API 엔드포인트에 대한 요청이 차단됩니다. 엔드포인트에 대한 액세스는 1분 후에 재개됩니다.
그룹 보관 및 보관 해제 속도 제한 구성#
히스토리
- GitLab 18.0에서
archive_group이라는 플래그와 함께 도입됨. 기본적으로 비활성화됨. - GitLab 18.9에서 일반적으로 사용 가능해짐. 기능 플래그
archive_group이 제거됨.
다음 그룹 보관 엔드포인트에 대한 요청에 속도 제한을 구성합니다:
POST /groups/:id/archive
POST /groups/:id/unarchive
필수 요건:
- 관리자 액세스.
속도 제한을 변경하려면:
- 오른쪽 상단 모서리에서 관리자를 선택합니다.
- 왼쪽 사이드바에서 설정 > 네트워크를 선택합니다.
- Groups API 속도 제한을 펼칩니다.
- 사용자 또는 IP 주소당 분당
POST /groups/:id/archive및POST /groups/:id/unarchiveAPI에 대한 최대 요청 수 텍스트 상자에 값을 입력합니다. - 변경 사항 저장을 선택합니다.
속도 제한:
- 기본값은 분당 60 요청입니다.
- 각 인증된 사용자에게 적용됩니다. 요청이 인증되지 않은 경우, 속도 제한은 IP 주소에 적용됩니다.
- 두 엔드포인트의 속도 제한을 비활성화하려면
0으로 설정할 수 있습니다.
속도 제한을 초과하는 요청은 auth.log 파일에 기록됩니다.
예를 들어, 제한을 60으로 설정하면, 분당 60 요청을 초과하는 API 엔드포인트에 대한 요청이 차단됩니다. 엔드포인트에 대한 액세스는 1분 후에 재개됩니다.
그룹 보관 엔드포인트에 대한 자세한 내용은 그룹 보관을 참조하세요.
그룹 멤버 삭제 속도 제한 구성#
히스토리
- GitLab 16.9에서 도입됨.
멤버 삭제 엔드포인트에 대한 요청의 각 그룹 및 사용자별 속도 제한을 구성합니다.
필수 요건:
- 관리자 액세스.
속도 제한을 변경하려면:
- 오른쪽 상단 모서리에서 관리자를 선택합니다.
- 왼쪽 사이드바에서 설정 > 네트워크를 선택합니다.
- Members API 속도 제한을 펼칩니다.
- 그룹/프로젝트당 분당 최대 요청 수 텍스트 상자에 값을 입력합니다.
- 변경 사항 저장을 선택합니다.
속도 제한:
- 기본값은 분당 60 요청입니다.
- 각 그룹 및 사용자에 적용됩니다.
- 속도 제한을 비활성화하려면
0으로 설정할 수 있습니다.
속도 제한을 초과하는 요청은 auth.log 파일에 기록됩니다.
예를 들어, 제한을 60으로 설정하면, 분당 60 요청을 초과하는 API 엔드포인트에 대한 요청이 차단됩니다. 엔드포인트에 대한 액세스는 1분 후에 복원됩니다.
