사용자 모더레이션 API


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

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

사용자 승인

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

전제 조건:

  • 관리자여야 합니다. 
POST /users/:id/approve

매개변수:

속성 유형 필수 설명
id integer yes 지정된 사용자의 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 integer yes 지정된 사용자의 ID

응답:

  • 성공 시 201 OK.
  • 사용자를 찾을 수 없는 경우 404 User Not Found.
  • 관리자에 의해 차단되었거나 LDAP 동기화에 의해 활성화할 수 없는 경우 403 Forbidden.

사용자 비활성화

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

전제 조건:

  • 관리자여야 합니다. 
POST /users/:id/deactivate

매개변수:

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

응답:

  • 성공 시 201 OK.
  • 사용자를 찾을 수 없는 경우 404 User Not Found.
  • 다음과 같은 경우 403 Forbidden:
    • 관리자 또는 LDAP 동기화에 의해 차단됨.
    • 휴면 상태가 아닌 경우.
    • 내부 사용자인 경우.

사용자 차단

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

전제 조건:

  • 관리자여야 합니다. 
POST /users/:id/block

매개변수:

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

응답:

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

사용자 차단 해제

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

전제 조건:

  • 관리자여야 합니다. 
POST /users/:id/unblock

매개변수:

속성 유형 필수 설명
id integer yes 지정된 사용자의 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.

관련 주제