커밋 API

Tier: Free, Premium, Ultimate Offering: GitLab.com, 자체 관리, GitLab Dedicated

이 API는 리포지토리 커밋에 대해 작동합니다. 커밋에 대한 GitLab 특정 정보를 자세히 읽어보세요.

응답

이 API로부터의 응답 중 일부 날짜 필드는 중복된 정보인 듯 하거나 실제로 중복된 정보일 수 있습니다.

  • created_at 필드는 다른 GitLab API와 일관성을 유지하기 위해 존재합니다. 항상 committed_date 필드와 동일합니다.
  • committed_date 및 authored_date 필드는 서로 다른 소스에서 생성되었으며 동일하지 않을 수 있습니다.

리포지토리 커밋 목록

프로젝트 내의 리포지토리 커밋 목록을 가져옵니다. 

GET /projects/:id/repository/commits
속성 유형 필수 여부 설명
id 정수/문자열 예 프로젝트의 ID 또는 URL-인코딩된 경로
ref_name 문자열 아니오 리포지토리 브랜치, 태그 또는 리비전 범위의 이름 또는 지정하지 않은 경우 기본 브랜치
since 문자열 아니오 이 날짜 이후 또는 이 날짜와 같은 날짜까지의 커밋만 ISO 8601 형식인 YYYY-MM-DDTHH:MM:SSZ로 반환
until 문자열 아니오 이 날짜 이전 또는 이 날짜와 같은 날짜까지의 커밋만 ISO 8601 형식인 YYYY-MM-DDTHH:MM:SSZ로 반환
path 문자열 아니오 파일 경로
author 문자열 아니오 커밋 저자로 커밋 검색.
all 부울 아니오 리포지토리에서 모든 커밋을 검색
with_stats 부울 아니오 각 커밋에 대한 통계를 응답에 추가
first_parent 부울 아니오 병합 커밋을 만날 때 첫 번째 부모 커밋만 따름
order 문자열 아니오 커밋 목록의 순서. 가능한 값: default, topo. 기본값은 default이며 커밋은 시간 역순으로 표시됩니다.
trailers 부울 아니오 모든 커밋에 대한 Git 트레일러를 구문 분석 및 포함합니다. 
curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits"

예시 응답: 

[
  {
    "id": "ed899a2f4b50b4370feeea94676502b42383c746",
    "short_id": "ed899a2f4b5",
    "title": "Sanitize for network graph",
    "author_name": "randx",
    "author_email": "user@example.com",
    "authored_date": "2021-09-20T11:50:22.001+00:00",
    "committer_name": "ExampleName",
    "committer_email": "user@example.com",
    "committed_date": "2021-09-20T11:50:22.001+00:00",
    "created_at": "2021-09-20T11:50:22.001+00:00",
    "message": "Sanitize for network graph\nCc: John Doe <johndoe@gitlab.com>\nCc: Jane Doe <janedoe@gitlab.com>",
    "parent_ids": [
      "ae1d9fb46aa2b07ee9836d49862ec4e2c46fbbba"
    ],
    "web_url": "https://gitlab.example.com/janedoe/gitlab-foss/-/commit/ed899a2f4b50b4370feeea94676502b42383c746",
    "trailers": { "Cc": "Jane Doe <janedoe@gitlab.com>" },
    "extended_trailers": { "Cc": ["John Doe <johndoe@gitlab.com>", "Jane Doe <janedoe@gitlab.com>"] }
  }
]

여러 파일 및 동작이 있는 커밋 생성

JSON 페이로드를 게시하여 커밋 만들기 

POST /projects/:id/repository/commits
속성 유형 필수 여부 설명
id 정수/문자열 예 프로젝트의 ID 또는 URL-인코딩된 경로
branch 문자열 예 커밋할 브랜치 이름. 새로운 브랜치를 만들려면 start_branch 또는 start_sha 및 선택적으로 start_project도 제공해야 합니다.
commit_message 문자열 예 커밋 메시지
start_branch 문자열 아니오 새 브랜치를 시작할 브랜치의 이름
start_sha 문자열 아니오 새 브랜치를 시작할 커밋의 SHA
start_project 정수/문자열 아니오 새 브랜치를 시작하는 프로젝트 ID 또는 URL-인코딩된 경로. 기본값은 id의 값입니다.
actions[] 배열 예 일괄적으로 커밋할 동작 해시의 배열입니다. 사용 가능한 속성은 다음 테이블을 참조하세요.
author_email 문자열 아니오 커밋 저자의 이메일 주소 지정
author_name 문자열 아니오 커밋 저자의 이름 지정
stats 부울 아니오 커밋 통계 포함. 기본값은 true입니다.
force 부울 아니오 true일 때 목표 브랜치를 start_branch 또는 start_sha를 기반으로 새 커밋으로 덮어쓰기합니다.
actions[] 속성 유형 필수 여부 설명
action 문자열 예 수행할 동작: create, delete, move, update, 또는 chmod
file_path 문자열 예 파일의 전체 경로. 예: lib/class.rb
previous_path 문자열 아니오 이동된 파일의 원래 전체 경로. 예: lib/class1.rb. move 동작에만 해당됨.
content 문자열 아니오 파일 내용. delete, chmod 및 move를 제외한 모든 동작에 필요합니다. content를 지정하지 않은 이동 동작은 기존 파일 내용을 보존하며, content의 다른 값은 파일 내용을 덮어씁니다.
encoding 문자열 아니오 text 또는 base64. 기본값은 text입니다.
last_commit_id 문자열 아니오 마지막으로 알려진 파일 커밋 ID. 업데이트, 이동 및 삭제 동작에서만 고려됩니다.
execute_filemode 부울 아니오 true/false일 때 파일의 실행 플래그를 활성화/비활성화합니다. chmod 동작에만 해당됨. 
PAYLOAD=$(cat << 'JSON'
{
  "branch": "main",
  "commit_message": "some commit message",
  "actions": [
    {
      "action": "create",
      "file_path": "foo/bar",
      "content": "some content"
    },
    {
      "action": "delete",
      "file_path": "foo/bar2"
    },
    {
      "action": "move",
      "file_path": "foo/bar3",
      "previous_path": "foo/bar4",
      "content": "some content"
    },
    {
      "action": "update",
      "file_path": "foo/bar5",
      "content": "new content"
    },
    {
      "action": "chmod",
      "file_path": "foo/bar5",
      "execute_filemode": true
    }
  ]
}
JSON
)
curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --header "Content-Type: application/json" \
  --data "$PAYLOAD" \
  --url "https://gitlab.example.com/api/v4/projects/1/repository/commits"

예시 응답: 

{
  "id": "ed899a2f4b50b4370feeea94676502b42383c746",
  "short_id": "ed899a2f4b5",
  "title": "some commit message",
  "author_name": "Example User",
  "author_email": "user@example.com",
  "committer_name": "Example User",
  "committer_email": "user@example.com",
  "created_at": "2016-09-20T09:26:24.000-07:00",
  "message": "some commit message",
  "parent_ids": [
    "ae1d9fb46aa2b07ee9836d49862ec4e2c46fbbba"
  ],
  "committed_date": "2016-09-20T09:26:24.000-07:00",
  "authored_date": "2016-09-20T09:26:24.000-07:00",
  "stats": {
    "additions": 2,
    "deletions": 2,
    "total": 4
  },
  "status": null,
  "web_url": "https://gitlab.example.com/janedoe/gitlab-foss/-/commit/ed899a2f4b50b4370feeea94676502b42383c746"
}

GitLab는 폼 인코딩을 지원합니다. 커밋 API를 폼 인코딩하여 사용하는 다음 예시입니다: 

curl --request POST \
     --form "branch=main" \
     --form "commit_message=some commit message" \
     --form "start_branch=main" \
     --form "actions[][action]=create" \
     --form "actions[][file_path]=foo/bar" \
     --form "actions[][content]=</path/to/local.file" \
     --form "actions[][action]=delete" \
     --form "actions[][file_path]=foo/bar2" \
     --form "actions[][action]=move" \
     --form "actions[][file_path]=foo/bar3" \
     --form "actions[][previous_path]=foo/bar4" \
     --form "actions[][content]=</path/to/local1.file" \
     --form "actions[][action]=update" \
     --form "actions[][file_path]=foo/bar5" \
     --form "actions[][content]=</path/to/local2.file" \
     --form "actions[][action]=chmod" \
     --form "actions[][file_path]=foo/bar5" \
     --form "actions[][execute_filemode]=true" \
     --header "PRIVATE-TOKEN: <your_access_token>" \
     "https://gitlab.example.com/api/v4/projects/1/repository/commits"

단일 커밋 가져오기

커밋 해시 또는 브랜치 또는 태그의 이름으로 식별된 특정 커밋을 가져옵니다. 

GET /projects/:id/repository/commits/:sha

매개변수:

속성 유형 필수 설명
id integer/string 예 프로젝트의 ID 또는 URL 인코딩 된 경로
sha string 예 커밋 해시 또는 리포지토리 브랜치 또는 태그의 이름
stats boolean 아니요 커밋 통계를 포함합니다. 기본값은 true입니다. 
curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits/main"

예시 응답: 

{
  "id": "6104942438c14ec7bd21c6cd5bd995272b3faff6",
  "short_id": "6104942438c",
  "title": "Sanitize for network graph",
  "author_name": "randx",
  "author_email": "user@example.com",
  "committer_name": "Dmitriy",
  "committer_email": "user@example.com",
  "created_at": "2021-09-20T09:06:12.300+03:00",
  "message": "Sanitize for network graph",
  "committed_date": "2021-09-20T09:06:12.300+03:00",
  "authored_date": "2021-09-20T09:06:12.420+03:00",
  "parent_ids": [
    "ae1d9fb46aa2b07ee9836d49862ec4e2c46fbbba"
  ],
  "last_pipeline" : {
    "id": 8,
    "ref": "main",
    "sha": "2dc6aa325a317eda67812f05600bdf0fcdc70ab0",
    "status": "created"
  },
  "stats": {
    "additions": 15,
    "deletions": 10,
    "total": 25
  },
  "status": "running",
  "web_url": "https://gitlab.example.com/janedoe/gitlab-foss/-/commit/6104942438c14ec7bd21c6cd5bd995272b3faff6"
}

커밋이 푸시된 참조 가져오기

커밋이 푸시된 모든 참조(브랜치 또는 태그)를 가져옵니다. 페이지네이션 매개변수 page 및 per_page를 사용하여 참조 목록을 제한할 수 있습니다. 

GET /projects/:id/repository/commits/:sha/refs

매개변수:

속성 유형 필수 설명
id integer/string 예 프로젝트의 ID 또는 URL 인코딩 된 경로
sha string 예 커밋 해시
type string 아니요 커밋의 범위입니다. 가능한 값은 branch, tag, all입니다. 기본값은 all입니다. 
curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits/5937ac0a7beb003549fc5fd26fc247adbce4a52e/refs?type=all"

예시 응답: 

[
  {"type": "branch", "name": "'test'"},
  {"type": "branch", "name": "add-balsamiq-file"},
  {"type": "branch", "name": "wip"},
  {"type": "tag", "name": "v1.1.0"}
 ]

커밋의 순서 가져오기

주어진 커밋에서 부모 링크를 따라 프로젝트의 커밋 순서 번호를 가져옵니다.

이 API는 주어진 커밋 SHA에 대한 git rev-list --count 명령과 근본적으로 동일한 기능을 제공합니다. 

GET /projects/:id/repository/commits/:sha/sequence

매개변수:

속성 유형 필수 설명
id integer/string 예 프로젝트의 ID 또는 URL 인코딩 된 경로.
sha string 예 커밋 해시.
first_parent boolean 아니요 병합 커밋을 보면 첫 번째 부모 커밋만 따릅니다.

예시 요청: 

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits/5937ac0a7beb003549fc5fd26fc247adbce4a52e/sequence"

예시 응답: 

{
  "count": 632
}

커밋을 Cherry-pick하기

지정된 브랜치에 커밋을 Cherry-pick합니다. 

POST /projects/:id/repository/commits/:sha/cherry_pick

매개변수:

속성 유형 필수 설명
id integer/string 예 프로젝트의 ID 또는 URL 인코딩 된 경로
sha string 예 커밋 해시
branch string 예 브랜치의 이름
dry_run boolean 아니요 어떠한 변경 사항도 커밋하지 않습니다. 기본값은 false입니다.
message string 아니요 새로운 커밋에 사용할 사용자 정의 커밋 메시지 
curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --form "branch=main" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits/main/cherry_pick"

예시 응답: 

{
  "id": "8b090c1b79a14f2bd9e8a738f717824ff53aebad",
  "short_id": "8b090c1b",
  "author_name": "Example User",
  "author_email": "user@example.com",
  "authored_date": "2016-12-12T20:10:39.000+01:00",
  "created_at": "2016-12-12T20:10:39.000+01:00",
  "committer_name": "Administrator",
  "committer_email": "admin@example.com",
  "committed_date": "2016-12-12T20:10:39.000+01:00",
  "title": "Feature added",
  "message": "Feature added\n\nSigned-off-by: Example User <user@example.com>\n",
  "parent_ids": [
    "a738f717824ff53aebad8b090c1b79a14f2bd9e8"
  ],
  "web_url": "https://gitlab.example.com/janedoe/gitlab-foss/-/commit/8b090c1b79a14f2bd9e8a738f717824ff53aebad"
}

Cherry-pick에 실패한 경우, 응답은 다음과 같이 실패에 대한 컨텍스트를 제공합니다: 

{
  "message": "죄송합니다,이 커밋을 자동으로 Cherry-pick할 수 없습니다.이 커밋은 이미 Cherry-pick되었을 수 있으며 더 최근에 일부 콘텐츠가 업데이트되었을 수 있습니다.",
  "error_code": "empty"
}

이 경우, 변경 세트가 비어 있고 해당 커밋이 대상 브랜치에 이미 존재한다는 것을 나타내므로 Cherry-pick에 실패했습니다. 다른 가능한 오류 코드는 병합 충돌이 있음을 나타내는 conflict입니다.

dry_run이 활성화된 경우, 서버는 Cherry-pick을 적용하려고 시도하지만 실제로 결과 변경을 커밋하지는 않습니다. Cherry-pick이 깨끗하게 적용되면 API가 200 OK로 응답합니다: 

{
  "dry_run": "success"
}

실패한 경우, 드라이 런없이 실패와 동일한 오류가 표시됩니다.

커밋 되돌리기

지정된 브랜치에서 커밋을 되돌립니다. 

POST /projects/:id/repository/commits/:sha/revert

매개변수:

속성 타입 필수 설명
id integer/string yes 프로젝트의 ID 또는 URL 인코딩된 경로
sha string yes 되돌릴 커밋 SHA
branch string yes 대상 브랜치 이름
dry_run boolean no 변경 사항을 커밋하지 않음. 기본값은 false입니다. 
curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --form "branch=main" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits/a738f717824ff53aebad8b090c1b79a14f2bd9e8/revert"

응답 예시: 

{
  "id":"8b090c1b79a14f2bd9e8a738f717824ff53aebad",
  "short_id": "8b090c1b",
  "title":"Revert \"Feature added\"",
  "created_at":"2018-11-08T15:55:26.000Z",
  "parent_ids":["a738f717824ff53aebad8b090c1b79a14f2bd9e8"],
  "message":"Revert \"Feature added\"\n\nThis reverts commit a738f717824ff53aebad8b090c1b79a14f2bd9e8",
  "author_name":"Administrator",
  "author_email":"admin@example.com",
  "authored_date":"2018-11-08T15:55:26.000Z",
  "committer_name":"Administrator",
  "committer_email":"admin@example.com",
  "committed_date":"2018-11-08T15:55:26.000Z",
  "web_url": "https://gitlab.example.com/janedoe/gitlab-foss/-/commit/8b090c1b79a14f2bd9e8a738f717824ff53aebad"
}

되돌리기에 실패한 경우, 응답에서 왜 실패했는지에 대한 컨텍스트를 제공합니다: 

{
  "message": "Sorry, we cannot revert this commit automatically. This commit may already have been reverted, or a more recent commit may have updated some of its content.",
  "error_code": "conflict"
}

이 경우, 되돌리기가 실패한 이유는 시도된 되돌리기가 병합 충돌을 생성했기 때문입니다. 다른 가능한 오류 코드는 empty로, 이는 변경 내용이 이미 되돌려져서 변화가 없었을 가능성이 높습니다.

dry_run이 활성화되면 서버는 되돌리기를 적용하되 실제로 결과 변경 사항을 커밋하지는 않습니다. 되돌리기가 깔끔하게 적용되면 API는 200 OK로 응답합니다: 

{
  "dry_run": "success"
}

실패한 경우, 실패의 경우와 동일한 오류가 표시됩니다. ## 커밋의 차이점 가져오기

프로젝트에서 커밋의 차이점을 가져옵니다. 

GET /projects/:id/repository/commits/:sha/diff

매개변수:

속성 타입 필수 설명
id integer/string yes 프로젝트의 ID 또는 URL 인코딩된 경로
sha string yes 리포지토리 브랜치 또는 태그의 커밋 해시 또는 이름
unidiff boolean no 통합된 차이 형식으로 diffs 표시. 기본값은 false입니다. GitLab 16.5에도입되었습니다. 
curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits/main/diff"

응답 예시: 

[
  {
    "diff": "@@ -71,6 +71,8 @@\n sudo -u git -H bundle exec rake migrate_keys RAILS_ENV=production\n sudo -u git -H bundle exec rake migrate_inline_notes RAILS_ENV=production\n \n+sudo -u git -H bundle exec rake gitlab:assets:compile RAILS_ENV=production\n+\n ```\n \n ### 6. Update config files",
    "new_path": "doc/update/5.4-to-6.0.md",
    "old_path": "doc/update/5.4-to-6.0.md",
    "a_mode": null,
    "b_mode": "100644",
    "new_file": false,
    "renamed_file": false,
    "deleted_file": false
  }
]

커밋의 코멘트 가져오기

프로젝트의 커밋 코멘트를 가져옵니다. 

GET /projects/:id/repository/commits/:sha/comments

매개변수:

속성 타입 필수 설명
id integer/string yes 프로젝트의 ID 또는 URL 인코딩된 경로
sha string yes 리포지토리 브랜치 또는 태그의 커밋 해시 또는 이름 
curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits/main/comments"

응답 예시: 

[
  {
    "note": "this code is really nice",
    "author": {
      "id": 11,
      "username": "admin",
      "email": "admin@local.host",
      "name": "Administrator",
      "state": "active",
      "created_at": "2014-03-06T08:17:35.000Z"
    }
  }
]

커밋에 댓글 작성

커밋에 댓글을 추가합니다.

특정 파일의 특정 라인에 댓글을 작성하려면 전체 커밋 SHA, path, line, line_type이 new여야합니다.

다음 경우 중 하나 이상이 유효한 경우 최소한 하나의 경우에 댓글은 마지막 커밋에 추가됩니다. - sha가 대신 브랜치 또는 태그이고 line 또는 path가 유효하지 않은 경우 - line 번호가 유효하지 않은 경우 (존재하지 않음) - path가 유효하지 않은 경우 (존재하지 않음)

위의 경우 중 하나라도 해당되는 경우, line, line_type, path의 응답은 null로 설정됩니다.

병합 요청에 댓글을 다는 다른 방법에 대해서는 Notes API에서 새로운 병합 요청 노트 만들기 및 Discussions API에서 병합 요청 차이에서 새로운 스레드 만들기을 참조하세요. 

POST /projects/:id/repository/commits/:sha/comments
속성 유형 필수 설명
id integer/string 예 프로젝트의 ID 또는 URL 인코딩된 경로
sha string 예 커밋 SHA 또는 저장소 브랜치 또는 태그 이름
note string 예 댓글의 내용
path string 아니오 저장소에 상대적인 파일 경로
line integer 아니오 댓글을 달 라인 번호
line_type string 아니오 라인 유형. new 또는 old를 인수로 취함 
curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --form "note=Nice picture\!" \
  --form "path=README.md" \
  --form "line=11" \
  --form "line_type=new" \
  --url "https://gitlab.example.com/api/v4/projects/17/repository/commits/18f3e63d05582537db6d183d9d557be09e1f90c8/comments"

예시 응답: 

{
   "author" : {
      "web_url" : "https://gitlab.example.com/janedoe",
      "avatar_url" : "https://gitlab.example.com/uploads/user/avatar/28/jane-doe-400-400.png",
      "username" : "janedoe",
      "state" : "active",
      "name" : "Jane Doe",
      "id" : 28
   },
   "created_at" : "2016-01-19T09:44:55.600Z",
   "line_type" : "new",
   "path" : "README.md",
   "line" : 11,
   "note" : "Nice picture!"
}

커밋의 토론 가져오기

프로젝트의 커밋에 대한 토론을 가져옵니다. 

GET /projects/:id/repository/commits/:sha/discussions

매개변수:

속성 유형 필수 설명
id integer/string 예 프로젝트의 ID 또는 URL 인코딩된 경로
sha string 예 커밋 해시 또는 저장소 브랜치 또는 태그 이름 
curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits/4604744a1c64de00ff62e1e8a6766919923d2b41/discussions"

예시 응답: 

[
  {
    "id": "4604744a1c64de00ff62e1e8a6766919923d2b41",
    "individual_note": true,
    "notes": [
      {
        "id": 334686748,
        "type": null,
        "body": "Nice piece of code!",
        "attachment": null,
        "author" : {
          "id" : 28,
          "name" : "Jane Doe",
          "username" : "janedoe",
          "web_url" : "https://gitlab.example.com/janedoe",
          "state" : "active",
          "avatar_url" : "https://gitlab.example.com/uploads/user/avatar/28/jane-doe-400-400.png"
        },
        "created_at": "2020-04-30T18:48:11.432Z",
        "updated_at": "2020-04-30T18:48:11.432Z",
        "system": false,
        "noteable_id": null,
        "noteable_type": "Commit",
        "resolvable": false,
        "confidential": null,
        "noteable_iid": null,
        "commands_changes": {}
      }
    ]
  }
]

커밋 상태

GitLab의 커밋 상태 API.

커밋의 상태 목록

프로젝트의 커밋 상태 목록을 나열합니다. 페이지네이션 매개변수 page와 per_page는 참조 목록을 제한하는 데 사용될 수 있습니다. 

GET /projects/:id/repository/commits/:sha/statuses
속성 유형 필수 설명
id integer/string 예 프로젝트의 ID 또는 URL 인코딩된 경로
sha string 예 커밋 SHA
ref string 아니오 저장소 브랜치 또는 태그의 이름 또는 주어지지 않으면 기본 브랜치
stage string 아니오 빌드 단계별로 필터링, 예를 들어 test
name string 아니오 작업 이름별로 필터링, 예를 들어 bundler:audit
all boolean 아니오 최신 것뿐만 아니라 모든 상태를 반환 
curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/17/repository/commits/18f3e63d05582537db6d183d9d557be09e1f90c8/statuses"

예시 응답: 

[
   ...

   {
      "status" : "pending",
      "created_at" : "2016-01-19T08:40:25.934Z",
      "started_at" : null,
      "name" : "bundler:audit",
      "allow_failure" : true,
      "author" : {
         "username" : "janedoe",
         "state" : "active",
         "web_url" : "https://gitlab.example.com/janedoe",
         "avatar_url" : "https://gitlab.example.com/uploads/user/avatar/28/jane-doe-400-400.png",
         "id" : 28,
         "name" : "Jane Doe"
      },
      "description" : null,
      "sha" : "18f3e63d05582537db6d183d9d557be09e1f90c8",
      "target_url" : "https://gitlab.example.com/janedoe/gitlab-foss/builds/91",
      "finished_at" : null,
      "id" : 91,
      "ref" : "main"
   },
   {
      "started_at" : null,
      "name" : "test",
      "allow_failure" : false,
      "status" : "pending",
      "created_at" : "2016-01-19T08:40:25.832Z",
      "target_url" : "https://gitlab.example.com/janedoe/gitlab-foss/builds/90",
      "id" : 90,
      "finished_at" : null,
      "ref" : "main",
      "sha" : "18f3e63d05582537db6d183d9d557be09e1f90c8",
      "author" : {
         "id" : 28,
         "name" : "Jane Doe",
         "username" : "janedoe",
         "web_url" : "https://gitlab.example.com/janedoe",
         "state" : "active",
         "avatar_url" : "https://gitlab.example.com/uploads/user/avatar/28/jane-doe-400-400.png"
      },
      "description" : null
   },

   ...
]

커밋의 파이프라인 상태 설정

커밋의 파이프라인 상태를 추가하거나 업데이트합니다. 커밋이 병합 요청과 관련되는 경우, API 호출은 병합 요청의 소스 브랜치에 대상을 지정해야 합니다. 

POST /projects/:id/statuses/:sha
속성 타입 필수 설명
id integer/string 예 프로젝트의 ID 또는 URL-인코딩된 경로
sha string 예 커밋 SHA
state string 예 상태. 다음 중 하나일 수 있습니다: pending, running, success, failed, canceled
ref string 아니요 상태가 참조하는 ref (브랜치 또는 태그)
name 또는 context string 아니요 다른 시스템의 상태와 구분하기 위한 라벨. 기본값은 default
target_url string 아니요 이 상태와 관련된 대상 URL
description string 아니요 상태의 간단한 설명
coverage float 아니요 전체 코드 커버리지
pipeline_id integer 아니요 상태를 설정할 파이프라인의 ID. 동일한 SHA에 대해 여러 파이프라인이 있는 경우 사용합니다. 
curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/17/statuses/18f3e63d05582537db6d183d9d557be09e1f90c8?state=success"

예시 응답: 

{
   "author" : {
      "web_url" : "https://gitlab.example.com/janedoe",
      "name" : "Jane Doe",
      "avatar_url" : "https://gitlab.example.com/uploads/user/avatar/28/jane-doe-400-400.png",
      "username" : "janedoe",
      "state" : "active",
      "id" : 28
   },
   "name" : "default",
   "sha" : "18f3e63d05582537db6d183d9d557be09e1f90c8",
   "status" : "success",
   "coverage": 100.0,
   "description" : null,
   "id" : 93,
   "target_url" : null,
   "ref" : null,
   "started_at" : null,
   "created_at" : "2016-01-19T09:05:50.355Z",
   "allow_failure" : false,
   "finished_at" : "2016-01-19T09:05:50.365Z"
}

커밋과 관련된 병합 요청 목록

특정 커밋을 처음 소개한 병합 요청에 대한 정보를 반환합니다. 

GET /projects/:id/repository/commits/:sha/merge_requests
속성 타입 필수 설명
id integer/string 예 프로젝트의 ID 또는 URL-인코딩된 경로
sha string 예 커밋 SHA 
curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits/af5b13261899fb2c0db30abdd0af8b07cb44fdc5/merge_requests"

예시 응답: 

[
   {
      "id":45,
      "iid":1,
      "project_id":35,
      "title":"새 파일 추가",
      "description":"",
      "state":"opened",
      "created_at":"2018-03-26T17:26:30.916Z",
      "updated_at":"2018-03-26T17:26:30.916Z",
      "target_branch":"main",
      "source_branch":"test-branch",
      "upvotes":0,
      "downvotes":0,
      "author" : {
        "web_url" : "https://gitlab.example.com/janedoe",
        "name" : "Jane Doe",
        "avatar_url" : "https://gitlab.example.com/uploads/user/avatar/28/jane-doe-400-400.png",
        "username" : "janedoe",
        "state" : "active",
        "id" : 28
      },
      "assignee":null,
      "source_project_id":35,
      "target_project_id":35,
      "labels":[ ],
      "draft":false,
      "work_in_progress":false,
      "milestone":null,
      "merge_when_pipeline_succeeds":false,
      "merge_status":"can_be_merged",
      "sha":"af5b13261899fb2c0db30abdd0af8b07cb44fdc5",
      "merge_commit_sha":null,
      "squash_commit_sha":null,
      "user_notes_count":0,
      "discussion_locked":null,
      "should_remove_source_branch":null,
      "force_remove_source_branch":false,
      "web_url":"https://gitlab.example.com/root/test-project/merge_requests/1",
      "time_stats":{
         "time_estimate":0,
         "total_time_spent":0,
         "human_time_estimate":null,
         "human_total_time_spent":null
      }
   }
]

커밋의 서명 얻기

서명되었을 경우 커밋의 서명을 가져옵니다. 미서명 커밋의 경우 404 응답이 발생합니다. 

GET /projects/:id/repository/commits/:sha/signature

파라미터:

속성 타입 필수 설명
id integer/string 예 프로젝트의 ID 또는 URL-인코딩된 경로
sha string 예 커밋 해시 또는 리포지토리 브랜치 또는 태그의 이름 
curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/1/repository/commits/da738facbc19eb2fc2cef57c49be0e6038570352/signature"

커밋이 GPG로 서명된 경우 예시 응답: 

{
  "signature_type": "PGP",
  "verification_status": "verified",
  "gpg_key_id": 1,
  "gpg_key_primary_keyid": "8254AAB3FBD54AC9",
  "gpg_key_user_name": "John Doe",
  "gpg_key_user_email": "johndoe@example.com",
  "gpg_key_subkey_id": null,
  "commit_source": "gitaly"
}

커밋이 SSH로 서명된 경우 예시 응답: 

{
  "signature_type": "SSH",
  "verification_status": "verified",
  "key": {
    "id": 11,
    "title": "Key",
    "created_at": "2023-05-08T09:12:38.503Z",
    "expires_at": "2024-05-07T00:00:00.000Z",
    "key": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAILZzYDq6DhLp3aX84DGIV3F6Vf+Ae4yCTTz7RnqMJOlR MyKey)",
    "usage_type": "auth_and_signing"
  },
  "commit_source": "gitaly"
}

커밋이 X.509로 서명된 경우 예시 응답: 

{
  "signature_type": "X509",
  "verification_status": "unverified",
  "x509_certificate": {
    "id": 1,
    "subject": "CN=gitlab@example.org,OU=Example,O=World",
    "subject_key_identifier": "BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC:BC",
    "email": "gitlab@example.org",
    "serial_number": 278969561018901340486471282831158785578,
    "certificate_status": "good",
    "x509_issuer": {
      "id": 1,
      "subject": "CN=PKI,OU=Example,O=World",
      "subject_key_identifier": "AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB:AB",
      "crl_url": "http://example.com/pki.crl"
    }
  },
  "commit_source": "gitaly"
}

커밋이 서명되지 않은 경우 예시 응답: 

{
  "message": "404 GPG Signature Not Found"
}