모든 배포 키 목록
배포 키 추가
프로젝트에 대한 배포 키 목록
사용자에 대한 프로젝트 배포 키 목록
단일 배포 키 가져오기
프로젝트에 배포 키 추가
배포 키 업데이트
배포 키 삭제
배포 키 활성화
여러 프로젝트에 배포 키 추가

배포 키 API

Tier: Free, Premium, Ultimate

Offering: GitLab.com, Self-managed, GitLab Dedicated

배포 키 API는 다음 필드에서 공개 키의 지문(fingerprints)을 포함한 응답을 반환할 수 있습니다:

fingerprint (MD5 해시). FIPS-enabled 시스템에서는 사용할 수 없습니다.
fingerprint_sha256 (SHA256 해시). 도입됨 GitLab 15.2에서.

모든 배포 키 목록

Tier: Free, Premium, Ultimate

Offering: Self-managed, GitLab Dedicated

projects_with_readonly_access 도입됨 GitLab 16.0에서.

모든 GitLab 인스턴스 프로젝트의 모든 배포 키 목록을 가져옵니다. 이 엔드포인트는 관리자 액세스를 필요로 하며 GitLab.com에서는 사용할 수 없습니다.

GET /deploy_keys

지원되는 속성:

속성	유형	필수	설명
`public`	boolean	아니요	공개 배포 키만 반환합니다. 기본값은 `false`입니다.

예시 요청:

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/deploy_keys?public=true"

예시 응답:

[
  {
    "id": 1,
    "title": "공개 키",
    "key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDNJAkI3Wdf0r13c8a5pEExB2YowPWCSVzfZV22pNBc1CuEbyYLHpUyaD0GwpGvFdx2aP7lMEk35k6Rz3ccBF6jRaVJyhsn5VNnW92PMpBJ/P1UebhXwsFHdQf5rTt082cSxWuk61kGWRQtk4ozt/J2DF/dIUVaLvc+z4HomT41fQ==",
    "fingerprint": "4a:9d:64:15:ed:3a:e6:07:6e:89:36:b3:3b:03:05:d9",
    "fingerprint_sha256": "SHA256:Jrs3LD1Ji30xNLtTVf9NDCj7kkBgPBb2pjvTZ3HfIgU",
    "created_at": "2013-10-02T10:12:29Z",
    "expires_at": null,
    "projects_with_write_access": [
      {
        "id": 73,
        "description": null,
        "name": "project2",
        "name_with_namespace": "Sidney Jones / project2",
        "path": "project2",
        "path_with_namespace": "sidney_jones/project2",
        "created_at": "2021-10-25T18:33:17.550Z"
      },
      {
        "id": 74,
        "description": null,
        "name": "project3",
        "name_with_namespace": "Sidney Jones / project3",
        "path": "project3",
        "path_with_namespace": "sidney_jones/project3",
        "created_at": "2021-10-25T18:33:17.666Z"
      }
    ],
    "projects_with_readonly_access": []
  },
  {
    "id": 3,
    "title": "또 다른 공개 키",
    "key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDIJFwIL6YNcCgVBLTHgM6hzmoL5vf0ThDKQMWT3HrwCjUCGPwR63vBwn6+/Gx+kx+VTo9FuojzR0O4XfwD3LrYA+oT3ETbn9U4e/VS4AH/G4SDMzgSLwu0YuPe517FfGWhWGQhjiXphkaQ+6bXPmcASWb0RCO5+pYlGIfxv4eFGQ=="
    "fingerprint": "0b:cf:58:40:b9:23:96:c7:ba:44:df:0e:9e:87:5e:75",
    "fingerprint_sha256": "SHA256:lGI/Ys/Wx7PfMhUO1iuBH92JQKYN+3mhJZvWO4Q5ims",
    "created_at": "2013-10-02T11:12:29Z",
    "expires_at": null,
    "projects_with_write_access": [],
    "projects_with_readonly_access": [
      {
        "id": 74,
        "description": null,
        "name": "project3",
        "name_with_namespace": "Sidney Jones / project3",
        "path": "project3",
        "path_with_namespace": "sidney_jones/project3",
        "created_at": "2021-10-25T18:33:17.666Z"
      }
    ]
  }
]

배포 키 추가

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

도입됨 GitLab 17.5 버전에서.

GitLab 인스턴스에 배포 키를 생성합니다. 이 엔드포인트는 관리자 접근이 필요합니다.

POST /deploy_keys

지원되는 속성:

속성	유형	필수	설명
`key`	string	예	새로운 배포 키
`title`	string	예	새로운 배포 키의 제목
`expires_at`	datetime	아니요	배포 키의 만료 날짜. 값이 제공되지 않으면 만료되지 않습니다. ISO 8601 형식으로 예상됩니다 (`2024-12-31T08:00:00Z`)

예제 요청:

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" --header "Content-Type: application/json" \  
     --data '{"title": "My deploy key", "key": "ssh-rsa AAAA...", "expired_at": "2024-12-31T08:00:00Z"}' \  
     "https://gitlab.example.com/api/v4/deploy_keys/"  

예제 응답:

{  
  "id" : 5,  
  "title" : "My deploy key",  
  "key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDNJAkI3Wdf0r13c8a5pEExB2YowPWCSVzfZV22pNBc1CuEbyYLHpUyaD0GwpGvFdx2aP7lMEk35k6Rz3ccBF6jRaVJyhsn5VNnW92PMpBJ/P1UebhXwsFHdQf5rTt082cSxWuk61kGWRQtk4ozt/J2DF/dIUVaLvc+z4HomT41fQ==",  
  "fingerprint": "4a:9d:64:15:ed:3a:e6:07:6e:89:36:b3:3b:03:05:d9",  
  "fingerprint_sha256": "SHA256:Jrs3LD1Ji30xNLtTVf9NDCj7kkBgPBb2pjvTZ3HfIgU",  
  "usage_type": "auth_and_signing",  
  "created_at": "2024-10-03T01:32:21.992Z",  
  "expires_at": "2024-12-31T08:00:00.000Z"  
}  

프로젝트에 대한 배포 키 목록

프로젝트의 배포 키 목록을 가져옵니다.

GET /projects/:id/deploy_keys

속성	유형	필수	설명
`id`	정수/문자열	예	프로젝트의 ID 또는 URL 인코딩 경로

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

예제 응답:

[  
  {  
    "id": 1,  
    "title": "공용 키",  
    "key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDNJAkI3Wdf0r13c8a5pEExB2YowPWCSVzfZV22pNBc1CuEbyYLHpUyaD0GwpGvFdx2aP7lMEk35k6Rz3ccBF6jRaVJyhsn5VNnW92PMpBJ/P1UebhXwsFHdQf5rTt082cSxWuk61kGWRQtk4ozt/J2DF/dIUVaLvc+z4HomT41fQ==",  
    "fingerprint": "4a:9d:64:15:ed:3a:e6:07:6e:89:36:b3:3b:03:05:d9",  
    "fingerprint_sha256": "SHA256:Jrs3LD1Ji30xNLtTVf9NDCj7kkBgPBb2pjvTZ3HfIgU",  
    "created_at": "2013-10-02T10:12:29Z",  
    "expires_at": null,  
    "can_push": false  
  },  
  {  
    "id": 3,  
    "title": "다른 공용 키",  
    "key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDIJFwIL6YNcCgVBLTHgM6hzmoL5vf0ThDKQMWT3HrwCjUCGPwR63vBwn6+/Gx+kx+VTo9FuojzR0O4XfwD3LrYA+oT3ETbn9U4e/VS4AH/G4SDMzgSLwu0YuPe517FfGWhWGQhjiXphkaQ+6bXPmcASWb0RCO5+pYlGIfxv4eFGQ==",  
    "fingerprint": "0b:cf:58:40:b9:23:96:c7:ba:44:df:0e:9e:87:5e:75",  
    "fingerprint_sha256": "SHA256:lGI/Ys/Wx7PfMhUO1iuBH92JQKYN+3mhJZvWO4Q5ims",  
    "created_at": "2013-10-02T11:12:29Z",  
    "expires_at": null,  
    "can_push": false  
  }  
]  

사용자에 대한 프로젝트 배포 키 목록

도입됨 GitLab 15.1에서.

지정된 사용자(요청자)와 인증된 사용자(요청자)의 공통 프로젝트 배포 키 목록을 가져옵니다. 요청자와 요청자의 공통 프로젝트의 활성화된 프로젝트 키만 나열합니다.

GET /users/:id_or_username/project_deploy_keys

매개변수:

속성	유형	필수	설명
`id_or_username`	string	예	프로젝트 배포 키를 가져오기 위한 사용자의 ID 또는 사용자 이름입니다.

[
    {
        "id": 1,
        "title": "Key A",
        "created_at": "2022-05-30T12:28:27.855Z",
        "expires_at": null,
        "key": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAILkYXU2fVeO4/0rDCSsswP5iIX2+B6tv15YT3KObgyDl Key",
        "fingerprint": "40:8e:fa:df:70:f7:a7:06:1e:0d:6f:ae:f2:27:92:01",
        "fingerprint_sha256": "SHA256:Ojq2LZW43BFK/AMP81jBkDGn9YpPWYRNcViKBB44LPU"
    },
    {
        "id": 2,
        "title": "Key B",
        "created_at": "2022-05-30T13:34:56.219Z",
        "expires_at": null,
        "key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDNJAkI3Wdf0r13c8a5pEExB2YowPWCSVzfZV22pNBc1CuEbyYLHpUyaD0GwpGvFdx2aP7lMEk35k6Rz3ccBF6jRaVJyhsn5VNnW92PMpBJ/P1UebhXwsFHdQf5rTt082cSxWuk61kGWRQtk4ozt/J2DF/dIUVaLvc+z4HomT41fQ==",
        "fingerprint": "4a:9d:64:15:ed:3a:e6:07:6e:89:36:b3:3b:03:05:d9",
        "fingerprint_sha256": "SHA256:Jrs3LD1Ji30xNLtTVf9NDCj7kkBgPBb2pjvTZ3HfIgU",
    }
]

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/users/20/project_deploy_keys"

예시 응답:

[
  {
    "id": 1,
    "title": "Key A",
    "created_at": "2022-05-30T12:28:27.855Z",
    "expires_at": "2022-10-30T12:28:27.855Z",
    "key": "ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAILkYXU2fVeO4/0rDCSsswP5iIX2+B6tv15YT3KObgyDl Key",
    "fingerprint": "40:8e:fa:df:70:f7:a7:06:1e:0d:6f:ae:f2:27:92:01",
    "fingerprint_sha256": "SHA256:Ojq2LZW43BFK/AMP81jBkDGn9YpPWYRNcViKBB44LPU"
  }
]

단일 배포 키 가져오기

단일 키를 가져옵니다.

GET /projects/:id/deploy_keys/:key_id

파라미터:

속성	타입	필수	설명
`id`	정수/문자열	예	프로젝트의 ID 또는 URL 인코딩된 경로
`key_id`	정수	예	배포 키의 ID

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/deploy_keys/11"

예제 응답:

{
  "id": 1,
  "title": "공개 키",
  "key": "ssh-rsa AAAAB3NzaC1yc2EAAAADAQABAAAAgQDNJAkI3Wdf0r13c8a5pEExB2YowPWCSVzfZV22pNBc1CuEbyYLHpUyaD0GwpGvFdx2aP7lMEk35k6Rz3ccBF6jRaVJyhsn5VNnW92PMpBJ/P1UebhXwsFHdQf5rTt082cSxWuk61kGWRQtk4ozt/J2DF/dIUVaLvc+z4HomT41fQ==",
  "fingerprint": "4a:9d:64:15:ed:3a:e6:07:6e:89:36:b3:3b:03:05:d9",
  "fingerprint_sha256": "SHA256:Jrs3LD1Ji30xNLtTVf9NDCj7kkBgPBb2pjvTZ3HfIgU",
  "created_at": "2013-10-02T10:12:29Z",
  "expires_at": null,
  "can_push": false
}

프로젝트에 배포 키 추가

프로젝트에 대한 새 배포 키를 생성합니다.

배포 키가 다른 프로젝트에 이미 존재하는 경우, 원본 키에 동일한 사용자가 접근 가능하면 현재 프로젝트에 추가됩니다.

POST /projects/:id/deploy_keys

속성	타입	필수	설명
`id`	정수/문자열	예	프로젝트의 ID 또는 URL 인코딩된 경로
`key`	문자열	예	새 배포 키
`title`	문자열	예	새 배포 키의 제목
`can_push`	불리언	아니오	배포 키가 프로젝트의 저장소에 푸시할 수 있는지 여부
`expires_at`	날짜시간	아니오	배포 키의 만료 날짜. 값이 제공되지 않으면 만료되지 않습니다. ISO 8601 형식(`2019-03-15T08:00:00Z`)으로 예상됩니다.

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" --header "Content-Type: application/json" \
     --data '{"title": "내 배포 키", "key": "ssh-rsa AAAA...", "can_push": "true"}' \
     "https://gitlab.example.com/api/v4/projects/5/deploy_keys/"

예제 응답:

{
   "key" : "ssh-rsa AAAA...",
   "id" : 12,
   "title" : "내 배포 키",
   "can_push": true,
   "created_at" : "2015-08-29T12:44:31.550Z",
   "expires_at": null
}

배포 키 업데이트

프로젝트에 대한 배포 키를 업데이트합니다.

PUT /projects/:id/deploy_keys/:key_id

속성	유형	필요 여부	설명
`id`	정수/문자열	예	프로젝트의 ID 또는 URL 인코딩 경로
`can_push`	불리언	아니요	배포 키가 프로젝트의 저장소에 푸시할 수 있는지 여부
`title`	문자열	아니요	새로운 배포 키의 제목

curl --request PUT --header "PRIVATE-TOKEN: <your_access_token>" --header "Content-Type: application/json" \
     --data '{"title": "New deploy key", "can_push": true}' "https://gitlab.example.com/api/v4/projects/5/deploy_keys/11"

예시 응답:

{
   "id": 11,
   "title": "New deploy key",
   "key": "ssh-rsa AAAA...",
   "created_at": "2015-08-29T12:44:31.550Z",
   "expires_at": null,
   "can_push": true
}

배포 키 삭제

프로젝트에서 배포 키를 제거합니다. 배포 키가 이 프로젝트에만 사용되는 경우 시스템에서 삭제됩니다.

DELETE /projects/:id/deploy_keys/:key_id

속성	유형	필요 여부	설명
`id`	정수/문자열	예	프로젝트의 ID 또는 URL 인코딩 경로
`key_id`	정수	예	배포 키의 ID

curl --request DELETE --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/deploy_keys/13"

배포 키 활성화

프로젝트에 대한 배포 키를 활성화하여 사용할 수 있도록 합니다. 성공하면 활성화된 키와 상태 코드 201을 반환합니다.

POST /projects/:id/deploy_keys/:key_id/enable

속성	유형	필요 여부	설명
`id`	정수/문자열	예	프로젝트의 ID 또는 URL 인코딩 경로
`key_id`	정수	예	배포 키의 ID

curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects/5/deploy_keys/12/enable"

예시 응답:

{
   "key" : "ssh-rsa AAAA...",
   "id" : 12,
   "title" : "My deploy key",
   "created_at" : "2015-08-29T12:44:31.550Z",
   "expires_at": null
}

여러 프로젝트에 배포 키 추가

동일한 배포 키를 동일한 그룹의 여러 프로젝트에 추가하려면 API를 사용하여 이를 수행할 수 있습니다.

먼저, 관심 있는 프로젝트의 ID를 찾기 위해 모든 프로젝트를 나열합니다:

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/projects"

또는 그룹의 ID를 찾습니다:

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups"

그런 다음 해당 그룹(예: 그룹 1234)의 모든 프로젝트를 나열합니다:

curl --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/groups/1234"

그 ID들을 사용하여 동일한 배포 키를 모두 추가합니다:

for project_id in 321 456 987; do
    curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" \
         --header "Content-Type: application/json" \
         --data '{"title": "my key", "key": "ssh-rsa AAAA..."}' \
         "https://gitlab.example.com/api/v4/projects/${project_id}/deploy_keys"
done

배포 키 API

모든 배포 키 목록

배포 키 추가

프로젝트에 대한 배포 키 목록

사용자에 대한 프로젝트 배포 키 목록

단일 배포 키 가져오기

프로젝트에 배포 키 추가

배포 키 업데이트

배포 키 삭제

배포 키 활성화

여러 프로젝트에 배포 키 추가

도움말

기능 사용 가능성과 제품 평가판

도움받기