통합 API

Tier: Free, Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

이 API는 GitLab과 통합되는 외부 서비스와 작업할 수 있게 해줍니다.

이 API는 Maintainer 또는 Owner 역할의 액세스 토큰이 필요합니다.

모든 활성 통합 목록

  • vulnerability_events 필드 소개됨 GitLab 16.4에서.
  • inherited 필드 소개됨 GitLab 17.2에서 플래그와 함께 integration_api_inheritance라는 이름으로. 기본적으로 비활성화되어 있습니다.
  • inherited 필드 일반적으로 사용 가능 GitLab 17.3에서. 기능 플래그 integration_api_inheritance 제거됨.

모든 활성 프로젝트 통합 목록을 가져옵니다. 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

  • use_inherited_settings 매개변수 소개됨 GitLab 17.2에서 플래그와 함께 integration_api_inheritance라는 이름으로. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 매개변수 일반적으로 사용 가능 GitLab 17.3에서. 기능 플래그 integration_api_inheritance 제거됨.

Apple App Store Connect 설정

프로젝트를 위한 Apple App Store Connect 통합을 설정합니다.

PUT /projects/:id/integrations/apple_app_store

매개변수:

매개변수 유형 필수 설명
app_store_issuer_id string yes Apple App Store Connect 발급자 ID.
app_store_key_id string yes Apple App Store Connect 키 ID.
app_store_private_key_file_name string yes Apple App Store Connect 비공개 키 파일 이름.
app_store_private_key string yes Apple App Store Connect 비공개 키.
app_store_protected_refs boolean no 보호된 브랜치와 태그에서만 변수를 설정합니다.
use_inherited_settings boolean no 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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

  • use_inherited_settings 매개변수는 GitLab 17.2에 도입되었습니다 플래그인 integration_api_inheritance와 함께. 기본값은 비활성화 상태입니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반적으로 사용 가능합니다. 기능 플래그 integration_api_inheritance가 제거되었습니다.

Asana 설정

프로젝트를 위한 Asana 통합을 설정합니다.

PUT /projects/:id/integrations/asana

매개변수:

매개변수 유형 필수 설명
api_key string yes 사용자 API 토큰. 사용자는 작업에 접근할 수 있어야 합니다. 모든 댓글은 이 사용자에게 귀속됩니다.
restrict_to_branch string no 자동으로 검사할 브랜치의 쉼표로 구분된 목록입니다. 모든 브랜치를 포함하려면 비워 두세요.
use_inherited_settings boolean no 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

Asana 비활성화

프로젝트를 위한 Asana 통합을 비활성화합니다. 통합 설정이 재설정됩니다.

DELETE /projects/:id/integrations/asana

Asana 설정 가져오기

프로젝트를 위한 Asana 통합 설정을 가져옵니다.

GET /projects/:id/integrations/asana

Assembla

  • use_inherited_settings 매개변수는 GitLab 17.2에 도입되었습니다 플래그인 integration_api_inheritance와 함께. 기본값은 비활성화 상태입니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반적으로 사용 가능합니다. 기능 플래그 integration_api_inheritance가 제거되었습니다.

Assembla 설정

프로젝트를 위한 Assembla 통합을 설정합니다.

PUT /projects/:id/integrations/assembla

매개변수:

매개변수 유형 필수 설명
token string yes 인증 토큰입니다.
subdomain string no 서브 도메인 설정입니다.
use_inherited_settings boolean no 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

Assembla 비활성화

프로젝트의 Assembla 통합을 비활성화합니다. 통합 설정이 초기화됩니다.

DELETE /projects/:id/integrations/assembla

Assembla 설정 가져오기

프로젝트의 Assembla 통합 설정을 가져옵니다.

GET /projects/:id/integrations/assembla

Atlassian Bamboo

  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입됨 플래그와 함께 integration_api_inheritance라는 이름으로. 기본적으로 비활성화됩니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반적으로 제공됨. 기능 플래그 integration_api_inheritance가 제거되었습니다.

Atlassian Bamboo 설정

프로젝트의 Atlassian Bamboo 통합을 설정합니다.

자동 수정 라벨링 및 Bamboo에서 리포지토리 트리거를 구성해야 합니다.

PUT /projects/:id/integrations/bamboo

매개변수:

매개변수 유형 필수 설명
bamboo_url string 예 Bamboo 루트 URL (예: https://bamboo.example.com).
enable_ssl_verification boolean 아니오 SSL 인증을 활성화합니다. 기본값은 true(활성화됨)입니다.
build_key string 예 Bamboo 빌드 계획 키 (예: KEY).
username string 예 Bamboo 서버에 대한 API 액세스 권한이 있는 사용자.
password string 예 사용자의 비밀번호.
use_inherited_settings boolean 아니오 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

Atlassian Bamboo 비활성화

프로젝트의 Atlassian Bamboo 통합을 비활성화합니다. 통합 설정이 초기화됩니다.

DELETE /projects/:id/integrations/bamboo

Atlassian Bamboo 설정 가져오기

프로젝트의 Atlassian Bamboo 통합 설정을 가져옵니다.

GET /projects/:id/integrations/bamboo

Bugzilla

  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입됨 플래그와 함께 integration_api_inheritance라는 이름으로. 기본적으로 비활성화됩니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반적으로 제공됨. 기능 플래그 integration_api_inheritance가 제거되었습니다.

Bugzilla 설정

프로젝트의 Bugzilla 통합을 설정합니다.

PUT /projects/:id/integrations/bugzilla

매개변수:

매개변수 유형 필수 설명
new_issue_url string 예 새로운 이슈의 URL.
issues_url string 예 이슈의 URL.
project_url string 예 프로젝트의 URL.
use_inherited_settings boolean 아니오 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

Bugzilla 비활성화

프로젝트의 Bugzilla 통합을 비활성화합니다. 통합 설정이 초기화됩니다.

DELETE /projects/:id/integrations/bugzilla

Bugzilla 설정 가져오기

프로젝트의 Bugzilla 통합 설정을 가져옵니다.

GET /projects/:id/integrations/bugzilla

Buildkite

  • use_inherited_settings 매개변수가 GitLab 17.2에서 도입됨 플래그로 integration_api_inheritance 이름으로 특정되어 있습니다. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 매개변수가 GitLab 17.3에서 일반적으로 제공됨. 기능 플래그 integration_api_inheritance가 제거되었습니다.

Buildkite 설정하기

프로젝트의 Buildkite 통합을 설정합니다.

PUT /projects/:id/integrations/buildkite

매개변수:

매개변수 유형 필수 설명
token 문자열 예 Buildkite 프로젝트의 GitLab 토큰입니다.
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

  • use_inherited_settings 매개변수가 GitLab 17.2에서 도입됨 플래그로 integration_api_inheritance 이름으로 특정되어 있습니다. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 매개변수가 GitLab 17.3에서 일반적으로 제공됨. 기능 플래그 integration_api_inheritance가 제거되었습니다.

Campfire Classic과 통합할 수 있습니다. 그러나 Campfire Classic은 오래된 제품으로 더 이상 판매되지 않습니다.

Campfire Classic 설정하기

프로젝트의 Campfire Classic 통합을 설정합니다.

PUT /projects/:id/integrations/campfire

매개변수:

매개변수 유형 필수 설명
token 문자열 예 Campfire Classic에서 API 인증 토큰. 토큰을 얻으려면 Campfire Classic에 로그인하고 내 정보를 선택합니다.
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

  • GitLab 16.1에 도입됨.
  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입됨 integration_api_inheritance라는 플래그와 함께. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 매개변수가 GitLab 17.3에서 일반적으로 사용 가능. 기능 플래그 integration_api_inheritance가 제거되었습니다.

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 Workspace

  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입됨 integration_api_inheritance라는 플래그와 함께. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 매개변수가 GitLab 17.3에서 일반적으로 사용 가능. 기능 플래그 integration_api_inheritance가 제거되었습니다.

Confluence Workspace 설정

프로젝트에 대한 Confluence Workspace 통합을 설정합니다.

PUT /projects/:id/integrations/confluence

매개변수:

매개변수 유형 필수 설명
confluence_url 문자열 예 atlassian.net에 호스팅된 Confluence Workspace의 URL입니다.
use_inherited_settings 불리언 아니오 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

Confluence Workspace 비활성화

프로젝트에 대한 Confluence Workspace 통합을 비활성화합니다. 통합 설정이 초기화됩니다.

DELETE /projects/:id/integrations/confluence

Confluence Workspace 설정 가져오기

프로젝트에 대한 Confluence Workspace 통합 설정을 가져옵니다.

GET /projects/:id/integrations/confluence

커스텀 이슈 트래커

  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입됨 integration_api_inheritance라는 플래그와 함께. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 매개변수가 GitLab 17.3에서 일반적으로 사용 가능. 기능 플래그 integration_api_inheritance가 제거되었습니다.

사용자 정의 문제 추적기 설정

프로젝트에 대한 사용자 정의 문제 추적기를 설정합니다.

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

  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입된 특별한 플래그가 있는 integration_api_inheritance와 함께 기본값이 비활성화되어 있습니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반적으로 사용 가능합니다. 기능 플래그 integration_api_inheritance가 제거되었습니다.

Datadog 설정

프로젝트에 대한 Datadog 통합을 설정합니다.

PUT /projects/:id/integrations/datadog

매개변수:

매개변수 유형 필수 설명
api_key 문자열 예 Datadog와의 인증에 사용되는 API 키.
api_url 문자열 아니오 (고급) Datadog 사이트의 전체 URL.
datadog_env 문자열 아니오 자가 관리 배포의 경우, Datadog에 전송되는 모든 데이터에 대해 env% 태그를 설정합니다.
datadog_service 문자열 아니오 이 GitLab 인스턴스의 모든 데이터를 Datadog에서 태그합니다. 여러 자가 관리 배포를 관리할 때 사용할 수 있습니다.
datadog_site 문자열 아니오 데이터를 보낼 Datadog 사이트. EU 사이트로 데이터를 보내려면 datadoghq.eu를 사용하십시오.
datadog_tags 문자열 아니오 Datadog의 사용자 지정 태그. 형식 key:value\nkey2:value2로 각 행에 하나의 태그를 지정합니다.
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

  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입되었습니다. 기본값은 비활성화되어 있습니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반 사용 가능합니다. 기능 플래그 integration_api_inheritance가 제거되었습니다.

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 웹후크(예: https://discord.com/api/webhooks/...).
branches_to_be_notified 문자열 아니오 알림을 보낼 브랜치입니다. 유효한 옵션은 all, default, protected, default_and_protected입니다. 기본값은 default입니다.
confidential_issues_events 불리언 아니오 기밀 문제 이벤트에 대한 알림을 활성화합니다.
confidential_issue_channel 문자열 아니오 기밀 문제 이벤트에 대한 알림을 수신하기 위해 웹후크를 재정의합니다.
confidential_note_events 불리언 아니오 기밀 노트 이벤트에 대한 알림을 활성화합니다.
confidential_note_channel 문자열 아니오 기밀 노트 이벤트에 대한 알림을 수신하기 위해 웹후크를 재정의합니다.
deployment_events 불리언 아니오 배포 이벤트에 대한 알림을 활성화합니다.
deployment_channel 문자열 아니오 배포 이벤트에 대한 알림을 수신하기 위해 웹후크를 재정의합니다.
group_confidential_mentions_events 불리언 아니오 그룹 기밀 멘션 이벤트에 대한 알림을 활성화합니다.
group_confidential_mentions_channel 문자열 아니오 그룹 기밀 멘션 이벤트에 대한 알림을 수신하기 위해 웹후크를 재정의합니다.
group_mentions_events 불리언 아니오 그룹 멘션 이벤트에 대한 알림을 활성화합니다.
group_mentions_channel 문자열 아니오 그룹 멘션 이벤트에 대한 알림을 수신하기 위해 웹후크를 재정의합니다.
issues_events 불리언 아니오 문제 이벤트에 대한 알림을 활성화합니다.
issue_channel 문자열 아니오 문제 이벤트에 대한 알림을 수신하기 위해 웹후크를 재정의합니다.
merge_requests_events 불리언 아니오 병합 요청 이벤트에 대한 알림을 활성화합니다.
merge_request_channel 문자열 아니오 병합 요청 이벤트에 대한 알림을 수신하기 위해 웹후크를 재정의합니다.
note_events 불리언 아니오 노트 이벤트에 대한 알림을 활성화합니다.
note_channel 문자열 아니오 노트 이벤트에 대한 알림을 수신하기 위해 웹후크를 재정의합니다.
notify_only_broken_pipelines 불리언 아니오 손상된 파이프라인에 대한 알림을 보냅니다.
pipeline_events 불리언 아니오 파이프라인 이벤트에 대한 알림을 활성화합니다.
pipeline_channel 문자열 아니오 파이프라인 이벤트에 대한 알림을 수신하기 위해 웹후크를 재정의합니다.
push_events 불리언 아니오 푸시 이벤트에 대한 알림을 활성화합니다.
push_channel 문자열 아니오 푸시 이벤트에 대한 알림을 수신하기 위해 웹후크를 재정의합니다.
tag_push_events 불리언 아니오 태그 푸시 이벤트에 대한 알림을 활성화합니다.
tag_push_channel 문자열 아니오 태그 푸시 이벤트에 대한 알림을 수신하기 위해 웹후크를 재정의합니다.
wiki_page_events 불리언 아니오 위키 페이지 이벤트에 대한 알림을 활성화합니다.
wiki_page_channel 문자열 아니오 위키 페이지 이벤트에 대한 알림을 수신하기 위해 웹후크를 재정의합니다.
use_inherited_settings 불리언 아니오 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

Discord 알림 비활성화

프로젝트에 대한 Discord 알림을 비활성화합니다. 통합 설정이 재설정됩니다.

DELETE /projects/:id/integrations/discord

Discord 알림 설정 가져오기

프로젝트에 대한 Discord 알림 설정을 가져옵니다.

GET /projects/:id/integrations/discord

Drone

  • use_inherited_settings 매개변수가 GitLab 17.2에서 도입됨. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 매개변수가 GitLab 17.3에서 일반 사용 가능. 기능 플래그 integration_api_inheritance가 제거되었습니다.

Drone 설정

프로젝트에 대한 Drone 통합을 설정합니다.

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

매개변수:

매개변수 유형 필수 설명
token 문자열 예 Drone CI 프로젝트 특정 토큰입니다.
drone_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

푸시 시 이메일

  • use_inherited_settings 매개변수가 GitLab 17.2에서 도입됨. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 매개변수가 GitLab 17.3에서 일반 사용 가능. 기능 플래그 integration_api_inheritance가 제거되었습니다.

푸시 시 이메일 설정

프로젝트에 대한 푸시 시 이메일 통합을 설정합니다.

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

매개변수:

매개변수 유형 필수 설명
recipients 문자열 예 공백으로 구분된 이메일입니다.
disable_diffs 불리언 아니오 코드 차이를 비활성화합니다.
send_from_committer_email 불리언 아니오 커미터의 이메일에서 보냅니다.
push_events 불리언 아니오 푸시 이벤트에 대한 알림을 활성화합니다.
tag_push_events 불리언 아니오 태그 푸시 이벤트에 대한 알림을 활성화합니다.
branches_to_be_notified 문자열 아니오 알림을 보낼 브랜치입니다. 유효한 옵션은 all, default, protected, default_and_protected입니다. 태그 푸시에 대해서는 항상 알림이 발생합니다. 기본값은 all입니다.
use_inherited_settings 불리언 아니오 기본 설정 상속 여부를 나타냅니다. 기본값은 false입니다.

푸시 이메일 비활성화

프로젝트에 대한 푸시 통합에서 이메일을 비활성화합니다. 통합 설정이 초기화됩니다.

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

푸시 이메일 설정 가져오기

프로젝트에 대한 푸시 통합 설정을 가져옵니다.

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

엔지니어링 워크플로우 관리 (EWM)

  • use_inherited_settings 매개변수가 GitLab 17.2에서 도입됨 플래그와 함께 integration_api_inheritance라는 이름으로. 기본값은 비활성화 되어 있습니다.
  • use_inherited_settings 매개변수가 GitLab 17.3에서 일반적으로 사용 가능. 기능 플래그 integration_api_inheritance가 제거되었습니다.

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

외부 위키

  • use_inherited_settings 매개변수가 GitLab 17.2에서 도입됨 플래그와 함께 integration_api_inheritance라는 이름으로. 기본값은 비활성화 되어 있습니다.
  • use_inherited_settings 매개변수가 GitLab 17.3에서 일반적으로 사용 가능. 기능 플래그 integration_api_inheritance가 제거되었습니다.

외부 위키 설정

프로젝트에 대한 외부 위키를 설정합니다.

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

매개변수:

매개변수 유형 필수 설명
external_wiki_url 문자열 예 외부 위키의 URL.
use_inherited_settings 부울 아니요 기본 설정 상속 여부를 나타냅니다. 기본값은 false입니다.

외부 위키 비활성화

프로젝트에 대한 외부 위키를 비활성화합니다. 통합 설정이 초기화됩니다.

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

외부 위키 설정 가져오기

프로젝트에 대한 외부 위키 설정을 가져옵니다.

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

GitGuardian

Tier: Premium, Ultimate Offering: Self-managed, GitLab Dedicated
  • GitLab 16.9에서 도입됨 플래그와 함께 git_guardian_integration이라는 이름으로. 기본값은 활성화되어 있습니다. GitLab.com에서 비활성화됩니다.
  • use_inherited_settings 매개변수가 GitLab 17.2에서 도입됨 플래그와 함께 integration_api_inheritance라는 이름으로. 기본값은 비활성화 되어 있습니다.
  • use_inherited_settings 매개변수가 GitLab 17.3에서 일반적으로 사용 가능. 기능 플래그 integration_api_inheritance가 제거되었습니다.
자체 관리되는 GitLab에서는 기본적으로 이 기능이 제공됩니다. 기능을 숨기려면 관리자가 기능 플래그를 비활성화해 달라고 요청하세요 git_guardian_integration이라는 이름으로.
GitLab.com에서는 이 기능을 사용할 수 없습니다. GitLab Dedicated에서는 이 기능을 사용할 수 있습니다.

GitGuardian는 API 키 및 비밀번호와 같은 민감한 데이터를 소스 코드 리포지토리에서 탐지하는 사이버 보안 서비스입니다.

Git 저장소를 스캔하고, 정책 위반 사항에 대해 경고하며, 해커가 악용하기 전에 보안 문제를 해결하도록 돕습니다.

GitLab을 구성하여 GitGuardian 정책에 따라 커밋을 거부할 수 있습니다.

알려진 문제

  • 푸시가 지연되거나 시간 초과될 수 있습니다. GitGuardian 통합을 사용하면 푸시가 서드파티로 전송되며, GitLab은 GitGuardian 또는 GitGuardian 프로세스와의 연결을 제어할 수 없습니다.
  • GitGuardian API 제한으로 인해 통합은 1MB를 초과하는 파일을 무시합니다. 이 파일들은 스캔되지 않습니다.
  • 푸시된 파일의 이름이 256자 이상인 경우 푸시가 실패합니다.
    자세한 내용은 GitGuardian API 문서를 참조하세요.

통합 페이지의 문제 해결 단계에서 이러한 문제를 완화하는 방법을 보여줍니다.

GitGuardian 설정

프로젝트에 대한 GitGuardian 통합을 설정합니다.

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

파라미터:

파라미터 유형 필요 설명
token string 예 scan 범위가 포함된 GitGuardian API 토큰입니다.
use_inherited_settings boolean 아니오 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

GitGuardian 비활성화

프로젝트에 대한 GitGuardian 통합을 비활성화합니다. 통합 설정이 재설정됩니다.

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

GitGuardian 설정 가져오기

프로젝트에 대한 GitGuardian 통합 설정을 가져옵니다.

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

GitHub

세부정보:
Tier: Premium, Ultimate Offering: GitLab.com, Self-managed, GitLab Dedicated

GitHub 설정

프로젝트에 대한 GitHub 통합을 설정합니다.

PUT /projects/:id/integrations/github

파라미터:

파라미터 유형 필요 설명
token string 예 repo:status OAuth 범위가 포함된 GitHub API 토큰입니다.
repository_url string 예 GitHub 저장소 URL입니다.
static_context boolean 아니오 상태 확인 이름에 GitLab 인스턴스의 호스트 이름을 추가합니다.
use_inherited_settings boolean 아니오 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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를 사용하여 통합을 활성화하거나 비활성화할 수 없습니다.

프로젝트 통합 업데이트

Jira에서 그룹 링크를 사용하여 생성한 통합을 업데이트하려면 이 API 엔드포인트를 사용하세요.

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

매개변수:

매개변수 유형 필수 설명
jira_cloud_app_service_ids string 아니오 Jira Service Management 서비스 ID. 여러 ID를 구분하려면 쉼표(,)를 사용하세요.
jira_cloud_app_enable_deployment_gating boolean 아니오 Jira Service Management에서 차단된 GitLab 배포에 대한 배포 게이팅을 활성화합니다.
jira_cloud_app_deployment_gating_environments string 아니오 배포 게이팅을 활성화할 환경(생산, 스테이징, 테스트 또는 개발). 배포 게이팅이 활성화된 경우 필수입니다. 여러 환경을 구분하려면 쉼표(,)를 사용하세요.

GitLab for Jira Cloud 앱 설정 가져오기

프로젝트에 대한 GitLab for Jira Cloud 앱 통합 설정을 가져옵니다.

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

GitLab for Slack 앱

  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입되었습니다. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반적으로 사용 가능합니다. 기능 플래그 integration_api_inheritance가 제거되었습니다.

GitLab for Slack 앱 설정하기

프로젝트에 대한 GitLab for Slack 앱 통합을 업데이트하세요.

API를 통해 GitLab for Slack 앱을 생성할 수 없습니다. 통합은 GitLab API만으로는 얻을 수 없는 OAuth 2.0 토큰이 필요하기 때문입니다.

대신 GitLab UI에서 앱을 설치하세요.

그런 다음 이 API 엔드포인트를 사용하여 통합을 업데이트할 수 있습니다.

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

매개변수:

매개변수 유형 필수 설명
channel string 아니오 다른 채널이 구성되지 않은 경우 사용할 기본 채널.
notify_only_broken_pipelines boolean 아니오 고장난 파이프라인에 대한 알림 전송.
notify_only_default_branch boolean 아니오 사용 안 함: 이 매개변수는 branches_to_be_notified로 대체되었습니다.
branches_to_be_notified string 아니오 알림을 받을 브랜치. 유효한 옵션은 all, default, protected, default_and_protected입니다. 기본값은 default입니다.
alert_events boolean 아니오 경고 이벤트에 대한 알림 활성화.
issues_events boolean 아니오 이슈 이벤트에 대한 알림 활성화.
confidential_issues_events boolean 아니오 기밀 이슈 이벤트에 대한 알림 활성화.
merge_requests_events boolean 아니오 병합 요청 이벤트에 대한 알림 활성화.
note_events boolean 아니오 노트 이벤트에 대한 알림 활성화.
confidential_note_events boolean 아니오 기밀 노트 이벤트에 대한 알림 활성화.
deployment_events boolean 아니오 배포 이벤트에 대한 알림 활성화.
incidents_events boolean 아니오 사고 이벤트에 대한 알림 활성화.
pipeline_events boolean 아니오 파이프라인 이벤트에 대한 알림 활성화.
push_events boolean 아니오 푸시 이벤트에 대한 알림 활성화.
tag_push_events boolean 아니오 태그 푸시 이벤트에 대한 알림 활성화.
vulnerability_events boolean 아니오 취약점 이벤트에 대한 알림 활성화.
wiki_page_events boolean 아니오 위키 페이지 이벤트에 대한 알림 활성화.
labels_to_be_notified string 아니오 알림을 받을 레이블. 설정하지 않으면 모든 이벤트에 대한 알림을 수신합니다.
labels_to_be_notified_behavior string 아니오 알림을 받을 레이블. 유효한 옵션은 match_any와 match_all입니다. 기본값은 match_any입니다.
push_channel string 아니오 푸시 이벤트에 대한 알림을 받을 채널의 이름.
issue_channel string 아니오 이슈 이벤트에 대한 알림을 받을 채널의 이름.
confidential_issue_channel string 아니오 기밀 이슈 이벤트에 대한 알림을 받을 채널의 이름.
merge_request_channel string 아니오 병합 요청 이벤트에 대한 알림을 받을 채널의 이름.
note_channel string 아니오 노트 이벤트에 대한 알림을 받을 채널의 이름.
confidential_note_channel string 아니오 기밀 노트 이벤트에 대한 알림을 받을 채널의 이름.
tag_push_channel string 아니오 태그 푸시 이벤트에 대한 알림을 받을 채널의 이름.
pipeline_channel string 아니오 파이프라인 이벤트에 대한 알림을 받을 채널의 이름.
wiki_page_channel string 아니오 위키 페이지 이벤트에 대한 알림을 받을 채널의 이름.
deployment_channel string 아니오 배포 이벤트에 대한 알림을 받을 채널의 이름.
incident_channel string 아니오 사고 이벤트에 대한 알림을 받을 채널의 이름.
vulnerability_channel string 아니오 취약점 이벤트에 대한 알림을 받을 채널의 이름.
alert_channel string 아니오 경고 이벤트에 대한 알림을 받을 채널의 이름.
use_inherited_settings boolean 아니오 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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

  • use_inherited_settings 매개변수 소개됨 GitLab 17.2에서 플래그 integration_api_inheritance와 함께. 기본적으로 비활성화됨.
  • use_inherited_settings 매개변수 일반적으로 사용 가능 GitLab 17.3에서. 기능 플래그 integration_api_inheritance 제거됨.

Google Chat 설정

프로젝트에 대한 Google Chat 통합을 설정합니다.

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

매개변수:

매개변수 유형 필수 설명
webhook string 예 Hangouts Chat 웹훅(예: https://chat.googleapis.com/v1/spaces...).
notify_only_broken_pipelines boolean 아니요 손상된 파이프라인에 대한 알림을 보냅니다.
notify_only_default_branch boolean 아니요 사용 중단: 이 매개변수는 branches_to_be_notified로 대체되었습니다.
branches_to_be_notified string 아니요 알림을 보낼 브랜치. 유효한 옵션은 all, default, protected, default_and_protected입니다. 기본값은 default입니다.
push_events boolean 아니요 푸시 이벤트에 대한 알림을 활성화합니다.
issues_events boolean 아니요 이슈 이벤트에 대한 알림을 활성화합니다.
confidential_issues_events boolean 아니요 기밀 이슈 이벤트에 대한 알림을 활성화합니다.
merge_requests_events boolean 아니요 병합 요청 이벤트에 대한 알림을 활성화합니다.
tag_push_events boolean 아니요 태그 푸시 이벤트에 대한 알림을 활성화합니다.
note_events boolean 아니요 노트 이벤트에 대한 알림을 활성화합니다.
confidential_note_events boolean 아니요 기밀 노트 이벤트에 대한 알림을 활성화합니다.
pipeline_events boolean 아니요 파이프라인 이벤트에 대한 알림을 활성화합니다.
wiki_page_events boolean 아니요 위키 페이지 이벤트에 대한 알림을 활성화합니다.
use_inherited_settings boolean 아니요 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

Google Chat 비활성화

프로젝트에 대한 Google Chat 통합을 비활성화합니다. 통합 설정이 초기화됩니다.

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

Google Chat 설정 가져오기

프로젝트에 대한 Google Chat 통합 설정을 가져옵니다.

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

Google Artifact Management

Tier: Free, Premium, Ultimate

Offering: GitLab.com

Status: Beta

  • 소개됨 GitLab 16.9에서 베타 기능으로 플래그 google_cloud_support_feature_flag와 함께. 기본적으로 비활성화됨.
  • GitLab.com에서 활성화됨 GitLab 17.1. 기능 플래그 google_cloud_support_feature_flag 제거됨.
  • use_inherited_settings 매개변수 소개됨 GitLab 17.2에서 플래그 integration_api_inheritance와 함께. 기본적으로 비활성화됨.
  • use_inherited_settings 매개변수 일반적으로 사용 가능 GitLab 17.3에서. 기능 플래그 integration_api_inheritance 제거됨.

이 기능은 베타입니다.

Google Artifact Management 설정

프로젝트에 대한 Google Artifact Management 통합을 설정합니다.

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

매개변수:

매개변수 유형 필수 설명
artifact_registry_project_id string 예 Google Cloud 프로젝트의 ID.
artifact_registry_location string 예 Artifact Registry 저장소의 위치.
artifact_registry_repositories string 예 Artifact Registry의 저장소.
use_inherited_settings boolean 아니오 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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)

Tier: Free, Premium, Ultimate Offering: GitLab.com
Status: Beta

이 기능은 beta입니다.

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 string 예 Workload Identity Federation에 대한 Google Cloud 프로젝트 ID.
workload_identity_federation_project_number integer 예 Workload Identity Federation에 대한 Google Cloud 프로젝트 번호.
workload_identity_pool_id string 예 Workload Identity Pool의 ID.
workload_identity_pool_provider_id string 예 Workload Identity Pool 공급자의 ID.
use_inherited_settings boolean 아니오 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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

  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입됨 플래그 integration_api_inheritance와 함께. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반 제공됩니다. 기능 플래그 integration_api_inheritance 제거됨.

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

  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입됨 플래그 integration_api_inheritance와 함께. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반 제공됩니다. 기능 플래그 integration_api_inheritance 제거됨.

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 게이트웨이)

  • use_inherited_settings 매개변수 도입됨 GitLab 17.2에서 integration_api_inheritance라는 플래그와 함께. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 매개변수 일반적으로 사용 가능 GitLab 17.3에서. 기능 플래그 integration_api_inheritance가 제거되었습니다.

irker 설정하기

프로젝트에 대한 irker 통합을 설정합니다.

PUT /projects/:id/integrations/irker

매개변수:

매개변수 유형 필수 설명
recipients 문자열 예 공백으로 구분된 수신자 또는 채널.
default_irc_uri 문자열 아니오 irc://irc.network.net:6697/.
server_host 문자열 아니오 localhost.
server_port 정수 아니오 6659.
colorize_messages 부울 아니오 메시지를 색상화합니다.
use_inherited_settings 부울 아니오 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

irker 비활성화하기

프로젝트에 대한 irker 통합을 비활성화합니다. 통합 설정이 재설정됩니다.

DELETE /projects/:id/integrations/irker

irker 설정 가져오기

프로젝트에 대한 irker 통합 설정을 가져옵니다.

GET /projects/:id/integrations/irker

Jenkins

  • use_inherited_settings 매개변수 도입됨 GitLab 17.2에서 integration_api_inheritance라는 플래그와 함께. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 매개변수 일반적으로 사용 가능 GitLab 17.3에서. 기능 플래그 integration_api_inheritance가 제거되었습니다.

Jenkins 설정하기

프로젝트에 대한 Jenkins 통합을 설정합니다.

PUT /projects/:id/integrations/jenkins

매개변수:

매개변수 유형 필수 설명
jenkins_url 문자열 예 http://jenkins.example.com와 같은 Jenkins URL.
enable_ssl_verification 부울 아니오 SSL 인증을 활성화합니다. 기본값은 true(활성화됨)입니다.
project_name 문자열 예 URL 친화적인 프로젝트 이름. 예: my_project_name.
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

  • use_inherited_settings 매개변수가 GitLab 17.2에서 도입됨 플래그 integration_api_inheritance와 함께. 기본적으로 비활성화되어 있음.
  • use_inherited_settings 매개변수가 GitLab 17.3에서 일반 제공됨. 기능 플래그 integration_api_inheritance가 제거됨.

JetBrains TeamCity 설정

프로젝트의 JetBrains TeamCity 통합을 설정합니다.

TeamCity의 빌드 구성은 빌드 번호 형식 %build.vcs.number%를 사용해야 합니다.

VCS 루트의 고급 설정에서 모든 브랜치를 모니터링하도록 구성하여 병합 요청을 빌드할 수 있게 합니다.

PUT /projects/:id/integrations/teamcity

매개변수:

매개변수 유형 필수 설명
teamcity_url string 예 TeamCity 루트 URL (예: https://teamcity.example.com).
enable_ssl_verification boolean 아니오 SSL 검증 활성화. 기본값은 true (활성화됨).
build_type string 예 빌드 구성 ID.
username string 예 수동 빌드를 트리거할 권한이 있는 사용자.
password string 예 사용자의 비밀번호.
push_events boolean 아니오 푸시 이벤트에 대한 알림 활성화.
merge_requests_events boolean 아니오 병합 요청 이벤트에 대한 알림 활성화.
use_inherited_settings boolean 아니오 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false.

JetBrains TeamCity 비활성화

프로젝트의 JetBrains TeamCity 통합을 비활성화합니다. 통합 설정이 초기화됩니다.

DELETE /projects/:id/integrations/teamcity

JetBrains TeamCity 설정 가져오기

프로젝트의 JetBrains TeamCity 통합 설정을 가져옵니다.

GET /projects/:id/integrations/teamcity

Jira

  • use_inherited_settings 매개변수가 GitLab 17.2에서 도입됨 플래그 integration_api_inheritance와 함께. 기본적으로 비활성화되어 있음.
  • use_inherited_settings 매개변수가 GitLab 17.3에서 일반 제공됨. 기능 플래그 integration_api_inheritance가 제거됨.

Jira 설정

프로젝트의 Jira 통합을 설정합니다.

PUT /projects/:id/integrations/jira

매개변수:

매개변수 유형 필수 설명
url string 예 이 GitLab 프로젝트에 연결된 Jira 프로젝트의 URL (예: https://jira.example.com).
api_url string 아니오 Jira 인스턴스 API의 기본 URL. 설정되지 않은 경우 웹 URL 값이 사용됨 (예: https://jira-api.example.com).
username string 아니오 Jira에서 사용되는 이메일 또는 사용자 이름. Jira Cloud에는 이메일을 사용하고, Jira Data Center 및 Jira Server에는 사용자 이름을 사용합니다. 기본 인증을 사용할 때 반드시 필요함 (jira_auth_type이 0인 경우).
password string 예 Jira에서 사용될 API 토큰, 비밀번호 또는 개인 액세스 토큰입니다. 인증 방법이 기본 ( jira_auth_type이 0인 경우)인 경우 Jira Cloud의 API 토큰이나 Jira Data Center 또는 Jira Server의 비밀번호를 사용하십시오. 인증 방법이 Jira 개인 액세스 토큰 (jira_auth_type이 1인 경우)인 경우 개인 액세스 토큰을 사용하십시오.
active boolean 아니오 통합을 활성화 또는 비활성화합니다. 기본값은 false (비활성화됨).
jira_auth_type integer 아니오 Jira에서 사용할 인증 방법입니다. 0은 기본 인증을 의미하며, 1은 Jira 개인 액세스 토큰을 의미합니다. 기본값은 0.
jira_issue_prefix string 아니오 Jira 문제 키와 일치하는 접두사.
jira_issue_regex string 아니오 Jira 문제 키와 일치하는 정규 표현식.
jira_issue_transition_automatic boolean 아니오 자동 문제 전환을 활성화합니다. 활성화되면 jira_issue_transition_id보다 우선합니다. 기본값은 false.
jira_issue_transition_id string 아니오 사용자 정의 문제 전환에 대한 하나 이상의 전환 ID입니다. jira_issue_transition_automatic이 활성화되면 무시됩니다. 기본값은 비어 있는 문자열로, 사용자 정의 전환을 비활성화합니다.
commit_events boolean 아니오 커밋 이벤트에 대한 알림을 활성화합니다.
merge_requests_events boolean 아니오 병합 요청 이벤트에 대한 알림을 활성화합니다.
comment_on_event_enabled boolean 아니오 각 GitLab 이벤트 (커밋 또는 병합 요청)에서 Jira 문제에 댓글을 활성화합니다.
issues_enabled boolean 아니오 GitLab에서 Jira 문제를 볼 수 있도록 활성화합니다. GitLab 17.0에서 도입됨.
project_keys 문자열 배열 아니오 Jira 프로젝트의 키입니다. issues_enabled가 true이면 이 설정은 GitLab에서 문제를 보기 위한 Jira 프로젝트를 지정합니다. GitLab 17.0에서 도입됨.
use_inherited_settings boolean 아니오 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false.

Jira 비활성화

프로젝트에 대한 Jira 통합을 비활성화합니다. 통합 설정이 초기화됩니다.

DELETE /projects/:id/integrations/jira

Jira 설정 가져오기

프로젝트에 대한 Jira 통합 설정을 가져옵니다.

GET /projects/:id/integrations/jira

매트릭스 알림

  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입됨 플래그 integration_api_inheritance와 함께. 기본값은 비활성화되어 있습니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반적으로 사용 가능합니다. 기능 플래그 integration_api_inheritance가 제거되었습니다.

매트릭스 알림 설정

프로젝트에 대한 매트릭스 알림을 설정합니다.

PUT /projects/:id/integrations/matrix

매개변수:

매개변수 유형 필수 설명
hostname string 아니요 매트릭스 서버의 사용자 정의 호스트명. 기본값은 https://matrix.org입니다.
token string 예 매트릭스 액세스 토큰(예: syt-zyx57W2v1u123ew11).
room string 예 대상 방의 고유 식별자(형식 !qPKKM111FFKKsfoCVy:matrix.org).
notify_only_broken_pipelines boolean 아니요 깨진 파이프라인에 대한 알림을 전송합니다.
branches_to_be_notified string 아니요 알림을 보낼 브랜치. 유효한 옵션은 all, default, protected, 및 default_and_protected입니다. 기본값은 default입니다.
push_events boolean 아니요 푸시 이벤트에 대한 알림을 활성화합니다.
issues_events boolean 아니요 문제 이벤트에 대한 알림을 활성화합니다.
confidential_issues_events boolean 아니요 비밀 문제 이벤트에 대한 알림을 활성화합니다.
merge_requests_events boolean 아니요 병합 요청 이벤트에 대한 알림을 활성화합니다.
tag_push_events boolean 아니요 태그 푸시 이벤트에 대한 알림을 활성화합니다.
note_events boolean 아니요 노트 이벤트에 대한 알림을 활성화합니다.
confidential_note_events boolean 아니요 비밀 노트 이벤트에 대한 알림을 활성화합니다.
pipeline_events boolean 아니요 파이프라인 이벤트에 대한 알림을 활성화합니다.
wiki_page_events boolean 아니요 위키 페이지 이벤트에 대한 알림을 활성화합니다.
use_inherited_settings boolean 아니요 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

매트릭스 알림 비활성화

프로젝트에 대한 매트릭스 알림을 비활성화합니다. 통합 설정이 초기화됩니다.

DELETE /projects/:id/integrations/matrix

매트릭스 알림 설정 가져오기

프로젝트에 대한 매트릭스 알림 설정을 가져옵니다.

GET /projects/:id/integrations/matrix

Mattermost 알림

  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입됨 플래그 integration_api_inheritance와 함께. 기본값은 비활성화되어 있습니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반적으로 사용 가능합니다. 기능 플래그 integration_api_inheritance가 제거되었습니다.

Mattermost 알림 설정

프로젝트에 대한 Mattermost 알림을 설정합니다.

PUT /projects/:id/integrations/mattermost

매개변수:

매개변수 유형 필수 설명
webhook string 예 Mattermost 알림 웹훅 (예: http://mattermost.example.com/hooks/...).
username string 아니오 Mattermost 알림 사용자 이름.
channel string 아니오 다른 채널이 구성되지 않은 경우 사용할 기본 채널.
notify_only_broken_pipelines boolean 아니오 손상된 파이프라인에 대한 알림 전송.
notify_only_default_branch boolean 아니오 사용 중단: 이 매개변수는 branches_to_be_notified로 대체되었습니다.
branches_to_be_notified string 아니오 알림을 전송할 브랜치. 유효한 옵션은 all, default, protected, default_and_protected입니다. 기본값은 default입니다.
labels_to_be_notified string 아니오 알림을 전송할 레이블. 모든 이벤트에 대한 알림을 받으려면 비워 두세요.
labels_to_be_notified_behavior string 아니오 알림을 받을 레이블. 유효한 옵션은 match_any 및 match_all입니다. 기본값은 match_any입니다.
push_events boolean 아니오 푸시 이벤트에 대한 알림 활성화.
issues_events boolean 아니오 이슈 이벤트에 대한 알림 활성화.
confidential_issues_events boolean 아니오 기밀 이슈 이벤트에 대한 알림 활성화.
merge_requests_events boolean 아니오 병합 요청 이벤트에 대한 알림 활성화.
tag_push_events boolean 아니오 태그 푸시 이벤트에 대한 알림 활성화.
note_events boolean 아니오 노트 이벤트에 대한 알림 활성화.
confidential_note_events boolean 아니오 기밀 노트 이벤트에 대한 알림 활성화.
pipeline_events boolean 아니오 파이프라인 이벤트에 대한 알림 활성화.
wiki_page_events boolean 아니오 위키 페이지 이벤트에 대한 알림 활성화.
push_channel string 아니오 푸시 이벤트에 대한 알림을 받을 채널 이름.
issue_channel string 아니오 이슈 이벤트에 대한 알림을 받을 채널 이름.
confidential_issue_channel string 아니오 기밀 이슈 이벤트에 대한 알림을 받을 채널 이름.
merge_request_channel string 아니오 병합 요청 이벤트에 대한 알림을 받을 채널 이름.
note_channel string 아니오 노트 이벤트에 대한 알림을 받을 채널 이름.
confidential_note_channel string 아니오 기밀 노트 이벤트에 대한 알림을 받을 채널 이름.
tag_push_channel string 아니오 태그 푸시 이벤트에 대한 알림을 받을 채널 이름.
pipeline_channel string 아니오 파이프라인 이벤트에 대한 알림을 받을 채널 이름.
wiki_page_channel string 아니오 위키 페이지 이벤트에 대한 알림을 받을 채널 이름.
use_inherited_settings boolean 아니오 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

Mattermost 알림 비활성화

프로젝트에 대한 Mattermost 알림을 비활성화합니다. 통합 설정이 초기화됩니다.

DELETE /projects/:id/integrations/mattermost

Mattermost 알림 설정 가져오기

프로젝트의 Mattermost 알림 설정을 가져옵니다.

GET /projects/:id/integrations/mattermost

Mattermost 슬래시 커맨드

  • use_inherited_settings 매개변수는 GitLab 17.2에서 소개됨. 기본값은 비활성화됨.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반 제공. 기능 플래그 integration_api_inheritance가 제거됨.

Mattermost 슬래시 커맨드 설정

프로젝트에 대한 Mattermost 슬래시 커맨드를 설정합니다.

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

매개변수:

매개변수 유형 필수 설명
token string 예 Mattermost 토큰.
use_inherited_settings boolean 아니오 기본 설정을 상속할지 여부. 기본값은 false.

Mattermost 슬래시 커맨드 비활성화

프로젝트에 대한 Mattermost 슬래시 커맨드를 비활성화합니다. 통합 설정이 초기화됩니다.

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

Mattermost 슬래시 커맨드 설정 가져오기

프로젝트에 대한 Mattermost 슬래시 커맨드 설정을 가져옵니다.

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

Microsoft Teams 알림

  • use_inherited_settings 매개변수는 GitLab 17.2에서 소개됨. 기본값은 비활성화됨.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반 제공. 기능 플래그 integration_api_inheritance가 제거됨.

Microsoft Teams 알림 설정

프로젝트에 대한 Microsoft Teams 알림을 설정합니다.

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

매개변수:

매개변수 유형 필수 설명
webhook string 예 Microsoft Teams 웹훅 (예: https://outlook.office.com/webhook/...).
notify_only_broken_pipelines boolean 아니오 오류가 발생한 파이프라인에 대한 알림 전송.
notify_only_default_branch boolean 아니오 사용 중단됨: 이 매개변수는 branches_to_be_notified로 대체되었습니다.
branches_to_be_notified string 아니오 알림을 보낼 브랜치. 유효한 옵션은 all, default, protected, default_and_protected입니다. 기본값은 default입니다.
push_events boolean 아니오 푸시 이벤트에 대한 알림 활성화.
issues_events boolean 아니오 이슈 이벤트에 대한 알림 활성화.
confidential_issues_events boolean 아니오 기밀 이슈 이벤트에 대한 알림 활성화.
merge_requests_events boolean 아니오 병합 요청 이벤트에 대한 알림 활성화.
tag_push_events boolean 아니오 태그 푸시 이벤트에 대한 알림 활성화.
note_events boolean 아니오 노트 이벤트에 대한 알림 활성화.
confidential_note_events boolean 아니오 기밀 노트 이벤트에 대한 알림 활성화.
pipeline_events boolean 아니오 파이프라인 이벤트에 대한 알림 활성화.
wiki_page_events boolean 아니오 위키 페이지 이벤트에 대한 알림 활성화.
use_inherited_settings boolean 아니오 기본 설정을 상속할지 여부. 기본값은 false.

Microsoft Teams 알림 비활성화

프로젝트에 대한 Microsoft Teams 알림을 비활성화합니다. 통합 설정이 초기화됩니다.

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

Microsoft Teams 알림 설정 가져오기

프로젝트에 대한 Microsoft Teams 알림 설정을 가져옵니다.

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

Mock CI

  • use_inherited_settings 매개변수 도입됨 GitLab 17.2에서 integration_api_inheritance라는 플래그와 함께. 기본적으로 비활성화됨.
  • use_inherited_settings 매개변수 일반 제공 GitLab 17.3에서. 기능 플래그 integration_api_inheritance가 제거됨.

이 통합은 개발 환경에서만 사용 가능합니다.

예제 Mock CI 서버에 대해서는 gitlab-org/gitlab-mock-ci-service를 참조하세요.

Mock CI 설정하기

프로젝트에 대한 Mock CI 통합을 설정합니다.

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

매개변수:

매개변수 유형 필수 설명
mock_service_url 문자열 예 Mock CI 통합의 URL.
enable_ssl_verification 불리언 아니요 SSL 인증을 활성화합니다. 기본값은 true(활성화됨).
use_inherited_settings 불리언 아니요 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false.

Mock CI 비활성화

프로젝트에 대한 Mock CI 통합을 비활성화합니다. 통합 설정이 초기화됩니다.

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

Mock CI 설정 가져오기

프로젝트에 대한 Mock CI 통합 설정을 가져옵니다.

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

Packagist

  • use_inherited_settings 매개변수 도입됨 GitLab 17.2에서 integration_api_inheritance라는 플래그와 함께. 기본적으로 비활성화됨.
  • use_inherited_settings 매개변수 일반 제공 GitLab 17.3에서. 기능 플래그 integration_api_inheritance가 제거됨.

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

  • GitLab 16.11에서 도입됨.
  • use_inherited_settings 매개변수가 GitLab 17.2에서 도입됨 integration_api_inheritance이라는 플래그와 함께. 기본적으로 비활성화됨.
  • use_inherited_settings 매개변수가 GitLab 17.3에서 일반적으로 사용 가능. 기능 플래그 integration_api_inheritance가 제거됨.

Phorge 설정

프로젝트에 대한 Phorge 통합을 설정합니다.

PUT /projects/:id/integrations/phorge

매개변수:

매개변수 유형 필수 설명
issues_url string 예 이슈의 URL.
project_url string 예 프로젝트의 URL.
use_inherited_settings boolean 아니오 기본 설정을 상속 여부를 나타냅니다. 기본값은 false입니다.

Phorge 비활성화

프로젝트에 대한 Phorge 통합을 비활성화합니다. 통합 설정이 재설정됩니다.

DELETE /projects/:id/integrations/phorge

Phorge 설정 가져오기

프로젝트에 대한 Phorge 통합 설정을 가져옵니다.

GET /projects/:id/integrations/phorge

파이프라인 상태 이메일

  • use_inherited_settings 매개변수가 GitLab 17.2에서 도입됨 integration_api_inheritance이라는 플래그와 함께. 기본적으로 비활성화됨.
  • use_inherited_settings 매개변수가 GitLab 17.3에서 일반적으로 사용 가능. 기능 플래그 integration_api_inheritance가 제거됨.

파이프라인 상태 이메일 설정

프로젝트에 대한 파이프라인 상태 이메일을 설정합니다.

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

매개변수:

매개변수 유형 필수 설명
recipients string 예 수신자 이메일 주소의 쉼표로 구분된 목록.
notify_only_broken_pipelines boolean 아니오 고장난 파이프라인에 대한 알림을 보냅니다.
branches_to_be_notified string 아니오 알림을 보낼 브랜치. 유효한 옵션은 all, default, protected, default_and_protected입니다. 기본값은 default입니다.
notify_only_default_branch boolean 아니오 기본 브랜치에 대한 알림을 보냅니다.
pipeline_events boolean 아니오 파이프라인 이벤트에 대한 알림을 활성화합니다.
use_inherited_settings boolean 아니오 기본 설정을 상속 여부를 나타냅니다. 기본값은 false입니다.

파이프라인 상태 이메일 비활성화

프로젝트에 대한 파이프라인 상태 이메일을 비활성화합니다. 통합 설정이 초기화됩니다.

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

파이프라인 상태 이메일 설정 가져오기

프로젝트에 대한 파이프라인 상태 이메일 설정을 가져옵니다.

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

Pivotal Tracker

  • use_inherited_settings 파라미터는 GitLab 17.2에서 도입되었습니다 플래그 integration_api_inheritance와 함께. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 파라미터는 GitLab 17.3에서 일반적으로 사용 가능합니다. 기능 플래그 integration_api_inheritance가 제거되었습니다.

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

  • use_inherited_settings 파라미터는 GitLab 17.2에서 도입되었습니다 플래그 integration_api_inheritance와 함께. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 파라미터는 GitLab 17.3에서 일반적으로 사용 가능합니다. 기능 플래그 integration_api_inheritance가 제거되었습니다.

Pumble 설정하기

프로젝트에 대한 Pumble 통합을 설정합니다.

PUT /projects/:id/integrations/pumble

파라미터:

매개변수 유형 필수 설명
webhook 문자열 예 Pumble 웹훅 (예: https://api.pumble.com/workspaces/x/...).
branches_to_be_notified 문자열 아니오 알림을 보낼 브랜치입니다. 유효한 옵션은 all, default, protected, 및 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 불리언 아니오 위키 페이지 이벤트에 대한 알림을 활성화합니다.
use_inherited_settings 불리언 아니오 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

Pumble 비활성화

프로젝트에 대한 Pumble 통합을 비활성화합니다. 통합 설정이 재설정됩니다.

DELETE /projects/:id/integrations/pumble

Pumble 설정 가져오기

프로젝트에 대한 Pumble 통합 설정을 가져옵니다.

GET /projects/:id/integrations/pumble

Pushover

  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입됨 플래그와 함께 integration_api_inheritance라는 이름으로. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반적으로 사용 가능. 기능 플래그 integration_api_inheritance가 제거되었습니다.

Pushover 설정하기

프로젝트에 대한 Pushover 통합을 설정합니다.

PUT /projects/:id/integrations/pushover

매개변수:

매개변수 유형 필수 설명
api_key string 예 응용 프로그램 키입니다.
user_key string 예 사용자 키입니다.
priority string 예 우선 순위입니다.
device string 아니오 모든 활성 장치에 대해 비워 둡니다.
sound string 아니오 알림 소리입니다.
use_inherited_settings boolean 아니오 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

Pushover 비활성화

프로젝트에 대한 Pushover 통합을 비활성화합니다. 통합 설정이 재설정됩니다.

DELETE /projects/:id/integrations/pushover

Pushover 설정 가져오기

프로젝트에 대한 Pushover 통합 설정을 가져옵니다.

GET /projects/:id/integrations/pushover

Redmine

  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입됨 플래그와 함께 integration_api_inheritance라는 이름으로. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반적으로 사용 가능. 기능 플래그 integration_api_inheritance가 제거되었습니다.

Redmine 설정하기

프로젝트에 대한 Redmine 통합을 설정합니다.

PUT /projects/:id/integrations/redmine

매개변수:

매개변수 유형 필수 설명
new_issue_url string 예 새 이슈의 URL입니다.
project_url string 예 프로젝트의 URL입니다.
issues_url string 예 이슈의 URL입니다.
use_inherited_settings boolean 아니오 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

Redmine 비활성화

프로젝트에 대한 Redmine 통합을 비활성화합니다. 통합 설정이 재설정됩니다.

DELETE /projects/:id/integrations/redmine

Redmine 설정 가져오기

프로젝트에 대한 Redmine 통합 설정을 가져옵니다.

GET /projects/:id/integrations/redmine

Slack 알림

  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입됨 플래그와 함께 integration_api_inheritance라는 이름으로. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반적으로 사용 가능. 기능 플래그 integration_api_inheritance가 제거되었습니다.

슬랙 알림 설정

프로젝트에 대한 슬랙 알림을 설정합니다.

PUT /projects/:id/integrations/slack

매개변수:

매개변수 유형 필수 설명
webhook 문자열 예 슬랙 알림 웹후크(예: https://hooks.slack.com/services/...).
username 문자열 아니오 슬랙 알림 사용자 이름.
channel 문자열 아니오 다른 채널이 구성되지 않은 경우 사용할 기본 채널.
notify_only_broken_pipelines 부울 아니오 파손된 파이프라인에 대한 알림을 전송합니다.
notify_only_default_branch 부울 아니오 사용 중단: 이 매개변수는 branches_to_be_notified로 대체되었습니다.
branches_to_be_notified 문자열 아니오 알림을 전송할 브랜치입니다. 유효한 옵션은 all, default, protected, 및 default_and_protected입니다. 기본값은 default입니다.
labels_to_be_notified 문자열 아니오 알림을 전송할 레이블입니다. 모든 이벤트에 대한 알림을 받으려면 공백으로 두십시오.
labels_to_be_notified_behavior 문자열 아니오 알림을 받을 레이블입니다. 유효한 옵션은 match_any 및 match_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_page_events 부울 아니오 위키 페이지 이벤트에 대한 알림을 활성화합니다.
use_inherited_settings 부울 아니오 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

슬랙 알림 비활성화

프로젝트에 대한 슬랙 알림을 비활성화합니다. 통합 설정이 초기화됩니다.

DELETE /projects/:id/integrations/slack

슬랙 알림 설정 가져오기

프로젝트에 대한 슬랙 알림 설정을 가져옵니다.

GET /projects/:id/integrations/slack

슬랙 슬래시 명령

  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입됨 플래그와 함께 integration_api_inheritance라는 이름으로 사용됩니다. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반적으로 사용 가능합니다. 기능 플래그 integration_api_inheritance가 제거되었습니다.

슬랙 슬래시 명령 설정

프로젝트에 대한 슬랙 슬래시 명령을 설정합니다.

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

매개변수:

매개변수 유형 필수 설명
token string yes 슬랙 토큰.
use_inherited_settings boolean no 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

슬랙 슬래시 명령 비활성화

프로젝트에 대한 슬랙 슬래시 명령을 비활성화합니다. 통합 설정이 초기화됩니다.

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

슬랙 슬래시 명령 설정 가져오기

프로젝트에 대한 슬랙 슬래시 명령 설정을 가져옵니다.

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

예제 응답:

{
  "id": 4,
  "title": "슬랙 슬래시 명령",
  "slug": "slack-slash-commands",
  "created_at": "2017-06-27T05:51:39-07:00",
  "updated_at": "2017-06-27T05:51:39-07:00",
  "active": true,
  "push_events": true,
  "issues_events": true,
  "confidential_issues_events": true,
  "merge_requests_events": true,
  "tag_push_events": true,
  "note_events": true,
  "job_events": true,
  "pipeline_events": true,
  "comment_on_event_enabled": false,
  "inherited": false,
  "properties": {
    "token": "<your_access_token>"
  }
}

스쿼시 TM

  • GitLab 15.10에서 도입됨.
  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입됨 플래그와 함께 integration_api_inheritance라는 이름으로 사용됩니다. 기본적으로 비활성화되어 있습니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반적으로 사용 가능합니다. 기능 플래그 integration_api_inheritance가 제거되었습니다.

스쿼시 TM 설정

프로젝트에 대한 스쿼시 TM 통합 설정을 설정합니다.

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

매개변수:

매개변수 유형 필수 설명
url string yes 스쿼시 TM 웹훅의 URL.
token string no 비밀 토큰.
use_inherited_settings boolean no 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

Squash TM 비활성화

프로젝트의 Squash TM 통합을 비활성화합니다. 통합 설정은 유지됩니다.

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

Squash TM 설정 가져오기

프로젝트의 Squash TM 통합 설정을 가져옵니다.

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

텔레그램

텔레그램 설정하기

프로젝트의 텔레그램 통합을 설정합니다.

PUT /projects/:id/integrations/telegram

매개변수:

매개변수 유형 필수 설명
hostname string no 텔레그램 API의 사용자 정의 호스트 이름 (도입됨 GitLab 17.1에서). 기본값은 https://api.telegram.org입니다.
token string yes 텔레그램 봇 토큰 (예: 123456:ABC-DEF1234ghIkl-zyx57W2v1u123ew11).
room string yes 대상 채팅에 대한 고유 식별자 또는 대상 채널의 사용자 이름 (형식 @channelusername으로).
thread integer no 대상 메시지 스레드에 대한 고유 식별자 (포럼 슈퍼그룹에서의 주제). 도입됨 GitLab 16.11에서.
notify_only_broken_pipelines boolean no 오류가 발생한 파이프라인에 대한 알림을 보냅니다.
branches_to_be_notified string no 알림을 보낼 브랜치 (도입됨 GitLab 16.5에서). 유효한 옵션은 all, default, protected, default_and_protected입니다. 기본값은 default입니다.
push_events boolean yes 푸시 이벤트에 대한 알림을 활성화합니다.
issues_events boolean yes 이슈 이벤트에 대한 알림을 활성화합니다.
confidential_issues_events boolean yes 기밀 이슈 이벤트에 대한 알림을 활성화합니다.
merge_requests_events boolean yes 병합 요청 이벤트에 대한 알림을 활성화합니다.
tag_push_events boolean yes 태그 푸시 이벤트에 대한 알림을 활성화합니다.
note_events boolean yes 노트 이벤트에 대한 알림을 활성화합니다.
confidential_note_events boolean yes 기밀 노트 이벤트에 대한 알림을 활성화합니다.
pipeline_events boolean yes 파이프라인 이벤트에 대한 알림을 활성화합니다.
wiki_page_events boolean yes 위키 페이지 이벤트에 대한 알림을 활성화합니다.
use_inherited_settings boolean no 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

텔레그램 비활성화

프로젝트의 텔레그램 통합을 비활성화합니다. 통합 설정은 초기화됩니다.

DELETE /projects/:id/integrations/telegram

텔레그램 설정 가져오기

프로젝트의 텔레그램 통합 설정을 가져옵니다.

GET /projects/:id/integrations/telegram

유니파이 회로

  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입되었으며, integration_api_inheritance라는 플래그와 함께 제공됩니다. 기본적으로 비활성화됩니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반 제공됩니다. 기능 플래그 integration_api_inheritance가 제거되었습니다.

유니파이 회로 설정하기

프로젝트를 위한 유니파이 회로 통합을 설정합니다.

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

매개변수:

매개변수 유형 필수 설명
webhook 문자열 예 유니파이 회로 웹후크 (예: https://circuit.com/rest/v2/webhooks/incoming/...).
notify_only_broken_pipelines 부울 아니오 깨진 파이프라인에 대한 알림을 보냅니다.
branches_to_be_notified 문자열 아니오 알림을 보낼 브랜치. 유효한 옵션은 all, default, protected, 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 부울 아니오 위키 페이지 이벤트에 대한 알림을 활성화합니다.
use_inherited_settings 부울 아니오 기본 설정을 상속할 것인지 여부를 나타냅니다. 기본값은 false입니다.

유니파이 회로 비활성화

프로젝트의 유니파이 회로 통합을 비활성화합니다. 통합 설정이 재설정됩니다.

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

유니파이 회로 설정 가져오기

프로젝트의 유니파이 회로 통합 설정을 가져옵니다.

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

웨벡스 팀

  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입되었으며, integration_api_inheritance라는 플래그와 함께 제공됩니다. 기본적으로 비활성화됩니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반 제공됩니다. 기능 플래그 integration_api_inheritance가 제거되었습니다.

웨벡스 팀 설정하기

프로젝트를 위한 웨벡스 팀을 설정합니다.

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

매개변수:

매개변수 유형 필수 설명
webhook 문자열 예 웨벡스 팀 웹후크 (예: https://api.ciscospark.com/v1/webhooks/incoming/...).
notify_only_broken_pipelines 부울 아니오 깨진 파이프라인에 대한 알림을 보냅니다.
branches_to_be_notified 문자열 아니오 알림을 보낼 브랜치. 유효한 옵션은 all, default, protected, 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 부울 아니오 위키 페이지 이벤트에 대한 알림을 활성화합니다.
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

  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입되었습니다 integration_api_inheritance라는 플래그와 함께. 기본값으로 비활성화됨.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반적으로 사용 가능합니다. 기능 플래그 integration_api_inheritance가 제거되었습니다.

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