서비스 계정 사용자 API

Tier: 프리미엄, 얼티메이트 Offering: Self-managed, GitLab 전용

REST API를 사용하여 서비스 계정 사용자를 만들고 목록화합니다.

서비스 계정 사용자 만들기

  • 서비스 계정 사용자 만들기 기능은 GitLab 16.1에서 도입되었습니다.
  • 이름 또는 사용자 이름을 지정하는 기능은 GitLab 16.10에서 도입되었습니다.

서비스 계정 사용자를 만듭니다. 계정의 사용자 이름과 이름을 지정할 수 있습니다. 특별한 속성을 지정하지 않으면:

  • 기본 이름은 서비스 계정 사용자입니다.
  • 사용자 이름은 자동으로 생성됩니다.

필수 조건:

  • 관리자여야 합니다. 
POST /service_accounts

지원되는 속성:

속성 유형 필수 설명
name string 아니요 사용자의 이름.
username string 아니요 사용자의 사용자 이름.

예시 요청: 

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

예시 응답: 

{
  "id": 57,
  "username": "service_account_6018816a18e515214e0c34c2b33523fc",
  "name": "서비스 계정 사용자"
}

모든 서비스 계정 사용자 나열하기

Tier: 프리미엄, 얼티메이트 Offering: Self-managed, GitLab 전용
  • 모든 서비스 계정 사용자를 나열하는 기능은 GitLab 17.1에서 도입되었습니다.

모든 서비스 계정 사용자를 나열합니다.

필수 조건:

  • 관리자여야 합니다.

이 기능은 페이지네이션 매개변수 page와 per_page를 사용하여 사용자 목록을 제한합니다. 

GET /service_accounts

지원되는 속성:

속성 유형 필수 설명
order_by string 아니요 사용자 목록을 username 또는 id로 정렬합니다. 기본값은 id입니다.
sort string 아니요 asc 또는 desc로 정렬 순서를 지정합니다. 기본값은 desc입니다.

예시 요청: 

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

예시 응답: 

[
  {
    "id": 114,
    "username": "service_account_33",
    "name": "서비스 계정 사용자"
  },
  {
    "id": 137,
    "username": "service_account_34",
    "name": "john doe"
  }
]