이 API를 사용하여 Git 커밋을 관리합니다.

응답#

이 API 응답의 일부 날짜 필드는 중복된 정보이거나 중복된 정보처럼 보일 수 있습니다.

• created_at 필드는 다른 GitLab API와의 일관성을 위해서만 존재합니다. 이 필드는 항상 committed_date 필드와 동일합니다.
• committed_date 필드와 authored_date 필드는 서로 다른 소스에서 생성되므로 동일하지 않을 수 있습니다.

페이지네이션 응답 헤더#

성능상의 이유로 GitLab은 Commits API 응답에서 다음 헤더를 반환하지 않습니다.

• x-total
• x-total-pages

자세한 내용은 이슈 389582를 참고합니다.

리포지터리 커밋 목록 조회#

히스토리

• GitLab 18.10에서 follow가 도입되었습니다.

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

GET /projects/:id/repository/commits

성공하면 200 OK와 다음 응답 속성을 반환합니다.

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

응답 예시:

[
  {
    "id": "ed899a2f4b50b4370feeea94676502b42383c746",
    "short_id": "ed899a2f4b5",
    "title": "Replace sanitize with escape once",
    "author_name": "Example User",
    "author_email": "user@example.com",
    "authored_date": "2021-09-20T11:50:22.001+00:00",
    "committer_name": "Administrator",
    "committer_email": "admin@example.com",
    "committed_date": "2021-09-20T11:50:22.001+00:00",
    "created_at": "2021-09-20T11:50:22.001+00:00",
    "message": "Replace sanitize with escape once",
    "parent_ids": [
      "6104942438c14ec7bd21c6cd5bd995272b3faff6"
    ],
    "web_url": "https://gitlab.example.com/janedoe/gitlab-foss/-/commit/ed899a2f4b50b4370feeea94676502b42383c746",
    "trailers": {},
    "extended_trailers": {}
  },
  {
    "id": "6104942438c14ec7bd21c6cd5bd995272b3faff6",
    "short_id": "6104942438c",
    "title": "Sanitize for network graph",
    "author_name": "randx",
    "author_email": "user@example.com",
    "committer_name": "ExampleName",
    "committer_email": "user@example.com",
    "created_at": "2021-09-20T09:06:12.201+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>"
      ]
    }
  }
]

커밋 생성#

히스토리

• GitLab 18.8에서 allow_empty가 도입되었습니다.
• GitLab 18.7에서 요청 크기 및 속도 제한이 도입되었습니다.

JSON 페이로드를 게시하여 커밋을 생성합니다.

POST /projects/:id/repository/commits

각주:

1. force가 true이면 다른 부모 커밋을 지정하기 위해 start_branch 또는 start_sha를 제공합니다. 둘 다 제공하지 않으면 start_branch는 branch 값으로 기본 설정되고, 새 커밋은 현재 브랜치 팁을 기반으로 생성됩니다. 이 경우 결과가 일반 커밋과 동일하므로 force는 효과가 없습니다.

성공하면 201 Created와 다음 응답 속성을 반환합니다.

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은 폼 인코딩을 지원합니다. 다음은 폼 인코딩으로 Commit 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>" \
     --url "https://gitlab.example.com/api/v4/projects/1/repository/commits"

커밋 조회#

커밋 해시 또는 브랜치·태그 이름으로 지정한 커밋을 조회합니다.

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

파라미터:

성공하면 200 OK와 다음 응답 속성을 반환합니다.

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"
}

커밋이 푸시된 모든 참조 목록 조회#

히스토리

• GitLab 19.4에서 CI/CD job 토큰 인증이 도입되었습니다.

커밋이 푸시된 모든 참조(브랜치 또는 태그)를 나열합니다. 페이지네이션 파라미터 page와 per_page를 사용하여 참조 목록을 제한할 수 있습니다.

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

파라미터:

성공하면 200 OK와 다음 응답 속성을 반환합니다.

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

파라미터:

성공하면 200 OK와 다음 응답 속성을 반환합니다.

요청 예시:

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

파라미터:

성공하면 201 Created와 다음 응답 속성을 반환합니다.

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": "Sorry, we cannot cherry-pick this commit automatically. This commit may already have been cherry-picked, or a more recent commit may have updated some of its content.",
  "error_code": "empty"
}

이 경우 변경 세트가 비어 있어 cherry-pick 이 실패했으며, 이는 해당 커밋이 이미 대상 브랜치에 존재함을 뜻할 가능성이 큽니다. 그 밖에 나올 수 있는 오류 코드는 conflict이며, 이는 머지 충돌이 발생했음을 나타냅니다.

dry_run을 활성화하면 서버는 cherry-pick 적용을 시도하지만 그 결과로 생기는 변경 사항을 실제로 커밋하지는 않습니다. cherry-pick 이 문제없이 적용되면 API는 200 OK로 응답합니다.

{
  "dry_run": "success"
}

실패한 경우에는 dry run 없이 실패했을 때와 동일한 오류가 표시됩니다.

커밋 Revert#

지정한 브랜치에서 커밋을 revert 합니다.

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

파라미터:

성공하면 201 Created와 다음 응답 속성을 반환합니다.

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"
}

revert가 실패하면 응답에 실패 원인에 대한 컨텍스트가 포함됩니다.

{
  "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"
}

이 경우 시도한 revert가 머지 충돌을 일으켜 revert가 실패했습니다. 그 밖에 나올 수 있는 오류 코드는 empty이며, 이는 변경 세트가 비어 있음을 뜻합니다. 대개 해당 변경이 이미 revert 되었기 때문입니다.

dry_run을 활성화하면 서버는 revert 적용을 시도하지만 그 결과로 생기는 변경 사항을 실제로 커밋하지는 않습니다. revert가 문제없이 적용되면 API는 200 OK로 응답합니다.

{
  "dry_run": "success"
}

실패한 경우에는 dry run 없이 실패했을 때와 동일한 오류가 표시됩니다.

커밋 diff 조회#

히스토리

• GitLab 18.4에서 collapsed와 too_large 응답 속성이 도입되었습니다.

프로젝트에서 커밋의 diff를 조회합니다.

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

파라미터:

성공하면 200 OK와 다음 응답 속성을 반환합니다.

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",
    "collapsed": false,
    "too_large": false,
    "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

파라미터:

성공하면 200 OK와 다음 응답 속성을 반환합니다.

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 의 머지 리퀘스트 diff 에 새 스레드 생성 문서를 참고합니다.

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

성공하면 201 Created와 다음 응답 속성을 반환합니다.

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

파라미터:

성공하면 200 OK와 다음 응답 속성을 반환합니다.

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 입니다.

커밋 상태 목록 조회#

히스토리

• GitLab 17.9에서 pipeline_id, order_by, sort 필드가 도입되었습니다.

프로젝트 내 커밋의 상태를 나열합니다. 페이지네이션 파라미터 page와 per_page를 사용하여 참조 목록을 제한할 수 있습니다.

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

성공하면 200 OK와 다음 응답 속성을 반환합니다.

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
  }
  ...
]

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

external stage의 job으로 표현되는 커밋의 상태를 추가하거나 업데이트합니다. 커밋이 머지 리퀘스트와 연결되어 있으면 머지 리퀘스트 소스 브랜치의 커밋을 타깃으로 지정합니다.

커밋 상태를 설정하면 다음과 같이 처리됩니다.

• 먼저 기존 파이프라인을 검색해 job을 추가합니다.
• 적합한 파이프라인이 없으면 CI_PIPELINE_SOURCE: external로 새 파이프라인이 생성됩니다.

자세한 내용은 외부 커밋 상태를 참고합니다.

파이프라인이 이미 존재하고 단일 파이프라인의 최대 job 수 제한을 초과하는 경우는 다음과 같습니다.

• pipeline_id를 지정하면 422 오류를 반환합니다: The number of jobs has exceeded the limit.
• 지정하지 않으면 새 파이프라인이 생성됩니다.

SHA/ref 조합에 대한 업데이트가 이미 진행 중이면 409 오류를 반환합니다. 이 오류가 발생하면 요청을 재시도합니다.

POST /projects/:id/statuses/:sha

성공 시 201 Created와 다음 응답 속성을 반환합니다.

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"
}

커밋과 연결된 머지 리퀘스트 목록 조회#

히스토리

• GitLab 18.2에서 state 속성이 도입되었습니다.

특정 커밋을 처음 도입한 머지 리퀘스트에 대한 정보를 반환합니다.

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

성공 시 200 OK와 다음 응답 속성을 반환합니다.

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/projects/5/repository/commits/af5b13261899fb2c0db30abdd0af8b07cb44fdc5/merge_requests?state=opened"

응답 예시:

[
  {
    "id": 45,
    "iid": 1,
    "project_id": 35,
    "title": "Add new file",
    "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

파라미터:

성공 시 200 OK와 다음 응답 속성을 반환합니다.

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"
}