그룹 SSH 인증서 API

Tier: Premium, Ultimate Offering: GitLab.com
GitLab.com에서는 이 기능을 사용할 수 있습니다. GitLab Dedicated에서는 사용할 수 없습니다.

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

특정 그룹의 모든 SSH 인증서 가져오기 

GET groups/:id/ssh_certificates

매개변수:

속성 유형 필수 설명
id integer 예 그룹의 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 integer 예 그룹의 ID.
key string 예 SSH 인증서의 공개 키.
title string 예 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 integer Yes 그룹 ID
id integer Yes SSH 인증서 ID

예시 요청: 

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