그룹 SSH 인증서 API

Tier: Premium, Ultimate
Offering: GitLab.com

GitLab.com에서 이 기능을 사용할 수 있습니다. GitLab Dedicated에서는 이 기능을 사용할 수 없습니다.

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

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

GET /groups/:id/ssh_certificates

매개 변수:

속성 유형 필수 설명
id 정수 예 그룹의 ID입니다.

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

예시 요청:

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 예 그룹의 ID입니다.
id integer 예 SSH 인증서의 ID입니다.

예제 요청:

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