正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

プラン制限API

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab Self-Managed

このAPIを使用して、既存のサブスクリプションプランのアプリケーション制限を操作します。

既存のプランはGitLabエディションによって異なります。Community Editionでは、defaultプランのみが利用可能です。Enterprise Editionでは、追加のプランも利用可能です。

前提要件:

  • インスタンスへの管理者アクセス権が必要です。

現在のプラン制限を取得

GitLabインスタンス上のプランの現在の制限を一覧表示します。

GET /application/plan_limits
属性型必須説明
plan_name文字列いいえ制限を取得するプランの名前。デフォルトはdefaultです。
curl --header "PRIVATE-TOKEN: <your_access_token>" "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,
  "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文字列はい更新するプランの名前。
ci_instance_level_variables整数いいえ定義できるインスタンスレベルのCI/CD変数の最大数。
ci_pipeline_size整数いいえ1つのパイプラインにおけるジョブの最大数。GitLab 15.0で導入されました。
ci_active_jobs整数いいえ現在アクティブなパイプライン内のジョブの合計数。GitLab 15.0で導入されました。
ci_project_subscriptions整数いいえプロジェクトとの間のパイプラインサブスクリプションの最大数。GitLab 15.0で導入されました。
ci_pipeline_schedules整数いいえパイプラインスケジュールの最大数。GitLab 15.0で導入されました。
ci_needs_size_limit整数いいえジョブが持つことのできるneedsの依存関係の最大数。GitLab 15.0で導入されました。
ci_registered_group_runners整数いいえ過去7日間にグループ内で作成またはアクティブにできるRunnerの最大数。GitLab 15.0で導入されました。
ci_registered_project_runners整数いいえ過去7日間にプロジェクト内で作成またはアクティブにできるRunnerの最大数。GitLab 15.0で導入されました。
dotenv_size整数いいえdotenvアーティファクトの最大サイズ（バイト）。GitLab 17.1で導入されました。
dotenv_variables整数いいえdotenvアーティファクト内の変数の最大数。GitLab 17.1で導入されました。
conan_max_file_size整数いいえConanパッケージファイルの最大サイズ（バイト単位）。
enforcement_limit整数いいえルートネームスペース制限の適用に対する最大ストレージサイズ（MiB単位）。
generic_packages_max_file_size整数いいえ汎用パッケージファイルの最大サイズ（バイト単位）。
helm_max_file_size整数いいえ最大Helmチャートファイルサイズ（バイト単位）。
maven_max_file_size整数いいえMavenパッケージファイルの最大サイズ（バイト単位）。
notification_limit整数いいえルートネームスペース制限通知に対する最大ストレージサイズ（MiB単位）。
npm_max_file_size整数いいえ最大NPMパッケージファイルサイズ（バイト単位）。
nuget_max_file_size整数いいえ最大NuGetパッケージファイルサイズ（バイト単位）。
pipeline_hierarchy_size整数いいえパイプラインの階層ツリー内のダウンストリームパイプラインの最大数。デフォルト値: 1000。1000を超える値は推奨されません。
pypi_max_file_size整数いいえ最大PyPiパッケージファイルサイズ（バイト単位）。
terraform_module_max_file_size整数いいえ最大Terraformモジュールパッケージファイルサイズ（バイト単位）。
storage_size_limit整数いいえMiB単位のルートネームスペースの最大ストレージサイズ。
web_hook_calls整数いいえトップレベルのネームスペースごとに、Webhookを1分間に呼び出すことができる最大回数。GitLab 18.5で導入。
curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" "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,
  "pipeline_hierarchy_size": 1000,
  "pypi_max_file_size": 3221225472,
  "terraform_module_max_file_size": 1073741824
}