리포지터리 파일 API 속도 제한
GitLab v19.6Offering: GitLab Self-Managed, GitLab Dedicated
요약
리포지터리 파일 API를 사용하면 리포지터리의 파일을 가져오고, 생성하고, 업데이트하고, 삭제할 수 있습니다. Files API의 속도 제한은 기본적으로 비활성화되어 있습니다. 리포지터리 파일 API에 대한 요청에서 일반 사용자 및 IP 속도 제한을 재정의하려면 다음을 수행합니다.
리포지터리 파일 API를 사용하면 리포지터리의 파일을 가져오고, 생성하고, 업데이트하고, 삭제할 수 있습니다. 웹 애플리케이션의 보안과 내구성을 높이기 위해 이 API에 속도 제한을 적용할 수 있습니다. Files API에 대해 생성한 속도 제한은 일반 사용자 및 IP 속도 제한을 재정의합니다.
Files API 속도 제한 정의#
Files API의 속도 제한은 기본적으로 비활성화되어 있습니다. 활성화하면 이 제한은 리포지터리 파일 API에 대한 요청에서 일반 사용자 및 IP 속도 제한보다 우선합니다. 이미 적용된 일반 사용자 및 IP 속도 제한을 그대로 유지하면서 Files API의 속도 제한을 높이거나 낮출 수 있습니다. 이 재정의는 그 밖의 새로운 기능을 제공하지 않습니다.
사전 요구 사항:
- 인스턴스에 대한 관리자 액세스 권한이 있어야 합니다.
리포지터리 파일 API에 대한 요청에서 일반 사용자 및 IP 속도 제한을 재정의하려면 다음을 수행합니다.
- 오른쪽 위 모서리에서 Admin을 선택합니다.
- 왼쪽 사이드바에서 Settings > Network를 선택합니다.
- Files API Rate Limits를 확장합니다.
- 활성화하려는 속도 제한 유형의 확인란을 선택합니다.
- Unauthenticated API request rate limit
- Authenticated API request rate limit
- unauthenticated를 선택한 경우:
- Max unauthenticated API requests per period per IP를 선택합니다.
- Unauthenticated API rate limit period in seconds를 선택합니다.
- authenticated를 선택한 경우:
- Max authenticated API requests per period per user를 선택합니다.
- Authenticated API rate limit period in seconds를 선택합니다.
파일 blame 속도 제한 구성#
히스토리
- GitLab 19.6에서 도입되었습니다.
파일 blame 엔드포인트와
RepositoryBlob의 GraphQL blame 필드는 이 속도 제한을 공유합니다. GraphQL에서는 쿼리의 각 blob이 요청 한 건으로 계산됩니다.
이 제한은 Files API 속도 제한에 추가로 적용되며 기본적으로 활성화되어 있습니다.
| 요청 유형 | 기본 제한 | 적용 대상 | 애플리케이션 설정 |
|---|---|---|---|
| 인증됨 | 1분당 요청 400건 | 사용자와 프로젝트별 | project_repositories_blame_limit |
| 인증되지 않음 | 1분당 요청 400건 | IP 주소별 | project_repositories_blame_unauthenticated_limit |
제한을 변경하려면 애플리케이션 설정 API를 사용합니다.
제한을 비활성화하려면 값을 0으로 설정합니다.