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

CI/CDジョブトークンのきめ細やかな権限

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

きめ細やかな権限を使用して、限られたREST APIエンドポイントへのアクセスを明示的に許可できます。これらの権限は、指定されたプロジェクトのCI/CDジョブトークンに適用されます。

イシュー519575でフィードバックを共有してください。

ジョブトークン許可リストにきめ細やかな権限を追加

前提条件:

  • プロジェクトのメンテナーまたはオーナーロールが必要です。
  • プロジェクトできめ細やかな権限の使用を有効にする必要があります。

ジョブトークン許可リストに、グループおよびプロジェクトのきめ細やかな権限を追加できます。これにより、ジョブトークンを使用して特定のプロジェクトリソースにアクセスし、これらのグループやプロジェクトで利用できるリソースをより正確に制御できます。

ジョブトークン許可リストのグループまたはプロジェクトにきめ細やかな権限を追加するには:

  1. 上部のバーで、検索または移動先を選択して、プロジェクトを見つけます。
  2. 設定 > CI/CDを選択します。
  3. ジョブトークンの権限を展開します。
  4. CI/CDジョブトークン許可リストセクションで、追加を選択します。
  5. ドロップダウンリストから、グループまたはプロジェクトを選択します。
  6. 既存のグループまたはプロジェクトへのパスを入力します。
  7. きめ細やかな権限を持つアクセス許可を選択します。
  8. 利用可能なAPIエンドポイントに権限を付与します。
  9. 追加を選択します。

GitLabは、指定された権限を持つグループまたはプロジェクトをジョブトークン許可リストに追加します。グループまたはプロジェクトは、現在のプロジェクトで許可されているリソースにアクセスできるようになります。

利用可能なAPIエンドポイント

CI/CDジョブトークンは、以下のREST APIエンドポイントにアクセスできます:

バッジエンドポイント

権限APIエンドポイント権限名スコープ
プロジェクトのすべてのバッジを一覧表示GET /projects/:id/badgesREAD_BADGES読み取り
プロジェクトのバッジを取得するGET /projects/:id/badges/:badge_idREAD_BADGES読み取り
プロジェクトのバッジを作成POST /projects/:id/badgesADMIN_BADGES読み取りと書き込み
プロジェクトからバッジを削除DELETE /projects/:id/badges/:badge_idADMIN_BADGES読み取りと書き込み
プロジェクトのバッジプレビューを取得するGET /projects/:id/badges/renderADMIN_BADGES読み取りと書き込み
プロジェクトのバッジを更新PUT /projects/:id/badges/:badge_idADMIN_BADGES読み取りと書き込み

デプロイエンドポイント

権限APIエンドポイント権限名スコープ
デプロイに関連付けられているすべてのマージリクエストを一覧表示GET /projects/:id/deployments/:deployment_id/merge_requestsREAD_DEPLOYMENTS読み取り
すべてのプロジェクトデプロイを一覧表示GET /projects/:id/deploymentsREAD_DEPLOYMENTS読み取り
デプロイを取得するGET /projects/:id/deployments/:deployment_idREAD_DEPLOYMENTS読み取り
デプロイを承認または却下するPOST /projects/:id/deployments/:deployment_id/approvalADMIN_DEPLOYMENTS読み取りと書き込み
デプロイを作成POST /projects/:id/deploymentsADMIN_DEPLOYMENTS、ADMIN_ENVIRONMENTS読み取りと書き込み
デプロイを削除DELETE /projects/:id/deployments/:deployment_idADMIN_DEPLOYMENTS読み取りと書き込み
デプロイを更新PUT /projects/:id/deployments/:deployment_idADMIN_DEPLOYMENTS読み取りと書き込み

環境エンドポイント

権限APIエンドポイント権限名スコープ
すべての環境を一覧表示GET /projects/:id/environmentsREAD_ENVIRONMENTS読み取り
環境を取得するGET /projects/:id/environments/:environment_idREAD_ENVIRONMENTS読み取り
環境を作成POST /projects/:id/environmentsADMIN_ENVIRONMENTS読み取りと書き込み
環境を削除するDELETE /projects/:id/environments/:environment_idADMIN_ENVIRONMENTS読み取りと書き込み
複数の停止したレビューアプリの削除をスケジュールDELETE /projects/:id/environments/review_appsADMIN_ENVIRONMENTS読み取りと書き込み
環境を停止POST /projects/:id/environments/:environment_id/stopADMIN_ENVIRONMENTS読み取りと書き込み
古い環境を停止POST /projects/:id/environments/stop_staleADMIN_ENVIRONMENTS読み取りと書き込み
既存の環境を更新PUT /projects/:id/environments/:environment_idADMIN_ENVIRONMENTS読み取りと書き込み

ジョブエンドポイント

権限APIエンドポイント権限名スコープ
アーティファクトアーカイブから特定のファイルをダウンロードGET /projects/:id/jobs/:job_id/artifacts/*artifact_pathREAD_JOBS読み取り
参照からアーティファクトアーカイブの特定のファイルをダウンロードGET /projects/:id/jobs/artifacts/:ref_name/raw/*artifact_pathREAD_JOBS読み取り
ジョブアーティファクトをダウンロードするGET /jobs/:id/artifactsREAD_JOBS読み取り
ジョブからアーティファクトアーカイブをダウンロードGET /projects/:id/jobs/:job_id/artifactsREAD_JOBS読み取り
アーティファクトアーカイブ内のすべてのファイルを一覧表示GET /projects/:id/jobs/:job_id/artifacts/treeREAD_JOBS読み取り
パイプライン別にすべてのジョブを一覧表示GET /projects/:id/pipelines/:pipeline_id/jobsREAD_JOBS読み取り
プロジェクトのすべてのジョブを一覧表示GET /projects/:id/jobsREAD_JOBS読み取り
ジョブアーティファクトを取得するGET /projects/:id/jobs/artifacts/:ref_name/downloadREAD_JOBS読み取り

マージリクエストエンドポイント

権限APIエンドポイント権限名スコープ
すべてのマージリクエストノートをリストするGET /projects/:id/merge_requests/:noteable_id/notesREAD_MERGE_REQUESTS読み取り
すべてのプロジェクトマージリクエストを一覧表示GET /projects/:id/merge_requestsREAD_MERGE_REQUESTS読み取り
マージリクエストを取得するGET /projects/:id/merge_requests/:merge_request_iidREAD_MERGE_REQUESTS読み取り
マージリクエストノートを取得するGET /projects/:id/merge_requests/:noteable_id/notes/:note_idREAD_MERGE_REQUESTS読み取り

パッケージエンドポイント

権限APIエンドポイント権限名スコープ
パッケージアーカイブをダウンロードするためのComposerパッケージエンドポイントGET /projects/:id/packages/composer/archives/*package_nameREAD_PACKAGES読み取り
パッケージファイルをダウンロードGET /projects/:id/packages/:package_id/package_files/:package_file_id/downloadREAD_PACKAGES読み取り
モジュールファイルをダウンロードGET /projects/:id/packages/go/*module_name/@v/:module_version.modREAD_PACKAGES読み取り
モジュールソースをダウンロードGET /projects/:id/packages/go/*module_name/@v/:module_version.zipREAD_PACKAGES読み取り
パッケージファイルをダウンロードGET /projects/:id/packages/generic/:package_name/*package_version/(*path/):file_nameREAD_PACKAGES読み取り
NPM tarballをダウンロードGET /projects/:id/packages/npm/*package_name/-/*file_nameREAD_PACKAGES読み取り
グループレベルでMavenパッケージファイルをダウンロードGET /groups/:id/-/packages/maven/*path/:file_nameREAD_PACKAGES読み取り
プロジェクトレベルでMavenパッケージファイルをダウンロードGET /projects/:id/packages/maven/*path/:file_nameREAD_PACKAGES読み取り
インスタンスレベルでMavenパッケージファイルをダウンロードGET /packages/maven/*path/:file_nameREAD_PACKAGES読み取り
指定されたNPMパッケージのすべてのタグを取得GET /groups/:id/-/packages/npm/-/package/*package_name/dist-tagsREAD_PACKAGES読み取り
指定されたNPMパッケージのすべてのタグを取得GET /packages/npm/-/package/*package_name/dist-tagsREAD_PACKAGES読み取り
指定されたNPMパッケージのすべてのタグを取得GET /projects/:id/packages/npm/-/package/*package_name/dist-tagsREAD_PACKAGES読み取り
リストGET /projects/:id/packages/go/*module_name/@v/listREAD_PACKAGES読み取り
すべてのパッケージダウンロードURLを一覧表示GET /packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channel/packages/:conan_package_reference/download_urlsREAD_PACKAGES読み取り
すべてのパッケージダウンロードURLを一覧表示GET /projects/:id/packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channel/packages/:conan_package_reference/download_urlsREAD_PACKAGES読み取り
すべてのパッケージファイルを一覧表示GET /projects/:id/packages/:package_id/package_filesREAD_PACKAGES読み取り
すべてのパッケージファイルを一覧表示GET /projects/:id/packages/conan/v2/conans/:package_name/:package_version/:package_username/:package_channel/revisions/:recipe_revision/packages/:conan_package_reference/revisions/:package_revision/filesREAD_PACKAGES読み取り
すべてのパッケージリビジョンを一覧表示GET /projects/:id/packages/conan/v2/conans/:package_name/:package_version/:package_username/:package_channel/revisions/:recipe_revision/packages/:conan_package_reference/revisionsREAD_PACKAGES読み取り
すべてのパッケージアップロードURLを一覧表示POST /packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channel/packages/:conan_package_reference/upload_urlsREAD_PACKAGES読み取り
すべてのパッケージアップロードURLを一覧表示POST /projects/:id/packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channel/packages/:conan_package_reference/upload_urlsREAD_PACKAGES読み取り
プロジェクトのすべてのパッケージを一覧表示GET /projects/:id/packagesREAD_PACKAGES読み取り
プロジェクトのすべてのパッケージを一覧表示GET /projects/:id/packages/pypi/simpleREAD_PACKAGES読み取り
すべてのレシピダウンロードURLを一覧表示GET /packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channel/download_urlsREAD_PACKAGES読み取り
すべてのレシピダウンロードURLを一覧表示GET /projects/:id/packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channel/download_urlsREAD_PACKAGES読み取り
すべてのレシピファイルを一覧表示GET /projects/:id/packages/conan/v2/conans/:package_name/:package_version/:package_username/:package_channel/revisions/:recipe_revision/filesREAD_PACKAGES読み取り
すべてのレシピリビジョンを一覧表示GET /projects/:id/packages/conan/v2/conans/:package_name/:package_version/:package_username/:package_channel/revisionsREAD_PACKAGES読み取り
すべてのレシピアップロードURLを一覧表示POST /packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channel/upload_urlsREAD_PACKAGES読み取り
すべてのレシピアップロードURLを一覧表示POST /projects/:id/packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channel/upload_urlsREAD_PACKAGES読み取り
NPMレジストリ一括アドバイザリエンドポイントPOST /groups/:id/-/packages/npm/-/npm/v1/security/advisories/bulkREAD_PACKAGES読み取り
NPMレジストリ一括アドバイザリエンドポイントPOST /packages/npm/-/npm/v1/security/advisories/bulkREAD_PACKAGES読み取り
NPMレジストリ一括アドバイザリエンドポイントPOST /projects/:id/packages/npm/-/npm/v1/security/advisories/bulkREAD_PACKAGES読み取り
NPMレジストリメタデータエンドポイントGET /projects/:id/packages/npm/*package_nameREAD_PACKAGES読み取り
NPMレジストリクイック監査エンドポイントPOST /groups/:id/-/packages/npm/-/npm/v1/security/audits/quickREAD_PACKAGES読み取り
NPMレジストリクイック監査エンドポイントPOST /packages/npm/-/npm/v1/security/audits/quickREAD_PACKAGES読み取り
NPMレジストリクイック監査エンドポイントPOST /projects/:id/packages/npm/-/npm/v1/security/audits/quickREAD_PACKAGES読み取り
パッケージファイルを取得するGET /packages/conan/v1/files/:package_name/:package_version/:package_username/:package_channel/:recipe_revision/package/:conan_package_reference/:package_revision/:file_nameREAD_PACKAGES読み取り
パッケージファイルを取得するGET /projects/:id/packages/conan/v1/files/:package_name/:package_version/:package_username/:package_channel/:recipe_revision/package/:conan_package_reference/:package_revision/:file_nameREAD_PACKAGES読み取り
パッケージファイルを取得するGET /projects/:id/packages/conan/v2/conans/:package_name/:package_version/:package_username/:package_channel/revisions/:recipe_revision/packages/:conan_package_reference/revisions/:package_revision/files/:file_nameREAD_PACKAGES読み取り
パッケージマニフェストを取得するGET /packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channel/packages/:conan_package_reference/digestREAD_PACKAGES読み取り
パッケージマニフェストを取得するGET /projects/:id/packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channel/packages/:conan_package_reference/digestREAD_PACKAGES読み取り
パッケージスナップショットを取得するGET /packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channel/packages/:conan_package_referenceREAD_PACKAGES読み取り
パッケージスナップショットを取得するGET /projects/:id/packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channel/packages/:conan_package_referenceREAD_PACKAGES読み取り
プロジェクトパッケージを取得するGET /projects/:id/packages/:package_idREAD_PACKAGES読み取り
レシピファイルを取得するGET /packages/conan/v1/files/:package_name/:package_version/:package_username/:package_channel/:recipe_revision/export/:file_nameREAD_PACKAGES読み取り
レシピファイルを取得するGET /projects/:id/packages/conan/v1/files/:package_name/:package_version/:package_username/:package_channel/:recipe_revision/export/:file_nameREAD_PACKAGES読み取り
レシピファイルを取得するGET /projects/:id/packages/conan/v2/conans/:package_name/:package_version/:package_username/:package_channel/revisions/:recipe_revision/files/:file_nameREAD_PACKAGES読み取り
レシピマニフェストを取得するGET /packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channel/digestREAD_PACKAGES読み取り
レシピマニフェストを取得するGET /projects/:id/packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channel/digestREAD_PACKAGES読み取り
レシピスナップショットを取得するGET /packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channelREAD_PACKAGES読み取り
レシピスナップショットを取得するGET /projects/:id/packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channelREAD_PACKAGES読み取り
最新のパッケージリビジョンを取得するGET /projects/:id/packages/conan/v2/conans/:package_name/:package_version/:package_username/:package_channel/revisions/:recipe_revision/packages/:conan_package_reference/latestREAD_PACKAGES読み取り
最新のレシピリビジョンを取得するGET /projects/:id/packages/conan/v2/conans/:package_name/:package_version/:package_username/:package_channel/latestREAD_PACKAGES読み取り
パッケージ参照メタデータを取得するGET /packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channel/searchREAD_PACKAGES読み取り
パッケージ参照メタデータを取得するGET /projects/:id/packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channel/searchREAD_PACKAGES読み取り
パッケージ参照メタデータを取得するGET /projects/:id/packages/conan/v2/conans/:package_name/:package_version/:package_username/:package_channel/searchREAD_PACKAGES読み取り
レシピリビジョン別にパッケージ参照メタデータを取得するGET /projects/:id/packages/conan/v2/conans/:package_name/:package_version/:package_username/:package_channel/revisions/:recipe_revision/searchREAD_PACKAGES読み取り
PyPiシンプルプロジェクトパッケージエンドポイントGET /projects/:id/packages/pypi/simple/*package_nameREAD_PACKAGES読み取り
PyPiパッケージダウンロードエンドポイントGET /projects/:id/packages/pypi/files/:sha256/*file_identifierREAD_PACKAGES読み取り
バージョンメタデータGET /projects/:id/packages/go/*module_name/@v/:module_version.infoREAD_PACKAGES読み取り
NPMパッケージアップロードを承認PUT /projects/:id/packages/npm/:package_name/authorizeADMIN_PACKAGES読み取りと書き込み
WorkhorseからのPyPiパッケージアップロードを承認POST /projects/:id/packages/pypi/authorizeADMIN_PACKAGES読み取りと書き込み
パッケージを作成POST /projects/:id/packages/composerADMIN_PACKAGES読み取りと書き込み
指定されたNPMパッケージおよびバージョンのタグを作成または更新PUT /groups/:id/-/packages/npm/-/package/*package_name/dist-tags/:tagADMIN_PACKAGES読み取りと書き込み
指定されたNPMパッケージおよびバージョンのタグを作成または更新PUT /packages/npm/-/package/*package_name/dist-tags/:tagADMIN_PACKAGES読み取りと書き込み
指定されたNPMパッケージおよびバージョンのタグを作成または更新PUT /projects/:id/packages/npm/-/package/*package_name/dist-tags/:tagADMIN_PACKAGES読み取りと書き込み
NPMパッケージを作成または非推奨化PUT /projects/:id/packages/npm/:package_nameADMIN_PACKAGES読み取りと書き込み
パッケージファイルを削除するDELETE /projects/:id/packages/:package_id/package_files/:package_file_idADMIN_PACKAGES読み取りと書き込み
パッケージリビジョンを削除DELETE /projects/:id/packages/conan/v2/conans/:package_name/:package_version/:package_username/:package_channel/revisions/:recipe_revision/packages/:conan_package_reference/revisions/:package_revisionADMIN_PACKAGES読み取りと書き込み
プロジェクトパッケージを削除するDELETE /projects/:id/packages/:package_idADMIN_PACKAGES読み取りと書き込み
レシピとパッケージを削除DELETE /packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channelADMIN_PACKAGES読み取りと書き込み
レシピとパッケージを削除DELETE /projects/:id/packages/conan/v1/conans/:package_name/:package_version/:package_username/:package_channelADMIN_PACKAGES読み取りと書き込み
レシピリビジョンを削除DELETE /projects/:id/packages/conan/v2/conans/:package_name/:package_version/:package_username/:package_channel/revisions/:recipe_revisionADMIN_PACKAGES読み取りと書き込み
指定されたタグを削除DELETE /groups/:id/-/packages/npm/-/package/*package_name/dist-tags/:tagADMIN_PACKAGES読み取りと書き込み
指定されたタグを削除DELETE /packages/npm/-/package/*package_name/dist-tags/:tagADMIN_PACKAGES読み取りと書き込み
指定されたタグを削除DELETE /projects/:id/packages/npm/-/package/*package_name/dist-tags/:tagADMIN_PACKAGES読み取りと書き込み
パッケージをアップロードPOST /projects/:id/packages/pypiADMIN_PACKAGES読み取りと書き込み
パッケージファイルをアップロードPUT /packages/conan/v1/files/:package_name/:package_version/:package_username/:package_channel/:recipe_revision/package/:conan_package_reference/:package_revision/:file_nameADMIN_PACKAGES読み取りと書き込み
パッケージファイルをアップロードPUT /projects/:id/packages/conan/v1/files/:package_name/:package_version/:package_username/:package_channel/:recipe_revision/package/:conan_package_reference/:package_revision/:file_nameADMIN_PACKAGES読み取りと書き込み
パッケージファイルをアップロードPUT /projects/:id/packages/conan/v2/conans/:package_name/:package_version/:package_username/:package_channel/revisions/:recipe_revision/packages/:conan_package_reference/revisions/:package_revision/files/:file_nameADMIN_PACKAGES読み取りと書き込み
レシピファイルをアップロードPUT /packages/conan/v1/files/:package_name/:package_version/:package_username/:package_channel/:recipe_revision/export/:file_nameADMIN_PACKAGES読み取りと書き込み
レシピファイルをアップロードPUT /projects/:id/packages/conan/v1/files/:package_name/:package_version/:package_username/:package_channel/:recipe_revision/export/:file_nameADMIN_PACKAGES読み取りと書き込み
レシピファイルをアップロードPUT /projects/:id/packages/conan/v2/conans/:package_name/:package_version/:package_username/:package_channel/revisions/:recipe_revision/files/:file_nameADMIN_PACKAGES読み取りと書き込み
パッケージファイルをアップロードPUT /projects/:id/packages/generic/:package_name/*package_version/(*path/):file_nameADMIN_PACKAGES読み取りと書き込み
MavenパッケージファイルをアップロードPUT /projects/:id/packages/maven/*path/:file_nameADMIN_PACKAGES読み取りと書き込み
Workhorseが汎用パッケージファイルを承認PUT /projects/:id/packages/generic/:package_name/*package_version/(*path/):file_name/authorizeADMIN_PACKAGES読み取りと書き込み
WorkhorseがConanパッケージファイルを承認PUT /packages/conan/v1/files/:package_name/:package_version/:package_username/:package_channel/:recipe_revision/package/:conan_package_reference/:package_revision/:file_name/authorizeADMIN_PACKAGES読み取りと書き込み
WorkhorseがConanパッケージファイルを承認PUT /projects/:id/packages/conan/v1/files/:package_name/:package_version/:package_username/:package_channel/:recipe_revision/package/:conan_package_reference/:package_revision/:file_name/authorizeADMIN_PACKAGES読み取りと書き込み
WorkhorseがConanパッケージファイルを承認PUT /projects/:id/packages/conan/v2/conans/:package_name/:package_version/:package_username/:package_channel/revisions/:recipe_revision/packages/:conan_package_reference/revisions/:package_revision/files/:file_name/authorizeADMIN_PACKAGES読み取りと書き込み
WorkhorseがConanレシピファイルを承認PUT /packages/conan/v1/files/:package_name/:package_version/:package_username/:package_channel/:recipe_revision/export/:file_name/authorizeADMIN_PACKAGES読み取りと書き込み
WorkhorseがConanレシピファイルを承認PUT /projects/:id/packages/conan/v1/files/:package_name/:package_version/:package_username/:package_channel/:recipe_revision/export/:file_name/authorizeADMIN_PACKAGES読み取りと書き込み
WorkhorseがConanレシピファイルを承認PUT /projects/:id/packages/conan/v2/conans/:package_name/:package_version/:package_username/:package_channel/revisions/:recipe_revision/files/:file_name/authorizeADMIN_PACKAGES読み取りと書き込み
WorkhorseがMavenパッケージファイルのアップロードを承認PUT /projects/:id/packages/maven/*path/:file_name/authorizeADMIN_PACKAGES読み取りと書き込み

パイプラインエンドポイント

権限APIエンドポイント権限名スコープ
パイプライン別にすべてのブリッジジョブを一覧表示GET /projects/:id/pipelines/:pipeline_id/bridgesREAD_PIPELINES読み取り
すべてのパッケージパイプラインを一覧表示GET /projects/:id/packages/:package_id/pipelinesREAD_PIPELINES読み取り
すべてのプロジェクトパイプラインを一覧表示GET /projects/:id/pipelinesREAD_PIPELINES読み取り
パイプライン別にすべてのトリガージョブを一覧表示GET /projects/:id/pipelines/:pipeline_id/trigger_jobsREAD_PIPELINES読み取り
パイプラインを取得するGET /projects/:id/pipelines/:pipeline_idREAD_PIPELINES読み取り
パイプラインメタデータを更新するPUT /projects/:id/pipelines/:pipeline_id/metadataADMIN_PIPELINES読み取りと書き込み

リリースエンドポイント

権限APIエンドポイント権限名スコープ
プロジェクトのリリースアセットファイルをダウンロードGET /projects/:id/releases/:tag_name/downloads/*direct_asset_pathREAD_RELEASES読み取り
変更履歴データを生成するGET /projects/:id/repository/changelogREAD_RELEASES読み取り
最新のプロジェクトリリースを取得GET /projects/:id/releases/permalink/latest(/)(*suffix_path)READ_RELEASES読み取り
すべてのリリースリンクを一覧表示GET /projects/:id/releases/:tag_name/assets/linksREAD_RELEASES読み取り
プロジェクト内のすべてのリリースを一覧表示GET /projects/:id/releasesREAD_RELEASES読み取り
タグ名でリリースを取得するGET /projects/:id/releases/:tag_nameREAD_RELEASES読み取り
リリースリンクを取得するGET /projects/:id/releases/:tag_name/assets/links/:link_idREAD_RELEASES読み取り
リリースを作成するPOST /projects/:id/releasesADMIN_RELEASES読み取りと書き込み
リリースリンクを作成POST /projects/:id/releases/:tag_name/assets/linksADMIN_RELEASES読み取りと書き込み
リリースを削除するDELETE /projects/:id/releases/:tag_nameADMIN_RELEASES読み取りと書き込み
リリースリンクを削除DELETE /projects/:id/releases/:tag_name/assets/links/:link_idADMIN_RELEASES読み取りと書き込み
リリースエビデンスを生成POST /projects/:id/releases/:tag_name/evidenceADMIN_RELEASES読み取りと書き込み
新しいコンポーネントプロジェクトリリースをバージョンとしてCI/CDカタログに公開POST /projects/:id/catalog/publishADMIN_RELEASES読み取りと書き込み
リリースを更新するPUT /projects/:id/releases/:tag_nameADMIN_RELEASES読み取りと書き込み
リリースリンクを更新PUT /projects/:id/releases/:tag_name/assets/links/:link_idADMIN_RELEASES読み取りと書き込み

リポジトリエンドポイント

権限APIエンドポイント権限名スコープ
コミットに関連付けられているすべてのマージリクエストを一覧表示GET /projects/:id/repository/commits/:sha/merge_requestsREAD_REPOSITORIES読み取り
すべてのプロジェクトリポジトリタグを一覧表示GET /projects/:id/repository/tagsREAD_REPOSITORIES読み取り
すべてのリポジトリブランチを一覧表示GET /projects/:id/repository/branchesREAD_REPOSITORIES読み取り
コミットを取得するGET /projects/:id/repository/commits/:shaREAD_REPOSITORIES読み取り
リポジトリからrawファイルを取得するGET /projects/:id/repository/files/:file_path/rawREAD_REPOSITORIES読み取り
単一のリポジトリタグを取得するGET /projects/:id/repository/tags/:tag_nameREAD_REPOSITORIES読み取り

セキュアファイルエンドポイント

権限APIエンドポイント権限名スコープ
セキュアファイルをダウンロードGET /projects/:id/secure_files/:secure_file_id/downloadREAD_SECURE_FILES読み取り
プロジェクトのすべてのセキュアファイルを一覧表示GET /projects/:id/secure_filesREAD_SECURE_FILES読み取り
セキュアファイルの詳細を取得するGET /projects/:id/secure_files/:secure_file_idREAD_SECURE_FILES読み取り
セキュアファイルを作成POST /projects/:id/secure_filesADMIN_SECURE_FILES読み取りと書き込み
セキュアファイルを削除DELETE /projects/:id/secure_files/:secure_file_idADMIN_SECURE_FILES読み取りと書き込み

Terraformステートエンドポイント

権限APIエンドポイント権限名スコープ
Terraformステートを取得するGET /projects/:id/terraform/state/:nameREAD_TERRAFORM_STATE読み取り
Terraformステートバージョンを取得するGET /projects/:id/terraform/state/:name/versions/:serialREAD_TERRAFORM_STATE読み取り
Terraformステートを作成または更新POST /projects/:id/terraform/state/:nameADMIN_TERRAFORM_STATE読み取りと書き込み
Terraformステートを削除DELETE /projects/:id/terraform/state/:nameADMIN_TERRAFORM_STATE読み取りと書き込み
Terraformステートバージョンを削除DELETE /projects/:id/terraform/state/:name/versions/:serialADMIN_TERRAFORM_STATE読み取りと書き込み
TerraformステートをロックPOST /projects/:id/terraform/state/:name/lockADMIN_TERRAFORM_STATE読み取りと書き込み
Terraformステートのロックを解除DELETE /projects/:id/terraform/state/:name/lockADMIN_TERRAFORM_STATE読み取りと書き込み

作業アイテムエンドポイント

権限APIエンドポイント権限名スコープ
すべてのプロジェクトイシューを一覧表示GET /projects/:id/issuesREAD_WORK_ITEMS読み取り
プロジェクトイシューを取得するGET /projects/:id/issues/:issue_iidREAD_WORK_ITEMS読み取り

利用できないAPIエンドポイント

CI/CDジョブトークンは、以下のエンドポイントにアクセスできません:

権限APIエンドポイント
レジストリリポジトリを削除するDELETE /projects/:id/registry/repositories/:repository_id
複数のレジストリリポジトリタグを削除DELETE /projects/:id/registry/repositories/:repository_id/tags
レジストリリポジトリのタグを削除するDELETE /projects/:id/registry/repositories/:repository_id/tags/:tag_name
パッケージバージョンメタデータのためのグループレベルのComposerパッケージエンドポイントGET /group/:id/-/packages/composer/*package_name
グループのすべてのパッケージを一覧表示GET /group/:id/-/packages/composer/p/:sha
パッケージバージョンメタデータのためのグループレベルのComposer v2パッケージp2エンドポイントGET /group/:id/-/packages/composer/p2/*package_name
リポジトリURLテンプレートを取得するGET /group/:id/-/packages/composer/packages
NPMレジストリメタデータエンドポイントGET /groups/:id/-/packages/npm/*package_name
グループからパッケージファイルをダウンロードGET /groups/:id/-/packages/pypi/files/:sha256/*file_identifier
グループのすべてのパッケージを一覧表示GET /groups/:id/-/packages/pypi/simple
PyPiシンプルグループパッケージエンドポイントGET /groups/:id/-/packages/pypi/simple/*package_name
ジョブトークンでジョブを取得するGET /job
ジョブトークンでGitLabのすべてのKubernetes向けGitLabエージェントを一覧表示GET /job/allowed_agents
Conanパッケージを検索GET /packages/conan/v1/conans/search
Conanリポジトリの可用性を検証GET /packages/conan/v1/ping
認証トークンを取得するGET /packages/conan/v1/users/authenticate
認証認証情報を検証GET /packages/conan/v1/users/check_credentials
NPMレジストリメタデータエンドポイントGET /packages/npm/*package_name
Conanパッケージを検索GET /projects/:id/packages/conan/v1/conans/search
Conanリポジトリの可用性を検証GET /projects/:id/packages/conan/v1/ping
認証トークンを取得するGET /projects/:id/packages/conan/v1/users/authenticate
認証認証情報を検証GET /projects/:id/packages/conan/v1/users/check_credentials
Conanパッケージを検索GET /projects/:id/packages/conan/v2/conans/search
認証トークンを取得するGET /projects/:id/packages/conan/v2/users/authenticate
認証認証情報を検証GET /projects/:id/packages/conan/v2/users/check_credentials
プロジェクトのすべてのレジストリリポジトリを一覧表示GET /projects/:id/registry/repositories
プロジェクトのすべてのレジストリリポジトリタグを一覧表示GET /projects/:id/registry/repositories/:repository_id/tags
レジストリリポジトリタグの詳細を取得するGET /projects/:id/registry/repositories/:repository_id/tags/:tag_name
DASTサイト検証を新しい状態に遷移させます。POST /internal/dast/site_validations/:id/transition
単一のモジュラーサービスオーディエンスのために短命のJWTを発行POST /token_exchange