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

プロジェクトインテグレーションAPI

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

このAPIを使用して、プロジェクトのインテグレーションを管理します。

前提条件:

  • プロジェクトのメンテナーまたはオーナーロールが必要です。

すべてのアクティブなインテグレーションをリスト表示

すべてのアクティブなプロジェクトインテグレーションのリストを取得します。vulnerability_eventsフィールドはGitLab Enterprise Editionでのみ利用可能です。

GET /projects/:id/integrations

レスポンス例:

[
  {
    "id": 75,
    "title": "Jenkins CI",
    "slug": "jenkins",
    "created_at": "2019-11-20T11:20:25.297Z",
    "updated_at": "2019-11-20T12:24:37.498Z",
    "active": true,
    "commit_events": true,
    "push_events": true,
    "issues_events": true,
    "alert_events": true,
    "confidential_issues_events": true,
    "merge_requests_events": true,
    "tag_push_events": false,
    "deployment_events": false,
    "note_events": true,
    "confidential_note_events": true,
    "pipeline_events": true,
    "wiki_page_events": true,
    "job_events": true,
    "comment_on_event_enabled": true,
    "inherited": false,
    "vulnerability_events": true
  },
  {
    "id": 76,
    "title": "Alerts endpoint",
    "slug": "alerts",
    "created_at": "2019-11-20T11:20:25.297Z",
    "updated_at": "2019-11-20T12:24:37.498Z",
    "active": true,
    "commit_events": true,
    "push_events": true,
    "issues_events": true,
    "alert_events": true,
    "confidential_issues_events": true,
    "merge_requests_events": true,
    "tag_push_events": true,
    "deployment_events": false,
    "note_events": true,
    "confidential_note_events": true,
    "pipeline_events": true,
    "wiki_page_events": true,
    "job_events": true,
    "comment_on_event_enabled": true,
    "inherited": false,
    "vulnerability_events": true
  }
]

Apple App Store Connect

Apple App Store Connectをセットアップ

プロジェクトのApple App Store Connectインテグレーションをセットアップします。

PUT /projects/:id/integrations/apple_app_store

パラメータは以下のとおりです:

パラメータ必須説明
app_store_issuer_id文字列はいApple App Store Connect発行者ID。
app_store_key_id文字列はいApple App Store ConnectキーID。
app_store_private_key_file_name文字列はいApple App Store Connectプライベートキーのファイル名。
app_store_private_key文字列はいApple App Store Connectプライベートキー。
app_store_protected_refsブール値いいえ保護されたブランチとタグのみで変数を設定します。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Apple App Store Connectを無効化

プロジェクトのApple App Store Connectインテグレーションを無効化します。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/apple_app_store

Apple App Store Connectの設定を取得

プロジェクトのApple App Store Connectインテグレーションの設定を取得します。

GET /projects/:id/integrations/apple_app_store

Asana

Asanaをセットアップ

プロジェクトのAsanaインテグレーションをセットアップします。

PUT /projects/:id/integrations/asana

パラメータは以下のとおりです:

パラメータ必須説明
api_key文字列はいユーザーAPIトークン。ユーザーはタスクにアクセスできる必要があります。すべてのコメントはこのユーザーに帰属します。
restrict_to_branch文字列いいえ自動的に検査されるブランチのコンマ区切りリスト。すべてのブランチを含める場合は空のままにします。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Asanaを無効化

プロジェクトのAsanaインテグレーションを無効化します。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/asana

Asanaの設定を取得

プロジェクトのAsanaインテグレーションの設定を取得します。

GET /projects/:id/integrations/asana

Assembla

Assemblaをセットアップ

プロジェクトのAssemblaインテグレーションをセットアップします。

PUT /projects/:id/integrations/assembla

パラメータは以下のとおりです:

パラメータ必須説明
token文字列はい認証トークン。
subdomain文字列いいえサブドメインの設定。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Assemblaを無効化

プロジェクトのAssemblaインテグレーションを無効化します。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/assembla

Assemblaの設定を取得

プロジェクトのAssemblaインテグレーションの設定を取得します。

GET /projects/:id/integrations/assembla

AtlassianBamboo

AtlassianBambooをセットアップ

プロジェクトのAtlassianBambooインテグレーションをセットアップします。

Bambooで自動リビジョンラベリングとリポジトリトリガーを設定する必要があります。

PUT /projects/:id/integrations/bamboo

パラメータは以下のとおりです:

パラメータ必須説明
bamboo_url文字列はいBambooルートURL(例: https://bamboo.example.com)。
enable_ssl_verificationブール値いいえSSL検証を有効にします。デフォルトはtrue(有効)です。
build_key文字列はいBambooビルドプランキー(例: KEY)。
username文字列はいBambooサーバーへのAPIアクセス権を持つユーザー。
password文字列はいユーザーのパスワード。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

AtlassianBambooを無効化

プロジェクトのAtlassianBambooインテグレーションを無効化します。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/bamboo

AtlassianBambooの設定を取得

プロジェクトのAtlassianBambooインテグレーションの設定を取得します。

GET /projects/:id/integrations/bamboo

Bugzilla

Bugzillaをセットアップ

プロジェクトのBugzillaインテグレーションをセットアップします。

PUT /projects/:id/integrations/bugzilla

パラメータは以下のとおりです:

パラメータ必須説明
new_issue_url文字列はい新規イシューのURL。
issues_url文字列はいイシューのURL。
project_url文字列はいプロジェクトのURL。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Bugzillaを無効化

プロジェクトのBugzillaインテグレーションを無効化します。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/bugzilla

Bugzillaの設定を取得

プロジェクトのBugzillaインテグレーションの設定を取得します。

GET /projects/:id/integrations/bugzilla

Buildkite

Buildkiteをセットアップ

プロジェクトのBuildkiteインテグレーションをセットアップします。

PUT /projects/:id/integrations/buildkite

パラメータは以下のとおりです:

パラメータ必須説明
token文字列はいGitLabリポジトリを含むBuildkiteパイプラインを作成した後に取得するトークン。
project_url文字列はいパイプラインURL(例: https://buildkite.com/example/pipeline)。
enable_ssl_verificationブール値いいえ非推奨: SSL検証は常に有効なため、このパラメータは効果がありません。
push_eventsブール値いいえプッシュイベントの通知を有効にします。
merge_requests_eventsブール値いいえマージリクエストイベントの通知を有効にします。
tag_push_eventsブール値いいえタグプッシュイベントの通知を有効にします。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Buildkiteを無効化

プロジェクトのBuildkiteインテグレーションを無効化します。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/buildkite

Buildkiteの設定を取得

プロジェクトのBuildkiteインテグレーションの設定を取得します。

GET /projects/:id/integrations/buildkite

Campfire Classic

Campfire Classicと統合できます。ただし、Campfire ClassicはBasecampによって販売終了された古い製品です。

Campfire Classicをセットアップ

プロジェクトのCampfire Classicインテグレーションをセットアップします。

PUT /projects/:id/integrations/campfire

パラメータは以下のとおりです:

パラメータ必須説明
token文字列はいCampfire ClassicからのAPI認証トークン。トークンを取得するには、Campfire ClassicにサインインしてMy infoを選択します。
subdomain文字列いいえサインインしているときの.campfirenow.comサブドメイン。
room文字列いいえCampfire ClassicルームURLのID部分。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Campfire Classicを無効化

プロジェクトのCampfire Classicインテグレーションを無効化します。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/campfire

Campfire Classicの設定を取得

プロジェクトのCampfire Classicインテグレーションの設定を取得します。

GET /projects/:id/integrations/campfire

ClickUp

ClickUpをセットアップ

プロジェクトのClickUpインテグレーションをセットアップします。

PUT /projects/:id/integrations/clickup

パラメータは以下のとおりです:

パラメータ必須説明
issues_url文字列はいイシューのURL。
project_url文字列はいプロジェクトのURL。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

ClickUpを無効化

プロジェクトのClickUpインテグレーションを無効化します。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/clickup

ClickUpの設定を取得

プロジェクトのClickUpインテグレーションの設定を取得します。

GET /projects/:id/integrations/clickup

Confluenceワークスペース

プロジェクトのWikiとしてConfluence Cloudワークスペースを使用します。

Confluenceワークスペースをセットアップ

プロジェクトのConfluenceワークスペースインテグレーションをセットアップします。

PUT /projects/:id/integrations/confluence

パラメータは以下のとおりです:

パラメータ必須説明
confluence_url文字列はいatlassian.netでホストされているConfluenceワークスペースのURL。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Confluenceワークスペースを無効化

プロジェクトのConfluenceワークスペースインテグレーションを無効化します。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/confluence

Confluenceワークスペースの設定を取得

プロジェクトのConfluenceワークスペースインテグレーションの設定を取得します。

GET /projects/:id/integrations/confluence

カスタムイシュートラッカー

カスタムイシュートラッカーをセットアップ

プロジェクトのカスタムイシュートラッカーをセットアップします。

PUT /projects/:id/integrations/custom-issue-tracker

パラメータは以下のとおりです:

パラメータ必須説明
new_issue_url文字列はい新規イシューのURL。
issues_url文字列はいイシューのURL。
project_url文字列はいプロジェクトのURL。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

カスタムイシュートラッカーを無効化

プロジェクトのカスタムイシュートラッカーを無効化します。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/custom-issue-tracker

カスタムイシュートラッカーの設定を取得

プロジェクトのカスタムイシュートラッカーの設定を取得します。

GET /projects/:id/integrations/custom-issue-tracker

Datadog

Datadogをセットアップ

プロジェクトのDatadogインテグレーションをセットアップします。

PUT /projects/:id/integrations/datadog

パラメータは以下のとおりです:

パラメータ必須説明
api_key文字列はいDatadogでの認証に使用されるAPIキー
datadog_ci_visibilityブール値はいDatadogでパイプラインおよびジョブイベントの収集を有効にし、パイプライン実行トレースを表示します。
api_url文字列いいえDatadogサイトの完全なURL。
datadog_env文字列いいえ自己管理型デプロイの場合、Datadogに送信されるすべてのデータ用のenv%タグ。
datadog_service文字列いいえDatadogでそこからのすべてのデータにタグ付けするGitLabインスタンス。複数の自己管理型デプロイを管理する場合に使用できます。
datadog_site文字列いいえデータを送信するDatadogサイト。EUサイトにデータを送信するには、datadoghq.euを使用します。
datadog_tags文字列いいえDatadogでのカスタムタグ。key:value\nkey2:value2の形式で1行につき1つのタグを指定します。
archive_trace_eventsブール値いいえ有効にすると、ジョブログがDatadogによって収集され、パイプライン実行トレースとともに表示されます(GitLab 15.3で導入)。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Datadogを無効化

プロジェクトのDatadogインテグレーションを無効化します。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/datadog

Datadogの設定を取得

プロジェクトのDatadogインテグレーションの設定を取得します。

GET /projects/:id/integrations/datadog

Diffblue Cover

Diffblue Coverをセットアップ

プロジェクトのDiffblue Coverインテグレーションをセットアップします。

PUT /projects/:id/integrations/diffblue-cover

パラメータは以下のとおりです:

パラメータ必須説明
diffblue_license_key文字列はいDiffblue Coverライセンスキー。
diffblue_access_token_name文字列はいDiffblue Coverがパイプラインで使用するアクセストークン名。
diffblue_access_token_secret文字列はいDiffblue Coverがパイプラインで使用するアクセストークンシークレット。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Diffblue Coverを無効化

プロジェクトのDiffblue Coverインテグレーションを無効化します。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/diffblue-cover

Diffblue Coverの設定を取得

プロジェクトのDiffblue Coverインテグレーションの設定を取得します。

GET /projects/:id/integrations/diffblue-cover

Discord通知

Discord通知をセットアップ

プロジェクトのDiscord通知をセットアップします。

PUT /projects/:id/integrations/discord

パラメータは以下のとおりです:

パラメータ必須説明
webhook文字列はいDiscord Webhook(例: https://discord.com/api/webhooks/...)。
branches_to_be_notified文字列いいえ通知を送信するブランチ。有効なオプションはalldefaultprotected、およびdefault_and_protectedです。デフォルト値はdefaultです。
confidential_issues_eventsブール値いいえ機密イシューイベントの通知を有効にします。
confidential_issue_channel文字列いいえ機密イシューイベントの通知を受信するWebhookオーバーライド。
confidential_note_eventsブール値いいえ機密ノートイベントの通知を有効にします。
confidential_note_channel文字列いいえ機密ノートイベントの通知を受信するWebhookオーバーライド。
deployment_eventsブール値いいえデプロイイベントの通知を有効にします。
deployment_channel文字列いいえデプロイイベントの通知を受信するWebhookオーバーライド。
group_confidential_mentions_eventsブール値いいえグループの機密メンションイベントの通知を有効にします。
group_confidential_mentions_channel文字列いいえグループの機密メンションイベントの通知を受信するWebhookオーバーライド。
group_mentions_eventsブール値いいえグループメンションイベントの通知を有効にします。
group_mentions_channel文字列いいえグループメンションイベントの通知を受信するWebhookオーバーライド。
issues_eventsブール値いいえイシューイベントの通知を有効にします。
issue_channel文字列いいえイシューイベントの通知を受信するWebhookオーバーライド。
merge_requests_eventsブール値いいえマージリクエストイベントの通知を有効にします。
merge_request_channel文字列いいえマージリクエストイベントの通知を受信するWebhookオーバーライド。
note_eventsブール値いいえノートイベントの通知を有効にします。
note_channel文字列いいえノートイベントの通知を受信するWebhookオーバーライド。
notify_only_broken_pipelinesブール値いいえ破損したパイプラインの通知を送信します。
notify_only_when_pipeline_status_changesブール値いいえリファレンスのパイプラインステータスが変更された場合にのみ通知を送信します。
pipeline_eventsブール値いいえパイプラインイベントの通知を有効にします。
pipeline_channel文字列いいえパイプラインイベントの通知を受信するWebhookオーバーライド。
push_eventsブール値いいえプッシュイベントの通知を有効にします。
push_channel文字列いいえプッシュイベントの通知を受信するWebhookオーバーライド。
tag_push_eventsブール値いいえタグプッシュイベントの通知を有効にします。
tag_push_channel文字列いいえタグプッシュイベントの通知を受信するWebhookオーバーライド。
wiki_page_eventsブール値いいえWikiページイベントの通知を有効にします。
wiki_page_channel文字列いいえWikiページイベントの通知を受信するWebhookオーバーライド。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Discord通知を無効化

プロジェクトのDiscord通知を無効化します。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/discord

Discord通知の設定を取得

プロジェクトのDiscord通知の設定を取得します。

GET /projects/:id/integrations/discord

Drone

Droneをセットアップ

プロジェクトのDroneインテグレーションをセットアップします。

PUT /projects/:id/integrations/drone-ci

パラメータは以下のとおりです:

パラメータ必須説明
token文字列はいDrone CIトークン。
drone_url文字列はいDrone CI URL(例: http://drone.example.com)。
enable_ssl_verificationブール値いいえSSL検証を有効にします。デフォルトはtrue(有効)です。
push_eventsブール値いいえプッシュイベントの通知を有効にします。
merge_requests_eventsブール値いいえマージリクエストイベントの通知を有効にします。
tag_push_eventsブール値いいえタグプッシュイベントの通知を有効にします。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Droneを無効化

プロジェクトのDroneインテグレーションを無効化します。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/drone-ci

Droneの設定を取得

プロジェクトのDroneインテグレーションの設定を取得します。

GET /projects/:id/integrations/drone-ci

プッシュ時にメールを送信

プッシュ時にメールを送信をセットアップ

プロジェクトのプッシュ時にメールを送信インテグレーションをセットアップします。

PUT /projects/:id/integrations/emails-on-push

パラメータは以下のとおりです:

パラメータ必須説明
recipients文字列はい空白で区切られたメールアドレス。
disable_diffsブール値いいえコード差分を無効にします。
send_from_committer_emailブール値いいえコミッターから送信します。
push_eventsブール値いいえプッシュイベントの通知を有効にします。
tag_push_eventsブール値いいえタグプッシュイベントの通知を有効にします。
branches_to_be_notified文字列いいえ通知を送信するブランチ。有効なオプションはalldefaultprotected、およびdefault_and_protectedです。通知はタグプッシュに対して常に起動されます。デフォルト値はallです。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

プッシュ時にメールを送信を無効化

プロジェクトのプッシュ時にメールを送信インテグレーションを無効化します。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/emails-on-push

プッシュ時にメールを送信の設定を取得

プロジェクトのプッシュ時にメールを送信インテグレーションの設定を取得します。

GET /projects/:id/integrations/emails-on-push

EngineeringワークフローManagement (EWM)

EWMをセットアップ

プロジェクトのEWMインテグレーションをセットアップします。

PUT /projects/:id/integrations/ewm

パラメータは以下のとおりです:

パラメータ必須説明
new_issue_url文字列はい新規イシューのURL。
project_url文字列はいプロジェクトのURL。
issues_url文字列はいイシューのURL。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

EWMを無効化

プロジェクトのEWMインテグレーションを無効化します。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/ewm

EWMの設定を取得

プロジェクトのEWMインテグレーションの設定を取得します。

GET /projects/:id/integrations/ewm

外部Wiki

外部Wikiをセットアップ

プロジェクトの外部Wikiをセットアップします。

PUT /projects/:id/integrations/external-wiki

パラメータは以下のとおりです:

パラメータ必須説明
external_wiki_url文字列はい外部WikiのURL。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

外部Wikiを無効化

プロジェクトの外部Wikiを無効化します。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/external-wiki

外部Wikiの設定を取得

プロジェクトの外部Wikiの設定を取得します。

GET /projects/:id/integrations/external-wiki

GitGuardian

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

GitGuardianは、ソースコードリポジトリ内のAPIキーやパスワードなどの機密データを検出するサイバーセキュリティサービスです。これはGitリポジトリをスキャンし、ポリシー違反についてアラートを出し、ハッカーが悪用する前にセキュリティイシューを修正するのに組織を支援します。

GitLabがGitGuardianポリシーに基づいてコミットを拒否するように設定できます。

既知のイシューとトラブルシューティングの手順については、GitGuardianトラブルシューティングを参照してください。

GitGuardianをセットアップ

プロジェクトのGitGuardianインテグレーションをセットアップします。

PUT /projects/:id/integrations/git-guardian

パラメータは以下のとおりです:

パラメータ必須説明
token文字列はいscanスコープを持つGitGuardian APIトークン。
api_url文字列いいえGitGuardian APIベースURL。https://api.gitguardian.comがデフォルトです。EUリージョンにはhttps://api.eu1.gitguardian.comを使用するか、自己ホスト型GitGuardianインスタンスのURLを使用します。HTTPSを使用する必要があります。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

GitGuardianを無効化

プロジェクトのGitGuardianインテグレーションを無効化します。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/git-guardian

GitGuardianの設定を取得

プロジェクトのGitGuardianインテグレーションの設定を取得します。

GET /projects/:id/integrations/git-guardian

GitHub

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

GitHubをセットアップ

プロジェクトのGitHubインテグレーションをセットアップします。

PUT /projects/:id/integrations/github

パラメータは以下のとおりです:

パラメータ必須説明
token文字列はいrepo:status OAuthスコープを持つGitHub APIトークン。
repository_url文字列はいGitHubリポジトリURL。
static_contextブール値いいえGitLabインスタンスのホスト名をステータスチェック名に追加します。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

GitHubを無効化

プロジェクトのGitHubインテグレーションを無効化します。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/github

GitHubの設定を取得

プロジェクトのGitHubインテグレーションの設定を取得します。

GET /projects/:id/integrations/github

GitLab for Jira Cloudアプリ

GitLab for Jira Cloudアプリのインテグレーションは、Jiraでのグループリンクおよびリンク解除を通じて自動的に有効または無効になります。GitLabインテグレーションフォームまたはAPIを使用して、インテグレーションを有効または無効にすることはできません。

プロジェクトのインテグレーションを更新

このAPIエンドポイントを使用して、Jiraでグループリンクによって作成したインテグレーションを更新します。

PUT /projects/:id/integrations/jira-cloud-app

パラメータは以下のとおりです:

パラメータ必須説明
jira_cloud_app_service_ids文字列いいえJira Service ManagementサービスID。複数のIDを区切るにはカンマ(,)を使用します。
jira_cloud_app_enable_deployment_gatingブール値いいえJira Service ManagementからのブロックされたGitLabデプロイに対してデプロイゲートを有効にします。
jira_cloud_app_deployment_gating_environments文字列いいえデプロイゲートを有効にする環境(本番環境、ステージング、テスト、または開発)。デプロイゲートが有効になっている場合に必要です。複数の環境を区切るにはカンマ(,)を使用します。

GitLab for Jira Cloudアプリの設定を取得

プロジェクトのGitLab for Jira Cloudアプリインテグレーションの設定を取得します。

GET /projects/:id/integrations/jira-cloud-app

GitLab for Slackアプリ

GitLab for Slackアプリをセットアップ

プロジェクトのGitLab for Slackアプリインテグレーションを更新します。

インテグレーションにはGitLab API単独では取得できないOAuth 2.0トークンが必要なため、APIを介してGitLab for Slackアプリを作成することはできません。代わりに、GitLab UIからアプリをインストールする必要があります。その後、このAPIエンドポイントを使用してインテグレーションを更新できます。

PUT /projects/:id/integrations/gitlab-slack-application

パラメータは以下のとおりです:

パラメータ必須説明
channel文字列いいえ他のチャンネルが設定されていない場合に使用するデフォルトのチャンネル。
notify_only_broken_pipelinesブール値いいえ破損したパイプラインの通知を送信します。
notify_only_when_pipeline_status_changesブール値いいえリファレンスのパイプラインステータスが変更された場合にのみ通知を送信します。
notify_only_default_branchブール値いいえ非推奨: このパラメータはbranches_to_be_notifiedに置き換えられました。
branches_to_be_notified文字列いいえ通知を送信するブランチ。有効なオプションはalldefaultprotected、およびdefault_and_protectedです。デフォルト値はdefaultです。
alert_eventsブール値いいえアラートイベントの通知を有効にします。
issues_eventsブール値いいえイシューイベントの通知を有効にします。
confidential_issues_eventsブール値いいえ機密イシューイベントの通知を有効にします。
merge_requests_eventsブール値いいえマージリクエストイベントの通知を有効にします。
note_eventsブール値いいえノートイベントの通知を有効にします。
confidential_note_eventsブール値いいえ機密ノートイベントの通知を有効にします。
deployment_eventsブール値いいえデプロイイベントの通知を有効にします。
incidents_eventsブール値いいえインシデントイベントの通知を有効にします。
pipeline_eventsブール値いいえパイプラインイベントの通知を有効にします。
push_eventsブール値いいえプッシュイベントの通知を有効にします。
tag_push_eventsブール値いいえタグプッシュイベントの通知を有効にします。
vulnerability_eventsブール値いいえ脆弱性イベントの通知を有効にします。
wiki_page_eventsブール値いいえWikiページイベントの通知を有効にします。
labels_to_be_notified文字列いいえラベルの通知を送信します。設定されていない場合、すべてのイベントの通知を受け取ります。
labels_to_be_notified_behavior文字列いいえラベルの通知対象。有効なオプションはmatch_anymatch_allです。match_anyがデフォルトです。
push_channel文字列いいえプッシュイベントの通知を受け取るチャンネルの名前。
issue_channel文字列いいえイシューイベントの通知を受け取るチャンネルの名前。
confidential_issue_channel文字列いいえ機密イシューイベントの通知を受け取るチャンネルの名前。
merge_request_channel文字列いいえマージリクエストイベントの通知を受け取るチャンネルの名前。
note_channel文字列いいえノートイベントの通知を受け取るチャンネルの名前。
confidential_note_channel文字列いいえ機密ノートイベントの通知を受け取るチャンネルの名前。
tag_push_channel文字列いいえタグプッシュイベントの通知を受け取るチャンネルの名前。
pipeline_channel文字列いいえパイプラインイベントの通知を受け取るチャンネルの名前。
wiki_page_channel文字列いいえWikiページイベントの通知を受け取るチャンネルの名前。
deployment_channel文字列いいえデプロイイベントの通知を受け取るチャンネルの名前。
incident_channel文字列いいえインシデントイベントの通知を受け取るチャンネルの名前。
vulnerability_channel文字列いいえ脆弱性イベントの通知を受け取るチャンネルの名前。
alert_channel文字列いいえアラートイベントの通知を受け取るチャンネルの名前。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

GitLab for Slackアプリを無効にする

プロジェクトのGitLab for Slackアプリインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/gitlab-slack-application

GitLab for Slackアプリの設定を取得

プロジェクトのGitLab for Slackアプリインテグレーション設定を取得します。

GET /projects/:id/integrations/gitlab-slack-application

Google Chat

Google Chatをセットアップする

プロジェクトのGoogle Chatインテグレーションをセットアップします。

PUT /projects/:id/integrations/hangouts-chat

パラメータは以下のとおりです:

パラメータ必須説明
webhook文字列はいHangouts Chat Webhook(例: https://chat.googleapis.com/v1/spaces...)。
notify_only_broken_pipelinesブール値いいえ破損したパイプラインの通知を送信します。
notify_only_when_pipeline_status_changesブール値いいえリファレンスのパイプラインステータスが変更された場合にのみ通知を送信します。
notify_only_default_branchブール値いいえ非推奨: このパラメータはbranches_to_be_notifiedに置き換えられました。
branches_to_be_notified文字列いいえ通知を送信するブランチ。有効なオプションはalldefaultprotected、およびdefault_and_protectedです。デフォルト値はdefaultです。
push_eventsブール値いいえプッシュイベントの通知を有効にします。
issues_eventsブール値いいえイシューイベントの通知を有効にします。
confidential_issues_eventsブール値いいえ機密イシューイベントの通知を有効にします。
merge_requests_eventsブール値いいえマージリクエストイベントの通知を有効にします。
tag_push_eventsブール値いいえタグプッシュイベントの通知を有効にします。
note_eventsブール値いいえノートイベントの通知を有効にします。
confidential_note_eventsブール値いいえ機密ノートイベントの通知を有効にします。
pipeline_eventsブール値いいえパイプラインイベントの通知を有効にします。
wiki_page_eventsブール値いいえWikiページイベントの通知を有効にします。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Google Chatを無効にする

プロジェクトのGoogle Chatインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/hangouts-chat

Google Chatの設定を取得

プロジェクトのGoogle Chatインテグレーション設定を取得します。

GET /projects/:id/integrations/hangouts-chat

Google Artifact Management

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com
  • ステータス: ベータ版

この機能はベータ版です。

Google Artifact Managementをセットアップする

プロジェクトのGoogle Artifact Managementインテグレーションをセットアップします。

PUT /projects/:id/integrations/google-cloud-platform-artifact-registry

パラメータは以下のとおりです:

パラメータ必須説明
artifact_registry_project_id文字列はいGoogle CloudプロジェクトのID。
artifact_registry_location文字列はいArtifact Registryリポジトリの場所。
artifact_registry_repositories文字列はいArtifactレジストリのリポジトリ。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Google Artifact Managementを無効にする

プロジェクトのGoogle Artifact Managementインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/google-cloud-platform-artifact-registry

Google Artifact Managementの設定を取得

プロジェクトのGoogle Artifact Managementインテグレーション設定を取得します。

GET /projects/:id/integrations/google-cloud-platform-artifact-registry

Google Cloud Identity and Access Management(IAM)

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com
  • ステータス: ベータ版

この機能はベータ版です。

Google Cloud Identity and Access Managementをセットアップする

プロジェクトのGoogle Cloud Identity and Access Managementインテグレーションをセットアップします。

PUT /projects/:id/integrations/google-cloud-platform-workload-identity-federation

パラメータは以下のとおりです:

パラメータ必須説明
workload_identity_federation_project_id文字列はいWorkload Identity Federation(ワークロードアイデンティティフェデレーション)のGoogle CloudプロジェクトID。
workload_identity_federation_project_number整数はいWorkload Identity Federation(ワークロードアイデンティティフェデレーション)のGoogle Cloudプロジェクト番号。
workload_identity_pool_id文字列はいワークロードIDプールのID。
workload_identity_pool_provider_id文字列はいWorkload Identityプールプロバイダ(Workload Identityプールプロバイダ)のID。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Google Cloud Identity and Access Managementを無効にする

プロジェクトのGoogle Cloud Identity and Access Managementインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/google-cloud-platform-workload-identity-federation

Google Cloud Identity and Access Managementを取得

プロジェクトのGoogle Cloud Identity and Access Managementの設定を取得します。

GET /projects/:id/integration/google-cloud-platform-workload-identity-federation

Google Play

Google Playをセットアップする

プロジェクトのGoogle Playインテグレーションをセットアップします。

PUT /projects/:id/integrations/google-play

パラメータは以下のとおりです:

パラメータ必須説明
package_name文字列はいGoogle Playのアプリのパッケージ名。
service_account_key文字列はいGoogle Playサービスアカウントキー。
service_account_key_file_name文字列はいGoogle Playサービスアカウントキーのファイル名。
google_play_protected_refsブール値いいえ保護されたブランチとタグのみで変数を設定します。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Google Playを無効にする

プロジェクトのGoogle Playインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/google-play

Google Playの設定を取得

プロジェクトのGoogle Playインテグレーション設定を取得します。

GET /projects/:id/integrations/google-play

Harbor

Harborをセットアップする

プロジェクトのHarborインテグレーションをセットアップします。

PUT /projects/:id/integrations/harbor

パラメータは以下のとおりです:

パラメータ必須説明
url文字列はいGitLabプロジェクトにリンクされたHarborインスタンスへのベースURL。例: https://demo.goharbor.io
project_name文字列はいHarborインスタンス内のプロジェクト名。例: testproject
username文字列はいHarborインターフェースで作成されたユーザー名。
password文字列はいユーザーのパスワード。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Harborを無効にする

プロジェクトのHarborインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/harbor

Harborの設定を取得

プロジェクトのHarborインテグレーション設定を取得します。

GET /projects/:id/integrations/harbor

irker (IRCゲートウェイ)

irkerをセットアップする

プロジェクトのirkerインテグレーションをセットアップします。

PUT /projects/:id/integrations/irker

パラメータは以下のとおりです:

パラメータ必須説明
recipients文字列はいチャンネルまたはメールアドレスのカンマ区切りリスト。
default_irc_uri文字列いいえ各受信者の前に付加するURI。デフォルト値はirc://irc.network.net:6697/です。
server_host文字列いいえirkerデーモンのホスト名。デフォルト値はlocalhostです。
server_port整数いいえirkerデーモンのポート。デフォルト値は6659です。
colorize_messagesブール値いいえメッセージを色分けします。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

irkerを無効にする

プロジェクトのirkerインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/irker

irkerの設定を取得

プロジェクトのirkerインテグレーション設定を取得します。

GET /projects/:id/integrations/irker

Jenkins

Jenkinsをセットアップする

プロジェクト用のJenkinsインテグレーションをセットアップします。

PUT /projects/:id/integrations/jenkins

パラメータは以下のとおりです:

パラメータ必須説明
jenkins_url文字列はいJenkinsサーバーのURL。
enable_ssl_verificationブール値いいえSSL検証を有効にします。デフォルトはtrue(有効)です。
project_name文字列はいJenkinsプロジェクト名。
username文字列いいえJenkinsサーバーのユーザー名。
password文字列いいえJenkinsサーバーのパスワード。
push_eventsブール値いいえプッシュイベントの通知を有効にします。
merge_requests_eventsブール値いいえマージリクエストイベントの通知を有効にします。
tag_push_eventsブール値いいえタグプッシュイベントの通知を有効にします。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Jenkinsを無効にする

プロジェクトのJenkinsインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/jenkins

Jenkins設定を取得する

プロジェクトのJenkinsインテグレーション設定を取得します。

GET /projects/:id/integrations/jenkins

JetBrains TeamCity

JetBrains TeamCityをセットアップする

プロジェクト用のJetBrains TeamCityインテグレーションをセットアップします。

TeamCityのビルド設定では、%build.vcs.number%のビルド番号形式を使用する必要があります。VCSルートの詳細設定で、すべてのブランチのモニタリングを設定し、マージリクエストをビルドできるようにします。

PUT /projects/:id/integrations/teamcity

パラメータは以下のとおりです:

パラメータ必須説明
teamcity_url文字列はいTeamCityルートURL (例: https://teamcity.example.com)。
enable_ssl_verificationブール値いいえSSL検証を有効にします。デフォルトはtrue(有効)です。
build_type文字列はいTeamCityプロジェクトのビルド設定ID。
username文字列はい手動ビルドをトリガーする権限を持つユーザー。
password文字列はいユーザーのパスワード。
push_eventsブール値いいえプッシュイベントの通知を有効にします。
merge_requests_eventsブール値いいえマージリクエストイベントの通知を有効にします。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

JetBrains TeamCityを無効にする

プロジェクトのJetBrains TeamCityインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/teamcity

JetBrains TeamCity設定を取得する

プロジェクトのJetBrains TeamCityインテグレーション設定を取得します。

GET /projects/:id/integrations/teamcity

Jiraイシュー

Jiraイシューをセットアップする

プロジェクトのJiraイシューインテグレーションをセットアップします。

PUT /projects/:id/integrations/jira

パラメータは以下のとおりです:

パラメータ必須説明
url文字列はいこのGitLabプロジェクトにリンクされているJiraプロジェクトのURL (例: https://jira.example.com)。
api_url文字列いいえJiraインスタンスAPIへのベースURL。設定されていない場合、Web URL値が使用されます (例: https://jira-api.example.com)。
username文字列いいえJiraで使用するメールまたはユーザー名。Jira Cloudにはメールを、Jira Data CenterおよびJira Serverにはユーザー名を使用します。Basic認証 (jira_auth_type0) を使用する場合に必須です。
password文字列はいJiraで使用するJira APIトークン、パスワード、またはパーソナルアクセストークン。基本認証 (jira_auth_type0) の場合、Jira CloudにはAPIトークンを、Jira Data CenterまたはJira Serverにはパスワードを使用します。Jiraパーソナルアクセストークン認証 (jira_auth_type1) の場合、パーソナルアクセストークンを使用します。Jira Cloudサービスアカウント認証の場合、APIトークンを使用します。
jira_auth_type整数いいえJiraで使用する認証方法。Basic認証には0、Jiraパーソナルアクセストークンには1、Jira Cloudサービスアカウントには2を使用します。0がデフォルトです。
jira_issue_prefix文字列いいえJiraイシューキーに一致するプレフィックス。
jira_issue_regex文字列いいえJiraイシューキーに一致する正規表現。
jira_issue_transition_automaticブール値いいえ自動イシュー移行を有効にする。有効な場合、jira_issue_transition_idより優先されます。falseがデフォルトです。
jira_issue_transition_id文字列いいえカスタムイシュー移行の1つまたは複数の移行ID。jira_issue_transition_automaticが有効な場合は無視されます。デフォルトは空の文字列で、カスタム移行を無効にします。
commit_eventsブール値いいえコミットイベントの通知を有効にします。
merge_requests_eventsブール値いいえマージリクエストイベントの通知を有効にします。
comment_on_event_enabledブール値いいえ各GitLabイベント (コミットまたはマージリクエスト) でJiraイシューにコメントを有効にします。
issues_enabledブール値いいえGitLabでJiraイシューの表示を有効にする。GitLab 17.0で導入されました。
project_keys文字列の配列いいえJiraプロジェクトのキー。issues_enabledtrueの場合、この設定は、GitLabでイシューを表示するJiraプロジェクトを指定します。GitLab 17.0で導入されました。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。
vulnerabilities_enabledブール値いいえGitLab EEでのみ利用可能です。trueに設定すると、GitLabの脆弱性に対してJiraイシューが作成されます。
vulnerabilities_issuetype数値いいえGitLab EEでのみ利用可能です。脆弱性からイシューを作成する際に使用するJiraイシュータイプのID。
project_key文字列いいえGitLab EEでのみ利用可能です。脆弱性からイシューを作成する際に使用するプロジェクトのキー。脆弱性からイシューを作成するためにインテグレーションを使用する場合、このパラメータは必須です。
customize_jira_issue_enabledブール値いいえGitLab EEでのみ利用可能です。trueに設定すると、脆弱性からJiraイシューを作成する際に、Jiraインスタンスで事前入力されたフォームが開きます。

Jiraを無効にする

プロジェクトのJiraイシューインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/jira

Jira設定を取得する

プロジェクトのJiraイシューインテグレーション設定を取得します。

GET /projects/:id/integrations/jira

Linear

Linearをセットアップする

グループ用のLinearインテグレーションをセットアップします。

PUT /projects/:id/integrations/linear

パラメータは以下のとおりです:

パラメータ必須説明
workspace_url文字列はいイシューのURL。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Linearを無効にする

グループ用のLinearインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/linear

Linear設定を取得する

グループのLinearインテグレーション設定を取得します。

GET /projects/:id/integrations/linear

Matrix通知

Matrix通知をセットアップする

プロジェクト用のMatrix通知をセットアップします。

PUT /projects/:id/integrations/matrix

パラメータは以下のとおりです:

パラメータ必須説明
hostname文字列いいえMatrixサーバーのカスタムホスト名。デフォルト値はhttps://matrix.orgです。
token文字列はいMatrixアクセストークン (例: syt-zyx57W2v1u123ew11)。
room文字列はいターゲットルームの固有識別子 (形式: !qPKKM111FFKKsfoCVy:matrix.org)。
notify_only_broken_pipelinesブール値いいえ破損したパイプラインの通知を送信します。
notify_only_when_pipeline_status_changesブール値いいえリファレンスのパイプラインステータスが変更された場合にのみ通知を送信します。
branches_to_be_notified文字列いいえ通知を送信するブランチ。有効なオプションはalldefaultprotected、およびdefault_and_protectedです。デフォルト値はdefaultです。
push_eventsブール値いいえプッシュイベントの通知を有効にします。
issues_eventsブール値いいえイシューイベントの通知を有効にします。
confidential_issues_eventsブール値いいえ機密イシューイベントの通知を有効にします。
merge_requests_eventsブール値いいえマージリクエストイベントの通知を有効にします。
tag_push_eventsブール値いいえタグプッシュイベントの通知を有効にします。
note_eventsブール値いいえノートイベントの通知を有効にします。
confidential_note_eventsブール値いいえ機密ノートイベントの通知を有効にします。
pipeline_eventsブール値いいえパイプラインイベントの通知を有効にします。
wiki_page_eventsブール値いいえWikiページイベントの通知を有効にします。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Matrix通知を無効にする

プロジェクトのMatrix通知を無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/matrix

Matrix通知設定を取得する

プロジェクトのMatrix通知設定を取得します。

GET /projects/:id/integrations/matrix

Mattermost通知

Mattermost通知をセットアップする

プロジェクト用のMattermost通知をセットアップします。

PUT /projects/:id/integrations/mattermost

パラメータは以下のとおりです:

パラメータ必須説明
webhook文字列はいMattermost通知Webhook (例: http://mattermost.example.com/hooks/...)。
username文字列いいえMattermost通知ユーザー名。
channel文字列いいえ他のチャンネルが設定されていない場合に使用するデフォルトのチャンネル。
notify_only_broken_pipelinesブール値いいえ破損したパイプラインの通知を送信します。
notify_only_when_pipeline_status_changesブール値いいえリファレンスのパイプラインステータスが変更された場合にのみ通知を送信します。
notify_only_default_branchブール値いいえ非推奨: このパラメータはbranches_to_be_notifiedに置き換えられました。
branches_to_be_notified文字列いいえ通知を送信するブランチ。有効なオプションはalldefaultprotected、およびdefault_and_protectedです。デフォルト値はdefaultです。
labels_to_be_notified文字列いいえラベルの通知を送信します。すべてのイベントの通知を受信するには、空白のままにします。
labels_to_be_notified_behavior文字列いいえラベルの通知対象。有効なオプションはmatch_anymatch_allです。デフォルト値はmatch_anyです。
push_eventsブール値いいえプッシュイベントの通知を有効にします。
issues_eventsブール値いいえイシューイベントの通知を有効にします。
confidential_issues_eventsブール値いいえ機密イシューイベントの通知を有効にします。
merge_requests_eventsブール値いいえマージリクエストイベントの通知を有効にします。
tag_push_eventsブール値いいえタグプッシュイベントの通知を有効にします。
note_eventsブール値いいえノートイベントの通知を有効にします。
confidential_note_eventsブール値いいえ機密ノートイベントの通知を有効にします。
pipeline_eventsブール値いいえパイプラインイベントの通知を有効にします。
wiki_page_eventsブール値いいえWikiページイベントの通知を有効にします。
push_channel文字列いいえプッシュイベントの通知を受信するチャンネルの名前。
issue_channel文字列いいえイシューイベントの通知を受信するチャンネルの名前。
confidential_issue_channel文字列いいえ機密イシューイベントの通知を受信するチャンネルの名前。
merge_request_channel文字列いいえマージリクエストイベントの通知を受信するチャンネルの名前。
note_channel文字列いいえノートイベントの通知を受信するチャンネルの名前。
confidential_note_channel文字列いいえ機密ノートイベントの通知を受信するチャンネルの名前。
tag_push_channel文字列いいえタグプッシュイベントの通知を受信するチャンネルの名前。
pipeline_channel文字列いいえパイプラインイベントの通知を受信するチャンネルの名前。
wiki_page_channel文字列いいえWikiページイベントの通知を受信するチャンネルの名前。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Mattermost通知を無効にする

プロジェクトのMattermost通知を無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/mattermost

Mattermost通知設定を取得する

プロジェクトのMattermost通知設定を取得します。

GET /projects/:id/integrations/mattermost

Mattermostスラッシュコマンド

Mattermostスラッシュコマンドをセットアップする

プロジェクト用のMattermostスラッシュコマンドをセットアップします。

PUT /projects/:id/integrations/mattermost-slash-commands

パラメータは以下のとおりです:

パラメータ必須説明
token文字列はいMattermostトークン。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Mattermostスラッシュコマンドを無効にする

プロジェクトのMattermostスラッシュコマンドを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/mattermost-slash-commands

Mattermostスラッシュコマンド設定を取得する

プロジェクトのMattermostスラッシュコマンド設定を取得します。

GET /projects/:id/integrations/mattermost-slash-commands

Microsoft Teams通知

Microsoft Teams通知をセットアップする

プロジェクト用のMicrosoft Teams通知をセットアップします。

PUT /projects/:id/integrations/microsoft-teams

パラメータは以下のとおりです:

パラメータ必須説明
webhook文字列はいMicrosoft Teams Webhook (例: https://outlook.office.com/webhook/...)。
notify_only_broken_pipelinesブール値いいえ破損したパイプラインの通知を送信します。
notify_only_when_pipeline_status_changesブール値いいえリファレンスのパイプラインステータスが変更された場合にのみ通知を送信します。
notify_only_default_branchブール値いいえ非推奨: このパラメータはbranches_to_be_notifiedに置き換えられました。
branches_to_be_notified文字列いいえ通知を送信するブランチ。有効なオプションはalldefaultprotected、およびdefault_and_protectedです。デフォルト値はdefaultです。
push_eventsブール値いいえプッシュイベントの通知を有効にします。
issues_eventsブール値いいえイシューイベントの通知を有効にします。
confidential_issues_eventsブール値いいえ機密イシューイベントの通知を有効にします。
merge_requests_eventsブール値いいえマージリクエストイベントの通知を有効にします。
tag_push_eventsブール値いいえタグプッシュイベントの通知を有効にします。
note_eventsブール値いいえノートイベントの通知を有効にします。
confidential_note_eventsブール値いいえ機密ノートイベントの通知を有効にします。
pipeline_eventsブール値いいえパイプラインイベントの通知を有効にします。
wiki_page_eventsブール値いいえWikiページイベントの通知を有効にします。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Microsoft Teams通知を無効にする

プロジェクトのMicrosoft Teams通知を無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/microsoft-teams

Microsoft Teams通知設定を取得する

プロジェクトのMicrosoft Teams通知設定を取得します。

GET /projects/:id/integrations/microsoft-teams

モックCI

このインテグレーションは開発環境でのみ利用可能です。例のモックCIサーバーについては、gitlab-org/gitlab-mock-ci-serviceを参照してください。

モックCIをセットアップする

プロジェクト用のモックCIインテグレーションをセットアップします。

PUT /projects/:id/integrations/mock-ci

パラメータは以下のとおりです:

パラメータ必須説明
mock_service_url文字列はいモックCIインテグレーションのURL。
enable_ssl_verificationブール値いいえSSL検証を有効にします。デフォルトはtrue(有効)です。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

モックCIを無効にする

プロジェクトのモックCIインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/mock-ci

モックCI設定を取得する

プロジェクトのモックCIインテグレーション設定を取得します。

GET /projects/:id/integrations/mock-ci

Packagist

Packagistをセットアップする

プロジェクト用のPackagistインテグレーションをセットアップします。

PUT /projects/:id/integrations/packagist

パラメータは以下のとおりです:

パラメータ必須説明
username文字列はいPackagistアカウントのユーザー名。
token文字列はいPackagistサーバーのAPIトークン。
serverブール値いいえPackagistサーバーのURL。デフォルト値はhttps://packagist.orgです。
push_eventsブール値いいえプッシュイベントの通知を有効にします。
merge_requests_eventsブール値いいえマージリクエストイベントの通知を有効にします。
tag_push_eventsブール値いいえタグプッシュイベントの通知を有効にします。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Packagistを無効にする

プロジェクトのPackagistインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/packagist

Packagist設定を取得する

プロジェクトのPackagistインテグレーション設定を取得します。

GET /projects/:id/integrations/packagist

Phorge

Phorgeをセットアップする

プロジェクト用のPhorgeインテグレーションをセットアップします。

PUT /projects/:id/integrations/phorge

パラメータは以下のとおりです:

パラメータ必須説明
issues_url文字列はいイシューのURL。
project_url文字列はいプロジェクトのURL。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Phorgeを無効にする

プロジェクトのPhorgeインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/phorge

Phorge設定を取得する

プロジェクトのPhorgeインテグレーション設定を取得します。

GET /projects/:id/integrations/phorge

パイプラインステータスメール

パイプラインステータスメールをセットアップする

プロジェクト用のパイプラインステータスメールをセットアップします。

PUT /projects/:id/integrations/pipelines-email

パラメータは以下のとおりです:

パラメータ必須説明
recipients文字列はい受信者メールアドレスのカンマ区切りリスト。
notify_only_broken_pipelinesブール値いいえ破損したパイプラインの通知を送信します。
branches_to_be_notified文字列いいえ通知を送信するブランチ。有効なオプションはalldefaultprotected、およびdefault_and_protectedです。デフォルト値はdefaultです。
notify_only_default_branchブール値いいえデフォルトブランチの通知を送信します。
pipeline_eventsブール値いいえパイプラインイベントの通知を有効にします。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

パイプラインステータスメールを無効にする

プロジェクト用のパイプラインステータスメールを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/pipelines-email

パイプラインステータスメール設定を取得する

プロジェクト用のパイプラインステータスメール設定を取得します。

GET /projects/:id/integrations/pipelines-email

Pivotal Tracker

Pivotal Trackerをセットアップする

プロジェクト用のPivotal Trackerインテグレーションをセットアップします。

PUT /projects/:id/integrations/pivotaltracker

パラメータは以下のとおりです:

パラメータ必須説明
token文字列はいPivotal Trackerトークン。
restrict_to_branchブール値いいえ自動的に検査するブランチのカンマ区切りリスト。すべてのブランチを含める場合は空のままにします。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Pivotal Trackerを無効にする

プロジェクトのPivotal Trackerインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/pivotaltracker

Pivotal Tracker設定を取得する

プロジェクトのPivotal Trackerインテグレーション設定を取得します。

GET /projects/:id/integrations/pivotaltracker

Pumble

Pumbleをセットアップする

プロジェクト用のPumbleインテグレーションをセットアップします。

PUT /projects/:id/integrations/pumble

パラメータは以下のとおりです:

パラメータ必須説明
webhook文字列はいPumble Webhook (例: https://api.pumble.com/workspaces/x/...)。
branches_to_be_notified文字列いいえ通知を送信するブランチ。有効なオプションはalldefaultprotected、およびdefault_and_protectedです。デフォルトはdefaultです。
confidential_issues_eventsブール値いいえ機密イシューイベントの通知を有効にします。
confidential_note_eventsブール値いいえ機密ノートイベントの通知を有効にします。
issues_eventsブール値いいえイシューイベントの通知を有効にします。
merge_requests_eventsブール値いいえマージリクエストイベントの通知を有効にします。
note_eventsブール値いいえノートイベントの通知を有効にします。
notify_only_broken_pipelinesブール値いいえ破損したパイプラインの通知を送信します。
pipeline_eventsブール値いいえパイプラインイベントの通知を有効にします。
push_eventsブール値いいえプッシュイベントの通知を有効にします。
tag_push_eventsブール値いいえタグプッシュイベントの通知を有効にします。
wiki_page_eventsブール値いいえWikiページイベントの通知を有効にします。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Pumbleを無効にする

プロジェクトのPumbleインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/pumble

Pumble設定を取得する

プロジェクトのPumbleインテグレーション設定を取得します。

GET /projects/:id/integrations/pumble

Pushover

Pushoverをセットアップする

プロジェクト用のPushoverインテグレーションをセットアップします。

PUT /projects/:id/integrations/pushover

パラメータは以下のとおりです:

パラメータ必須説明
api_key文字列はいアプリケーションキー。
user_key文字列はいユーザーキー。
priority文字列はい優先度。
device文字列いいえすべての有効なデバイスで空白のままにします。
sound文字列いいえ通知のサウンド。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Pushoverを無効にする

プロジェクトのPushoverインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/pushover

Pushover設定を取得する

プロジェクトのPushoverインテグレーション設定を取得します。

GET /projects/:id/integrations/pushover

Redmine

Redmineをセットアップする

プロジェクト用のRedmineインテグレーションをセットアップします。

PUT /projects/:id/integrations/redmine

パラメータは以下のとおりです:

パラメータ必須説明
new_issue_url文字列はい新規イシューのURL。
project_url文字列はいプロジェクトのURL。
issues_url文字列はいイシューのURL。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Redmineを無効にする

プロジェクトのRedmineインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/redmine

Redmine設定を取得する

プロジェクトのRedmineインテグレーション設定を取得します。

GET /projects/:id/integrations/redmine

Slack通知

Slack通知をセットアップする

プロジェクト用のSlack通知をセットアップします。

PUT /projects/:id/integrations/slack

パラメータは以下のとおりです:

パラメータ必須説明
webhook文字列はいSlack通知Webhook (例: https://hooks.slack.com/services/...)。
username文字列いいえSlack通知ユーザー名。
channel文字列いいえ他のチャンネルが設定されていない場合に使用するデフォルトのチャンネル。
notify_only_broken_pipelinesブール値いいえ破損したパイプラインの通知を送信します。
notify_only_when_pipeline_status_changesブール値いいえリファレンスのパイプラインステータスが変更された場合にのみ通知を送信します。
notify_only_default_branchブール値いいえ非推奨: このパラメータはbranches_to_be_notifiedに置き換えられました。
branches_to_be_notified文字列いいえ通知を送信するブランチ。有効なオプションはalldefaultprotected、およびdefault_and_protectedです。デフォルト値はdefaultです。
labels_to_be_notified文字列いいえラベルの通知を送信します。すべてのイベントの通知を受信するには、空白のままにします。
labels_to_be_notified_behavior文字列いいえラベルの通知対象。有効なオプションはmatch_anymatch_allです。デフォルト値はmatch_anyです。
alert_channel文字列いいえアラートイベントの通知を受信するチャンネルの名前。
alert_eventsブール値いいえアラートイベントの通知を有効にします。
commit_eventsブール値いいえコミットイベントの通知を有効にします。
confidential_issue_channel文字列いいえ機密イシューイベントの通知を受信するチャンネルの名前。
confidential_issues_eventsブール値いいえ機密イシューイベントの通知を有効にします。
confidential_note_channel文字列いいえ機密ノートイベントの通知を受信するチャンネルの名前。
confidential_note_eventsブール値いいえ機密ノートイベントの通知を有効にします。
deployment_channel文字列いいえデプロイイベントの通知を受信するチャンネルの名前。
deployment_eventsブール値いいえデプロイイベントの通知を有効にします。
incident_channel文字列いいえインシデントイベントの通知を受信するチャンネルの名前。
incidents_eventsブール値いいえインシデントイベントの通知を有効にします。
issue_channel文字列いいえイシューイベントの通知を受信するチャンネルの名前。
issues_eventsブール値いいえイシューイベントの通知を有効にします。
job_eventsブール値いいえジョブイベントの通知を有効にします。
merge_request_channel文字列いいえマージリクエストイベントの通知を受信するチャンネルの名前。
merge_requests_eventsブール値いいえマージリクエストイベントの通知を有効にします。
note_channel文字列いいえノートイベントの通知を受信するチャンネルの名前。
note_eventsブール値いいえノートイベントの通知を有効にします。
pipeline_channel文字列いいえパイプラインイベントの通知を受信するチャンネルの名前。
pipeline_eventsブール値いいえパイプラインイベントの通知を有効にします。
push_channel文字列いいえプッシュイベントの通知を受信するチャンネルの名前。
push_eventsブール値いいえプッシュイベントの通知を有効にします。
tag_push_channel文字列いいえタグプッシュイベントの通知を受信するチャンネルの名前。
tag_push_eventsブール値いいえタグプッシュイベントの通知を有効にします。
wiki_page_channel文字列いいえWikiページイベントの通知を受信するチャンネルの名前。
wiki_page_eventsブール値いいえWikiページイベントの通知を有効にします。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Slack通知を無効にする

プロジェクトのSlack通知を無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/slack

Slack通知設定を取得する

プロジェクトのSlack通知設定を取得します。

GET /projects/:id/integrations/slack

Squash TM

Squash TMをセットアップする

プロジェクト用のSquash TMインテグレーション設定をセットアップします。

PUT /projects/:id/integrations/squash-tm

パラメータは以下のとおりです:

パラメータ必須説明
url文字列はいSquash TM WebhookのURL。
token文字列いいえシークレットトークン。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Squash TMを無効にする

プロジェクトのSquash TMインテグレーションを無効にします。インテグレーションの設定は保持されます。

DELETE /projects/:id/integrations/squash-tm

Squash TM設定を取得する

プロジェクトのSquash TMインテグレーション設定を取得します。

GET /projects/:id/integrations/squash-tm

Telegram

Telegramをセットアップする

プロジェクトのTelegramインテグレーションをセットアップします。

PUT /projects/:id/integrations/telegram

パラメータは以下のとおりです:

パラメータ必須説明
hostname文字列いいえTelegram APIのカスタムホスト名 (GitLab 17.1で導入)。デフォルト値はhttps://api.telegram.orgです。
token文字列はいTelegramボットのトークン(例: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11)。
room文字列はいターゲットチャットの固有識別子、またはターゲットチャンネルのユーザー名(@channelusernameの形式)。
thread整数いいえターゲットメッセージスレッドの固有識別子(フォーラムスーパーグループ内のトピック)。GitLab 16.11で導入されました。
notify_only_broken_pipelinesブール値いいえ破損したパイプラインの通知を送信します。
notify_only_when_pipeline_status_changesブール値いいえリファレンスのパイプラインステータスが変更された場合にのみ通知を送信します。
branches_to_be_notified文字列いいえブランチへの通知を送信 (GitLab 16.5で導入)。有効なオプションはalldefaultprotected、およびdefault_and_protectedです。デフォルト値はdefaultです。
push_eventsブール値はいプッシュイベントの通知を有効にします。
issues_eventsブール値はいイシューイベントの通知を有効にします。
confidential_issues_eventsブール値はい機密イシューイベントの通知を有効にします。
merge_requests_eventsブール値はいマージリクエストイベントの通知を有効にします。
tag_push_eventsブール値はいタグプッシュイベントの通知を有効にします。
note_eventsブール値はいノートイベントの通知を有効にします。
confidential_note_eventsブール値はい機密ノートイベントの通知を有効にします。
pipeline_eventsブール値はいパイプラインイベントの通知を有効にします。
wiki_page_eventsブール値はいWikiページイベントの通知を有効にします。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Telegramを無効にする

プロジェクトのTelegramインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/telegram

Telegramの設定を取得

プロジェクトのTelegramインテグレーション設定を取得します。

GET /projects/:id/integrations/telegram

Unify Circuit

Unify Circuitをセットアップする

プロジェクトのUnify Circuitインテグレーションをセットアップします。

PUT /projects/:id/integrations/unify-circuit

パラメータは以下のとおりです:

パラメータ必須説明
webhook文字列はいUnify Circuit Webhook(例: https://circuit.com/rest/v2/webhooks/incoming/...)。
notify_only_broken_pipelinesブール値いいえ破損したパイプラインの通知を送信します。
notify_only_when_pipeline_status_changesブール値いいえリファレンスのパイプラインステータスが変更された場合にのみ通知を送信します。
branches_to_be_notified文字列いいえ通知を送信するブランチ。有効なオプションはalldefaultprotected、およびdefault_and_protectedです。デフォルト値はdefaultです。
push_eventsブール値いいえプッシュイベントの通知を有効にします。
issues_eventsブール値いいえイシューイベントの通知を有効にします。
confidential_issues_eventsブール値いいえ機密イシューイベントの通知を有効にします。
merge_requests_eventsブール値いいえマージリクエストイベントの通知を有効にします。
tag_push_eventsブール値いいえタグプッシュイベントの通知を有効にします。
note_eventsブール値いいえノートイベントの通知を有効にします。
confidential_note_eventsブール値いいえ機密ノートイベントの通知を有効にします。
pipeline_eventsブール値いいえパイプラインイベントの通知を有効にします。
wiki_page_eventsブール値いいえWikiページイベントの通知を有効にします。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Unify Circuitを無効にする

プロジェクトのUnify Circuitインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/unify-circuit

Unify Circuitの設定を取得

プロジェクトのUnify Circuitインテグレーション設定を取得します。

GET /projects/:id/integrations/unify-circuit

Webex Teams

Webex Teamsをセットアップする

プロジェクトのWebex Teamsをセットアップします。

PUT /projects/:id/integrations/webex-teams

パラメータは以下のとおりです:

パラメータ必須説明
webhook文字列はいWebex Teams Webhook(例: https://api.ciscospark.com/v1/webhooks/incoming/...)。
notify_only_broken_pipelinesブール値いいえ破損したパイプラインの通知を送信します。
branches_to_be_notified文字列いいえ通知を送信するブランチ。有効なオプションはalldefaultprotected、およびdefault_and_protectedです。デフォルト値はdefaultです。
push_eventsブール値いいえプッシュイベントの通知を有効にします。
issues_eventsブール値いいえイシューイベントの通知を有効にします。
confidential_issues_eventsブール値いいえ機密イシューイベントの通知を有効にします。
merge_requests_eventsブール値いいえマージリクエストイベントの通知を有効にします。
tag_push_eventsブール値いいえタグプッシュイベントの通知を有効にします。
note_eventsブール値いいえノートイベントの通知を有効にします。
confidential_note_eventsブール値いいえ機密ノートイベントの通知を有効にします。
pipeline_eventsブール値いいえパイプラインイベントの通知を有効にします。
wiki_page_eventsブール値いいえWikiページイベントの通知を有効にします。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

Webex Teamsを無効にする

プロジェクトのWebex Teamsを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/webex-teams

Webex Teamsの設定を取得

プロジェクトのWebex Teams設定を取得します。

GET /projects/:id/integrations/webex-teams

YouTrack

YouTrackをセットアップする

プロジェクトのYouTrackインテグレーションをセットアップします。

PUT /projects/:id/integrations/youtrack

パラメータは以下のとおりです:

パラメータ必須説明
issues_url文字列はいイシューのURL。
project_url文字列はいプロジェクトのURL。
use_inherited_settingsブール値いいえデフォルトの設定を継承するかどうかを示します。falseがデフォルトです。

YouTrackを無効にする

プロジェクトのYouTrackインテグレーションを無効にします。インテグレーションの設定がリセットされます。

DELETE /projects/:id/integrations/youtrack

YouTrackの設定を取得

プロジェクトのYouTrackインテグレーション設定を取得します。

GET /projects/:id/integrations/youtrack