통합 API

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

이 API를 사용하면 GitLab과 통합되는 외부 서비스와 작업할 수 있습니다.

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

모든 활성 통합 목록

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

  • 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 문자열 예 사용자 API 토큰입니다. 사용자는 작업에 액세스해야 합니다. 모든 코멘트는이 사용자에게 속합니다.
restrict_to_branch 문자열 아니요 자동으로 검사할 브랜치의 쉼표로 구분된 목록입니다. 모든 브랜치를 포함하려면 비워 두세요.
use_inherited_settings 부울 아니요 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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 yes Bamboo 루트 URL(예: https://bamboo.example.com)입니다.
enable_ssl_verification boolean no SSL 검증을 활성화합니다. 기본값은 true(활성화)입니다.
build_key string yes Bamboo 빌드 계획 키(예: KEY)입니다.
username string yes Bamboo 서버의 API 액세스를 갖는 사용자입니다.
password string yes 사용자의 비밀번호입니다.
use_inherited_settings boolean no 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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 yes 새 이슈의 URL입니다.
issues_url string yes 이슈의 URL입니다.
project_url string yes 프로젝트의 URL입니다.
use_inherited_settings boolean no 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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 string yes Buildkite 프로젝트 GitLab 토큰입니다.
project_url string yes 파이프라인 URL(예: https://buildkite.com/example/pipeline)입니다.
enable_ssl_verification boolean no 사용 중단됨: 이 매개변수는 SSL 검증이 항상 활성화되어 있기 때문에 효력이 없습니다.
push_events boolean no push 이벤트에 대한 알림을 활성화합니다.
merge_requests_events boolean no merge request 이벤트에 대한 알림을 활성화합니다.
tag_push_events boolean no 태그 push 이벤트에 대한 알림을 활성화합니다.
use_inherited_settings boolean no 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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은 Basecamp에서 더 이상 판매되지 않는 오래된 제품입니다.

Campfire Classic 설정하기

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

PUT /projects/:id/integrations/campfire

파라미터:

파라미터 타입 필수 여부 설명
token string 예 Campfire Classic의 API 인증 토큰입니다. 토큰을 얻으려면 Campfire Classic에 서명한 후 내 정보를 선택하십시오.
subdomain string 아니요 로그인한 경우 .campfirenow.com 서브도메인입니다.
room string 아니요 Campfire Classic 룸 URL의 ID 부분입니다.
use_inherited_settings boolean 아니요 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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 string 예 이슈의 URL입니다.
project_url string 예 프로젝트의 URL입니다.
use_inherited_settings boolean 아니요 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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 string 예 atlassian.net에 호스팅된 Confluence Workspace의 URL입니다.
use_inherited_settings boolean 아니요 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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 string 예 새 이슈의 URL입니다.
issues_url string 예 이슈의 URL입니다.
project_url string 예 프로젝트의 URL입니다.
use_inherited_settings boolean 아니요 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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 문자열 아니오 Datadog에서 이 GitLab 인스턴스의 모든 데이터에 태그를 지정합니다. 여러 자체 관리형 배포를 관리할 때 사용할 수 있습니다.
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에서 플래그integration_api_inheritance와 함께 도입되었습니다.
  • 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 Notifications

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

Discord Notifications 설정

프로젝트용 Discord Notifications을 설정합니다. 

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에서 도입되었으며 integration_api_inheritance이란 플래그가 있었습니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반적으로 사용 가능하며 피처 플래그 integration_api_inheritance이 제거되었습니다.

Drone 설정

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

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

매개변수:

매개변수 유형 필수 설명
token string 예 드론(Drone) CI 프로젝트별 토큰입니다.
drone_url string 예 http://drone.example.com입니다.
enable_ssl_verification boolean 아니요 SSL 검증을 활성화합니다. 기본값은 true (활성화됨)입니다.
push_events boolean 아니요 푸시 이벤트에 대한 알림을 활성화합니다.
merge_requests_events boolean 아니요 머지 요청 이벤트에 대한 알림을 활성화합니다.
tag_push_events boolean 아니요 태그 푸시 이벤트에 대한 알림을 활성화합니다.
use_inherited_settings boolean 아니요 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

Drone 비활성화

프로젝트에 대한 드론(Drone) 통합을 비활성화합니다. 통합 설정이 초기화됩니다. 

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

드론(Drone) 설정 가져오기

프로젝트에 대한 드론(Drone) 통합 설정을 가져옵니다. 

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

푸시 이메일

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

푸시 이메일 설정

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

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

매개변수:

매개변수 유형 필수 설명
recipients string 예 공백으로 구분된 이메일입니다.
disable_diffs boolean 아니요 코드 차이를 비활성화합니다.
send_from_committer_email boolean 아니요 커미터로부터 전송합니다.
push_events boolean 아니요 푸시 이벤트에 대한 알림을 활성화합니다.
tag_push_events boolean 아니요 태그 푸시 이벤트에 대한 알림을 활성화합니다.
branches_to_be_notified string 아니요 알림을 보낼 브랜치입니다. 유효한 옵션은 all, default, protected, default_and_protected입니다. 항상 태그 푸시에 대해 알림이 전달됩니다. 기본값은 all입니다.
use_inherited_settings boolean 아니요 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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 string 예 새 이슈의 URL입니다.
project_url string 예 프로젝트의 URL입니다.
issues_url string 예 이슈의 URL입니다.
use_inherited_settings boolean 아니요 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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 string 예 외부 위키의 URL입니다.
use_inherited_settings boolean 아니요 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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에서는 비활성화됩니다.
  • GitLab 17.2에서 integration_api_inheritance이라는 플래그로 use_inherited_settings 매개변수가 도입되었습니다. 기본적으로 비활성화됩니다.
  • GitLab 17.3에서 integration_api_inheritance 플래그가 제거되고 use_inherited_settings 매개변수가 일반적으로 사용 가능해졌습니다.
Self-managed GitLab에서는 기본적으로 이 기능이 사용 가능합니다. 피처 플래그로 숨기려면 관리자에게 git_guardian_integration이라는 플래그를 비활성화할 것을 요청하십시오. GitLab.com에서는 이 기능을 사용할 수 없습니다. GitLab Dedicated에서는 이 기능을 사용할 수 있습니다.

GitGuardian은 API 키와 비밀번호와 같은 민감한 데이터를 감지하는 사이버 보안 서비스입니다. Git 저장소를 스캔하여 정책 위반에 대한 경고를 보내고, 해커들이 그것을 악용하기 전에 조직이 보안 문제를 해결하는 데 도움을 줍니다.

GitGuardian 정책에 따라 커밋을 거부하도록 GitLab을 설정할 수 있습니다.

알려진 문제

  • 푸시가 지연되거나 시간 초과될 수 있습니다. GitGuardian 통합을 통해 푸시가 제3자에게 전송되며 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
  • GitLab 17.2에서 integration_api_inheritance이라는 플래그로 use_inherited_settings 매개변수가 도입되었습니다. 기본적으로 비활성화됩니다.
  • GitLab 17.3에서 integration_api_inheritance 플래그가 제거되고 use_inherited_settings 매개변수가 일반적으로 사용 가능해졌습니다.

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

Jira 클라우드용 GitLab 앱

  • GitLab 17.2에서 enable_jira_connect_configuration이라는 플래그로 소개되었습니다. 기본적으로 비활성화됩니다.

Jira 클라우드용 GitLab 앱 통합은 Jira에서 그룹 연결 및 연결 해제를 통해 자동으로 활성화 또는 비활성화됩니다. GitLab 통합 폼이나 API를 사용하여 통합을 활성화하거나 비활성화할 수 없습니다.

프로젝트용 통합 업데이트

Jira에서 그룹 연결을 사용하여 생성한 통합을 업데이트하는 데 이 API 엔드포인트를 사용합니다. 

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

매개변수:

매개변수 유형 필수 여부 설명
jira_cloud_app_service_ids string 아니요 Jira 서비스 관리 서비스 ID입니다. 여러 ID를 구분하려면 콤마(,)로 구분합니다.
jira_cloud_app_enable_deployment_gating boolean 아니요 Jira 서비스 관리에서 GitLab 배포를 차단하는 기능을 활성화합니다.
jira_cloud_app_deployment_gating_environments string 아니요 배포 차단이 활성화될 환경(production, staging, testing, 또는 development)입니다. 배포 차단이 활성화된 경우 필요합니다. 여러 환경을 구분하려면 콤마(,)로 구분합니다.

GitLab for Jira Cloud 앱 설정 가져오기

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

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

GitLab for Slack 앱

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

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 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 관리

Tier: Free, Premium, Ultimate Offering: GitLab.com Status: Beta
  • GitLab 16.9에서 베타 기능으로 소개되었으며, google_cloud_support_feature_flag라는 플래그로 기본적으로 비활성화됩니다.
  • GitLab 17.1에서는 GitLab.com에서 활성화되었습니다. 기능 플래그 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 관리 설정

프로젝트의 Google Artifact 관리 통합 설정을 가져옵니다. 

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

Google Artifact 관리 설정

프로젝트용 Google Artifact 관리 통합을 설정합니다. 

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

매개변수:

매개변수명 타입 필수여부 설명
artifact_registry_project_id string yes Google Cloud 프로젝트 ID
artifact_registry_location string yes Artifact Registry 저장소 위치
artifact_registry_repositories string yes Artifact Registry 저장소

종속 설정을 상속할지 여부를 나타내는 use_inherited_settings 매개변수가 있으며 기본값은 false입니다.

Google Artifact 관리 비활성화

프로젝트의 Google Artifact 관리 통합을 비활성화합니다. 통합 설정이 재설정됩니다. 

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

Google Artifact 관리 설정 가져오기

프로젝트의 Google Artifact 관리 통합 설정을 가져옵니다. 

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
  • GitLab 16.10에서 베타 기능으로 소개되었으며, google_cloud_support_feature_flag라는 플래그로 기본적으로 비활성화됩니다.
  • GitLab 17.1에서는 GitLab.com에서 활성화되었습니다. 기능 플래그 google_cloud_support_feature_flag가 제거되었습니다.
  • use_inherited_settings 매개변수는 GitLab 17.2에서 도입되었으며, integration_api_inheritance이라는 플래그로 기본적으로 비활성화됩니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반적으로 사용 가능해졌습니다. 기능 플래그 integration_api_inheritance가 제거되었습니다.

이 기능은 베타 상태입니다.

Google Cloud Identity and Access Management 설정

프로젝트의 Google Cloud Identity and Access Management 통합 설정을 가져옵니다. 

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

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 yes Workload Identity Federation용 Google Cloud 프로젝트 ID
workload_identity_federation_project_number integer yes Workload Identity Federation용 Google Cloud 프로젝트 번호
workload_identity_pool_id string yes Workload Identity Pool의 ID
workload_identity_pool_provider_id string yes Workload Identity Pool 제공자의 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

  • 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 string yes Google Play의 앱 패키지 이름
service_account_key string yes Google Play 서비스 계정 키
service_account_key_file_name string yes Google Play 서비스 계정의 파일 이름
google_play_protected_refs boolean no 보호된 브랜치 및 태그에만 변수 설정
use_inherited_settings boolean no 종속 설정을 상속할지 여부를 나타내며, 기본값은 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에서 소개되었습니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반적으로 사용 가능해졌습니다. integration_api_inheritance 기능 플래그가 제거되었습니다.

Harbor 설정

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

PUT /projects/:id/integrations/harbor

매개변수:

매개변수 유형 필수 설명
url string yes GitLab 프로젝트에 연결된 Harbor 인스턴스의 기본 URL입니다. 예: https://demo.goharbor.io
project_name string yes Harbor 인스턴스의 프로젝트 이름입니다. 예: testproject
username string yes Harbor 인터페이스에서 생성된 사용자 이름입니다.
password string yes 사용자의 암호입니다.
use_inherited_settings boolean no 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

Harbor 비활성화

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

DELETE /projects/:id/integrations/harbor

Harbor 설정 가져오기

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

GET /projects/:id/integrations/harbor

irker (IRC 게이트웨이)

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

irker 설정

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

PUT /projects/:id/integrations/irker

매개변수:

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

irker 비활성화

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

DELETE /projects/:id/integrations/irker

irker 설정 가져오기

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

GET /projects/:id/integrations/irker

Jenkins

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

Jenkins 설정

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

PUT /projects/:id/integrations/jenkins

매개변수:

매개변수 유형 필수 설명
jenkins_url string yes http://jenkins.example.com과 같은 Jenkins URL입니다.
enable_ssl_verification boolean no SSL 검증 활성화 여부입니다. 기본값은 true입니다.
project_name string yes URL 친화적인 프로젝트 이름입니다. 예: my_project_name
username string no 서버에서 인증이 필요한 경우 Jenkins 서버와의 인증에 사용되는 사용자 이름입니다.
password string no 서버에서 인증이 필요한 경우 Jenkins 서버와의 인증에 사용되는 암호입니다.
push_events boolean no push 이벤트에 대한 알림 활성화 여부입니다.
merge_requests_events boolean no merge request 이벤트에 대한 알림 활성화 여부입니다.
tag_push_events boolean no tag push 이벤트에 대한 알림 활성화 여부입니다.
use_inherited_settings boolean no 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

Jenkins 비활성화

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

DELETE /projects/:id/integrations/jenkins

Jenkins 설정 가져오기

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

GET /projects/:id/integrations/jenkins

JetBrains TeamCity

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

JetBrains TeamCity 설정

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

TeamCity에서 빌드 구성은 빌드 번호 형식 %build.vcs.number%를 사용해야 합니다. VCS 루트의 고급 설정에서 모든 브랜치의 모니터링을 구성하여 merge 요청을 빌드할 수 있습니다. 

PUT /projects/:id/integrations/teamcity

매개변수:

매개변수 유형 필수 설명
teamcity_url string yes TeamCity 루트 URL (예: https://teamcity.example.com)
enable_ssl_verification boolean no SSL 검증 활성화 여부입니다. 기본값은 true입니다.
build_type string yes 빌드 구성 ID입니다.
username string yes 수동 빌드를 트리거할 권한이 있는 사용자입니다.
password string yes 사용자의 암호입니다.
push_events boolean no push 이벤트에 대한 알림 활성화 여부입니다.
merge_requests_events boolean no merge request 이벤트에 대한 알림 활성화 여부입니다.
use_inherited_settings boolean no 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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 Serve의 경우 비밀번호를 사용하세요. 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 17.0에서 소개되었습니다. Jira 이슈를 GitLab에서 보도록 활성화합니다.
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입니다.

Matrix 통지 비활성화

프로젝트의 Matrix 통지를 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/matrix

Matrix 통지 설정 가져오기

프로젝트의 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 yes Mattermost 통지 웹훅(예: http://mattermost.example.com/hooks/...).
username string no Mattermost 통지 사용자명.
channel string no 다른 채널이 구성되지 않은 경우 사용할 기본 채널입니다.
notify_only_broken_pipelines boolean no 깨진 파이프라인에 대한 통지를 전송합니다.
notify_only_default_branch boolean no 사용되지 않음: 이 매개변수는 branches_to_be_notified로 대체되었습니다.
branches_to_be_notified string no 통지를 전송할 브랜치입니다. all, default, protected, default_and_protected 중에서 선택할 수 있습니다. 기본값은 default입니다.
labels_to_be_notified string no 통지를 받을 레이블입니다. 모든 이벤트에 대해 통지를 받으려면 비워두십시오.
labels_to_be_notified_behavior string no 통지할 레이블입니다. match_any와 match_all 중에서 선택할 수 있습니다. 기본값은 match_any입니다.
push_events boolean no 푸시 이벤트에 대한 통지를 활성화합니다.
issues_events boolean no 이슈 이벤트에 대한 통지를 활성화합니다.
confidential_issues_events boolean no 기밀 이슈 이벤트에 대한 통지를 활성화합니다.
merge_requests_events boolean no 병합 요청 이벤트에 대한 통지를 활성화합니다.
tag_push_events boolean no 태그 푸시 이벤트에 대한 통지를 활성화합니다.
note_events boolean no 노트 이벤트에 대한 통지를 활성화합니다.
confidential_note_events boolean no 기밀 노트 이벤트에 대한 통지를 활성화합니다.
pipeline_events boolean no 파이프라인 이벤트에 대한 통지를 활성화합니다.
wiki_page_events boolean no 위키 페이지 이벤트에 대한 통지를 활성화합니다.
push_channel string no 푸시 이벤트에 대한 통지를 받을 채널입니다.
issue_channel string no 이슈 이벤트에 대한 통지를 받을 채널입니다.
confidential_issue_channel string no 기밀 이슈 이벤트에 대한 통지를 받을 채널입니다.
merge_request_channel string no 병합 요청 이벤트에 대한 통지를 받을 채널입니다.
note_channel string no 노트 이벤트에 대한 통지를 받을 채널입니다.
confidential_note_channel string no 기밀 노트 이벤트에 대한 통지를 받을 채널입니다.
tag_push_channel string no 태그 푸시 이벤트에 대한 통지를 받을 채널입니다.
pipeline_channel string no 파이프라인 이벤트에 대한 통지를 받을 채널입니다.
wiki_page_channel string no 위키 페이지 이벤트에 대한 통지를 받을 채널입니다.
use_inherited_settings boolean no 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

Mattermost 통지 비활성화

프로젝트의 Mattermost 통지를 비활성화합니다. 통합 설정이 재설정됩니다. 

DELETE /projects/:id/integrations/mattermost

Mattermost 통지 설정 가져오기

프로젝트의 Mattermost 통지 설정을 가져옵니다. 

GET /projects/:id/integrations/mattermost

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-slash-commands

매개변수:

매개변수 유형 필수 설명
토큰 string yes Mattermost 토큰.
use_inherited_settings boolean no 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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에서 도입되었으며 기본적으로 비활성화된 integration_api_inheritance 플래그와 함께 도입되었습니다.
  • use_inherited_settings 매개변수는 GitLab 17.3에서 일반적으로 사용 가능하며 integration_api_inheritance 플래그가 제거되었습니다. 
### Microsoft Teams 알림 설정

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

```plaintext
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 string 예 Mock CI 통합의 URL입니다.
enable_ssl_verification boolean 아니요 SSL 검증을 활성화합니다. 기본적으로 true(활성화됨)입니다.
use_inherited_settings boolean 아니요 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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 string 예 Packagist 계정의 사용자 이름입니다.
token string 예 Packagist 서버로의 API 토큰입니다.
server boolean 아니요 Packagist 서버의 URL입니다. 기본값은 <https://packagist.org>를 사용하지 않음을 의미합니다.
push_events boolean 아니요 푸시 이벤트에 대한 알림을 활성화합니다.
merge_requests_events boolean 아니요 병합 요청 이벤트에 대한 알림을 활성화합니다.
tag_push_events boolean 아니요 태그 푸시 이벤트에 대한 알림을 활성화합니다.
use_inherited_settings boolean 아니요 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 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 parameter은 기본적으로 비활성화되어 있습니다. GitLab 17.2에서 도입되었으며 integration_api_inheritance이라는 플래그와 함께 제공됩니다.
  • use_inherited_settings parameter은 GitLab 17.3에서 일반적으로 사용 가능하게 되었습니다. 기능 플래그 integration_api_inheritance이 제거되었습니다.

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

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

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

매개변수:

매개변수 유형 필수 설명
recipients 문자열 예 수신자 이메일 주소의 쉼표로 구분된 목록입니다.
notify_only_broken_pipelines 부울 아니요 깨진 파이프라인에 대한 알림을 보냅니다.
branches_to_be_notified 문자열 아니요 알림을 보낼 브랜치입니다. 유효한 옵션은 all, default, protected, 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

  • use_inherited_settings parameter은 기본적으로 비활성화되어 있습니다. GitLab 17.2에서 도입되었으며 integration_api_inheritance이라는 플래그와 함께 제공됩니다.
  • use_inherited_settings parameter은 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 parameter은 기본적으로 비활성화되어 있습니다. GitLab 17.2에서 도입되었으며 integration_api_inheritance이라는 플래그와 함께 제공됩니다.
  • use_inherited_settings parameter은 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 parameter은 기본적으로 비활성화되어 있습니다. GitLab 17.2에서 도입되었으며 integration_api_inheritance이라는 플래그와 함께 제공됩니다.
  • use_inherited_settings parameter은 GitLab 17.3에서 일반적으로 사용 가능하게 되었습니다. 기능 플래그 integration_api_inheritance이 제거되었습니다.

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

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

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 알림

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

Slack 알림 설정

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

PUT /projects/:id/integrations/slack

매개변수:

매개변수 유형 필수 설명
webhook 문자열 예 Slack 알림 웹훅입니다 (예: https://hooks.slack.com/services/...).
username 문자열 아니요 Slack 알림의 사용자명입니다.
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입니다.

Slack 알림 비활성화

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

DELETE /projects/:id/integrations/slack

Slack 알림 설정 가져오기

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

GET /projects/:id/integrations/slack

Slack 슬래시 명령어

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

Slack 슬래시 명령어 설정

프로젝트의 Slack 슬래시 명령어를 설정합니다. 

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

매개변수:

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

Slack 슬래시 명령어 비활성화

프로젝트의 Slack 슬래시 명령어를 비활성화합니다. 통합 설정이 초기화됩니다. 

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

Slack 슬래시 명령어 설정 가져오기

프로젝트의 Slack 슬래시 명령어 설정을 가져옵니다. 

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

예시 응답: 

{
  "id": 4,
  "title": "Slack 슬래시 명령어",
  "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>"
  }
}

Squash TM

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

Squash TM 설정

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

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

매개변수:

매개변수 타입 필수 여부 설명
url string yes Squash 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

Telegram

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

Telegram 설정

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

PUT /projects/:id/integrations/telegram

매개변수:

매개변수 타입 필수 여부 설명
hostname string no Telegram API의 사용자 정의 호스트명 (GitLab 17.1에서 도입). 기본값은 https://api.telegram.org입니다.
token string yes Telegram 봇 토큰 (예: 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 push 이벤트에 대한 알림을 활성화합니다.
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 string 예 통일된 회로 웹훅(예: https://circuit.com/rest/v2/webhooks/incoming/...).
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/unify-circuit

통일된 회로 설정 가져오기

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

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

Webex Teams

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

Webex Teams 설정

프로젝트에 Webex Teams를 설정합니다. 

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

매개변수:

매개변수 유형 필수 설명
webhook string 예 Webex Teams 웹훅(예: https://api.ciscospark.com/v1/webhooks/incoming/...).
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입니다.

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 string 예 이슈의 URL입니다.
project_url string 예 프로젝트의 URL입니다.
use_inherited_settings boolean 아니요 기본 설정을 상속할지 여부를 나타냅니다. 기본값은 false입니다.

YouTrack 비활성화

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

DELETE /projects/:id/integrations/youtrack

YouTrack 설정 가져오기

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

GET /projects/:id/integrations/youtrack