그룹 SSH 인증서 API

Tier: 프리미엄, 얼티밋 Offering: GitLab.com
GitLab.com에서는이 기능을 사용할 수 있습니다. GitLab Dedicated에서는이 기능을 사용할 수 없습니다.

이 API를 사용하여 그룹의 SSH 인증서를 생성, 읽기 및 삭제합니다. 최상위 그룹만 SSH 인증서를 저장할 수 있습니다. 이 API를 사용하려면 소유자 역할이 할당된 사용자로 인증해야합니다.

특정 그룹에 대한 모든 SSH 인증서 가져오기 

GET /groups/:id/ssh_certificates

매개변수:

속성 유형 필수 설명
id 정수 예 그룹의 ID

기본적으로 GET 요청은 API 결과가 페이지 매김되기 때문에 한 번에 20개의 결과를 반환합니다. 페이지 네이션에 대해 자세히 알아보기.

예시 요청: 

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

예시 응답: 

[
  {
    "id": 12345,
    "title": "SSH Title 1",
    "key": "ssh-rsa AAAAB3NzaC1ea2dAAAADAQABAAAAgQDGbLkF44ScxRQi2FfA7VsHgGqptguSbmW26jkJhEiRZpGS4/+UzaaSqc8Psw2OhSsKc5QwfrB/ANpO4LhOjDzhf2FuD8ACkv3R7XtaJ+rN6PlyzoBfLAiSyzxhEoMFDBprTgaiZKgg2yQ9dRH55w3f6XMZ4hnaUae53nQgfQLxFw== example@gitlab.com",
    "created_at": "2023-09-08T12:39:00.172Z"
  },
  {
    "id":12346,
    "title":"SSH Title 2",
    "key": "ssh-rsa AAAAB3NzaC1ac2EAAAADAQABAAAAgQDTl/hHfu1F/KlR+QfgM2wUmyxcN5YeiaWluEGIrfXUeJuI+bK6xjpE3+2afHDYtE9VQkeL32KRjefX2d72Jeoa68ewt87Vn8CcGkUTOTpHNzeL8pHMKFs3m7ArSBxNg5vTdgAsq5dbDGNtat7b2WCHTNvtWoON1Jetne30uW2EwQ== example@gitlab.com",
    "created_at": "2023-09-08T12:39:00.244Z"
  }
]

SSH 인증서 생성하기

그룹에 새 SSH 인증서를 생성합니다. 

POST /groups/:id/ssh_certificates

매개변수:

속성 유형 필수 설명
id 정수 예 그룹의 ID
key 문자열 예 SSH 인증서의 공개 키
title 문자열 예 SSH 인증서의 제목

예시 요청: 

curl --request POST \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/5/ssh_certificates?title=newtitle&key=ssh-rsa+REDACTED+example%40gitlab.com"

예시 응답: 

{
  "id": 54321,
  "title": "newtitle",
  "key": "ssh-rsa ssh-rsa AAAAB3NzaC1ea2dAAAADAQABAAAAgQDGbLkF44ScxRQi2FfA7VsHgGqptguSbmW26jkJhEiRZpGS4/+UzaaSqc8Psw2OhSsKc5QwfrB/ANpO4LhOjDzhf2FuD8ACkv3R7XtaJ+rN6PlyzoBfLAiSyzxhEoMFDBprTgaiZKgg2yQ9dRH55w3f6XMZ4hnaUae53nQgfQLxFw== example@gitlab.com",
  "created_at": "2023-09-08T12:39:00.172Z"
}

그룹 SSH 인증서 삭제

그룹에서 SSH 인증서를 삭제합니다. 

DELETE /groups/:id/ssh_certificate/:id

매개변수:

속성 유형 필수 설명
id 정수 예 그룹의 ID
id 정수 예 SSH 인증서의 ID

예시 요청: 

curl --request DELETE \
  --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "https://gitlab.example.com/api/v4/groups/5/ssh_certificates/12345"