히스토리

• GitLab 16.4에서 ssh_certificates_rest_endpoints라는 플래그와 함께 도입되었습니다. 기본적으로 비활성화됩니다.
• GitLab 16.9에서 GitLab.com에서 활성화되었습니다.
• GitLab 17.7에서 일반 공개되었습니다. 기능 플래그 ssh_certificates_rest_endpoints가 제거되었습니다.

이 API를 사용하여 그룹 SSH 인증서를 관리합니다. SSH 인증서는 최상위 그룹에만 저장할 수 있습니다.

사전 요구 사항:

• 최상위 그룹의 Owner여야 합니다.

모든 그룹 SSH 인증서 목록 조회#

지정된 그룹의 모든 SSH 인증서를 나열합니다.

GET /groups/:id/ssh_certificates

매개변수:

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

요청 예시:

curl --header "PRIVATE-TOKEN: <your_access_token>" \
  --url "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

매개변수:

요청 예시:

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_certificates/:id

매개변수:

요청 예시:

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