플랜 제한 API
Tier: Free, Premium, Ultimate
Offering: GitLab Self-Managed, GitLab Dedicated
Offering: GitLab Self-Managed, GitLab Dedicated
요약
이 API를 사용하여 기존 구독 플랜의 애플리케이션 제한과 상호 작용합니다. 기존 플랜은 GitLab 에디션에 따라 다릅니다. GitLab 인스턴스의 플랜 현재 제한을 조회합니다. GitLab 인스턴스의 플랜 제한을 업데이트합니다.
이 API를 사용하여 기존 구독 플랜의 애플리케이션 제한과 상호 작용합니다.
기존 플랜은 GitLab 에디션에 따라 다릅니다. Community Edition에서는 default 플랜만 사용할 수 있습니다. Enterprise Edition에서는 추가 플랜도 사용할 수 있습니다.
사전 요구 사항:
- 인스턴스에 대한 관리자 접근 권한이 있어야 합니다.
현재 플랜 제한 조회#
GitLab 인스턴스의 플랜 현재 제한을 조회합니다.
GET /application/plan_limits
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
plan_name |
string | 아니요 | 제한을 가져올 플랜의 이름. 기본값: default. |
curl --request GET \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/application/plan_limits"
예시 응답:
{
"ci_instance_level_variables": 25,
"ci_pipeline_size": 0,
"ci_active_jobs": 0,
"ci_project_subscriptions": 2,
"ci_pipeline_schedules": 10,
"ci_needs_size_limit": 50,
"ci_registered_group_runners": 1000,
"ci_registered_project_runners": 1000,
"dotenv_size": 5120,
"dotenv_variables": 20,
"conan_max_file_size": 3221225472,
"enforcement_limit": 10000,
"generic_packages_max_file_size": 5368709120,
"helm_max_file_size": 5242880,
"notification_limit": 10000,
"maven_max_file_size": 3221225472,
"npm_max_file_size": 524288000,
"nuget_max_file_size": 524288000,
"max_pipelines_per_merge_train": 20,
"pipeline_hierarchy_size": 1000,
"pypi_max_file_size": 3221225472,
"terraform_module_max_file_size": 1073741824,
"storage_size_limit": 15000
}
플랜 제한 업데이트#
GitLab 인스턴스의 플랜 제한을 업데이트합니다.
PUT /application/plan_limits
| 속성 | 타입 | 필수 | 설명 |
|---|---|---|---|
plan_name |
string | 예 | 업데이트할 플랜의 이름. |
ci_instance_level_variables |
integer | 아니요 | 정의할 수 있는 인스턴스 수준 CI/CD 변수의 최대 수. |
ci_pipeline_size |
integer | 아니요 | 단일 파이프라인의 최대 잡 수. GitLab 15.0에서 도입됨. |
ci_active_jobs |
integer | 아니요 | 현재 활성 파이프라인에서의 총 잡 수. GitLab 15.0에서 도입됨. |
ci_project_subscriptions |
integer | 아니요 | 프로젝트와의 파이프라인 구독 최대 수. GitLab 15.0에서 도입됨. |
ci_pipeline_schedules |
integer | 아니요 | 파이프라인 스케줄의 최대 수. GitLab 15.0에서 도입됨. |
ci_needs_size_limit |
integer | 아니요 | 잡이 가질 수 있는 needs 의존성의 최대 수. GitLab 15.0에서 도입됨. |
ci_registered_group_runners |
integer | 아니요 | 지난 7일 동안 그룹에서 생성되거나 활성화된 러너의 최대 수. GitLab 15.0에서 도입됨. |
ci_registered_project_runners |
integer | 아니요 | 지난 7일 동안 프로젝트에서 생성되거나 활성화된 러너의 최대 수. GitLab 15.0에서 도입됨. |
dotenv_size |
integer | 아니요 | dotenv 아티팩트의 최대 크기(바이트). GitLab 17.1에서 도입됨. |
dotenv_variables |
integer | 아니요 | dotenv 아티팩트의 최대 변수 수. GitLab 17.1에서 도입됨. |
conan_max_file_size |
integer | 아니요 | Conan 패키지 파일의 최대 크기(바이트). |
enforcement_limit |
integer | 아니요 | 루트 네임스페이스 제한 적용을 위한 최대 스토리지 크기(MiB). |
generic_packages_max_file_size |
integer | 아니요 | 일반 패키지 파일의 최대 크기(바이트). |
helm_max_file_size |
integer | 아니요 | Helm 차트 파일의 최대 크기(바이트). |
maven_max_file_size |
integer | 아니요 | Maven 패키지 파일의 최대 크기(바이트). |
notification_limit |
integer | 아니요 | 루트 네임스페이스 제한 알림을 위한 최대 스토리지 크기(MiB). |
npm_max_file_size |
integer | 아니요 | NPM 패키지 파일의 최대 크기(바이트). |
nuget_max_file_size |
integer | 아니요 | NuGet 패키지 파일의 최대 크기(바이트). |
max_pipelines_per_merge_train |
integer | 아니요 | merge train당 최대 병렬 파이프라인 수. 기본값: 20. 최솟값: 1. GitLab 19.0에서 도입됨. |
pipeline_hierarchy_size |
integer | 아니요 | 파이프라인 계층 트리에서 다운스트림 파이프라인의 최대 수. 기본값: 1000. 1000보다 큰 값은 권장되지 않음. |
pypi_max_file_size |
integer | 아니요 | PyPI 패키지 파일의 최대 크기(바이트). |
terraform_module_max_file_size |
integer | 아니요 | Terraform 모듈 패키지 파일의 최대 크기(바이트). |
storage_size_limit |
integer | 아니요 | 루트 네임스페이스의 최대 스토리지 크기(MiB). |
web_hook_calls |
integer | 아니요 | 최상위 네임스페이스당 분당 웹훅 호출 최대 횟수. GitLab 18.5에서 도입됨. |
curl --request PUT \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/application/plan_limits?plan_name=default&conan_max_file_size=3221225472"
예시 응답:
{
"ci_instance_level_variables": 25,
"ci_pipeline_size": 0,
"ci_active_jobs": 0,
"ci_project_subscriptions": 2,
"ci_pipeline_schedules": 10,
"ci_needs_size_limit": 50,
"ci_registered_group_runners": 1000,
"ci_registered_project_runners": 1000,
"conan_max_file_size": 3221225472,
"dotenv_variables": 20,
"dotenv_size": 5120,
"generic_packages_max_file_size": 5368709120,
"helm_max_file_size": 5242880,
"maven_max_file_size": 3221225472,
"npm_max_file_size": 524288000,
"nuget_max_file_size": 524288000,
"max_pipelines_per_merge_train": 20,
"pipeline_hierarchy_size": 1000,
"pypi_max_file_size": 3221225472,
"terraform_module_max_file_size": 1073741824
}
