InfoGrab Docs

플랜 제한 API

요약

이 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
}

플랜 제한 API

Tier: Free, Premium, Ultimate
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
}