사용자 관리 API

Tier: Free, Premium, Ultimate Offering: Self-managed, GitLab Dedicated

REST API를 사용하여 사용자를 승인, 활성화, 차단 및 블록할 수 있습니다.

사용자 승인

지정된 사용자를 승인합니다.

전제 조건:

  • 관리자가 되어야 합니다.
POST /users/:id/approve

매개변수:

속성 유형 필수 설명
id 정수 예 지정된 사용자의 ID 
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/users/42/approve"

응답:

  • 성공 시 201 Created을 반환합니다.
  • 사용자를 찾을 수 없는 경우 404 User Not Found을 반환합니다.
  • 관리자가 차단했거나 LDAP 동기화로 인해 사용자를 승인할 수 없는 경우 403 Forbidden을 반환합니다.
  • 사용자가 비활성화된 경우 409 Conflict을 반환합니다.

예시 응답:

{ "message": "Success" }

{ "message": "404 User Not Found" }

{ "message": "The user you are trying to approve is not pending approval" }

사용자 거부

지정된 사용자를 승인을 기다리는 사용자로 거부합니다.

전제 조건:

  • 관리자가 되어야 합니다.
POST /users/:id/reject

매개변수:

  • id (필수) - 지정된 사용자의 ID
curl --request POST --header "PRIVATE-TOKEN: <your_access_token>" "https://gitlab.example.com/api/v4/users/42/reject"

응답:

  • 성공 시 200 OK를 반환합니다.
  • 관리자 인증이 되지 않은 경우 403 Forbidden을 반환합니다.
  • 사용자를 찾을 수 없는 경우 404 User Not Found을 반환합니다.
  • 사용자가 승인을 기다리지 않는 경우 409 Conflict을 반환합니다.

예시 응답:

{ "message": "Success" }

{ "message": "404 User Not Found" }

{ "message": "User does not have a pending request" }

사용자 활성화

지정된 사용자를 활성화합니다.

전제 조건:

  • 관리자가 되어야 합니다.
POST /users/:id/activate

매개변수:

속성 유형 필수 설명
id 정수 예 지정된 사용자의 ID

응답:

  • 성공 시 201 OK를 반환합니다.
  • 사용자를 찾을 수 없는 경우 404 User Not Found을 반환합니다.
  • 관리자가 차단했거나 LDAP 동기화로 인해 사용자를 활성화할 수 없는 경우 403 Forbidden을 반환합니다.

사용자 비활성화

지정된 사용자를 비활성화합니다.

전제 조건:

  • 관리자가 되어야 합니다.
POST /users/:id/deactivate

매개변수:

속성 유형 필수 설명
id 정수 예 지정된 사용자의 ID

응답:

  • 성공 시 201 OK를 반환합니다.
  • 사용자를 찾을 수 없는 경우 404 User Not Found을 반환합니다.
  • 다음과 같은 이유로 사용자를 비활성화하려고 할 때 403 Forbidden을 반환합니다:
    • 관리자가 차단했거나 LDAP 동기화로 인해 차단된 경우.
    • 휴면 상태가 아닌 경우.
    • 내부 사용자인 경우.

사용자 차단

지정된 사용자를 차단합니다.

전제 조건:

  • 관리자인이어야 합니다.
POST /users/:id/block

매개변수:

속성 유형 필수 설명
id 정수 예 지정된 사용자의 ID

반환:

  • 성공 시 201 OK.
  • 사용자를 찾을 수 없는 경우 404 User Not Found.
  • 다음을 차단하려고 할 때 403 Forbidden:
    • LDAP를 통해 차단된 사용자.
    • 내부 사용자.

사용자 차단 해제

지정된 사용자의 차단을 해제합니다.

전제 조건:

  • 관리자인이어야 합니다.
POST /users/:id/unblock

매개변수:

속성 유형 필수 설명
id 정수 예 지정된 사용자의 ID

반환: 성공 시 201 OK, 사용자를 찾을 수 없는 경우 404 User Not Found 또는 LDAP 동기화로 차단된 사용자의 차단을 해제하려고 할 때 403 Forbidden.

사용자 금지

지정된 사용자를 금지합니다.

전제 조건:

  • 관리자인이어야 합니다.
POST /users/:id/ban

매개변수:

  • id (필수) - 지정된 사용자의 ID

반환:

  • 성공 시 201 OK.
  • 사용자를 찾을 수 없는 경우 404 User Not Found.
  • 활성 상태가 아닌 사용자를 금지하려고 할 때 403 Forbidden.

사용자 금지 해제

지정된 사용자의 금지를 해제합니다. 관리자만 사용 가능합니다.

POST /users/:id/unban

매개변수:

  • id (필수) - 지정된 사용자의 ID

반환:

  • 성공 시 201 OK.
  • 사용자를 찾을 수 없는 경우 404 User Not Found.
  • 금지되지 않은 사용자의 금지를 해제하려고 할 때 403 Forbidden.

관련 주제