사용자 중재 API
Offering: GitLab Self-Managed, GitLab Dedicated
이 API를 사용하여 사용자 계정을 중재합니다. 승인 대기 중인 특정 사용자 계정의 액세스를 승인합니다. 승인 대기 중인 특정 사용자 계정의 액세스를 거부합니다. 특정 사용자 계정을 비활성화합니다. 이전에 비활성화된 특정 사용자 계정을 재활성화합니다.
이 API를 사용하여 사용자 계정을 중재합니다. 자세한 내용은 사용자 중재를 참조하세요.
사용자 액세스 승인#
승인 대기 중인 특정 사용자 계정의 액세스를 승인합니다.
사전 조건:
- 인스턴스에 대한 관리자 액세스 권한이 있어야 합니다.
POST /users/:id/approve
지원되는 속성:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
integer | 예 | 사용자 계정의 ID |
curl --request POST \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "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 |
integer | 예 | 사용자 계정의 ID |
curl --request POST \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "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/deactivate
지원되는 속성:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
integer | 예 | 사용자 계정의 ID |
curl --request POST \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/users/42/deactivate"
반환 값:
- 성공 시
201 OK. - 사용자를 찾을 수 없는 경우
404 User Not Found. - 다음과 같은 사용자를 비활성화하려는 경우
403 Forbidden:- 관리자 또는 LDAP 동기화에 의해 차단된 사용자.
- 휴면 상태가 아닌 사용자.
- 내부 사용자.
사용자 재활성화#
이전에 비활성화된 특정 사용자 계정을 재활성화합니다.
사전 조건:
- 인스턴스에 대한 관리자 액세스 권한이 있어야 합니다.
POST /users/:id/activate
지원되는 속성:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
integer | 예 | 사용자 계정의 ID |
curl --request POST \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/users/42/activate"
반환 값:
- 성공 시
201 OK. - 사용자를 찾을 수 없는 경우
404 User Not Found. - 관리자 또는 LDAP 동기화에 의해 차단되어 사용자를 활성화할 수 없는 경우
403 Forbidden.
사용자 액세스 차단#
특정 사용자 계정을 차단합니다. 차단된 사용자에 대한 자세한 내용은 사용자 차단 및 차단 해제를 참조하세요.
사전 조건:
- 인스턴스에 대한 관리자 액세스 권한이 있어야 합니다.
POST /users/:id/block
지원되는 속성:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
integer | 예 | 사용자 계정의 ID |
curl --request POST \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/users/42/block"
반환 값:
- 성공 시
201 OK. - 사용자를 찾을 수 없는 경우
404 User Not Found. - 다음과 같은 사용자를 차단하려는 경우
403 Forbidden:- LDAP를 통해 차단된 사용자.
- 내부 사용자.
사용자 액세스 차단 해제#
이전에 차단된 특정 사용자 계정의 차단을 해제합니다.
사전 조건:
- 인스턴스에 대한 관리자 액세스 권한이 있어야 합니다.
POST /users/:id/unblock
지원되는 속성:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
integer | 예 | 사용자 계정의 ID |
curl --request POST \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/users/42/unblock"
반환 값:
- 성공 시
201 OK. - 사용자를 찾을 수 없는 경우
404 User Not Found. - LDAP 동기화에 의해 차단된 사용자의 차단을 해제하려는 경우
403 Forbidden.
사용자 밴#
특정 사용자 계정을 밴합니다. 밴된 사용자에 대한 자세한 내용은 사용자 밴 및 밴 해제를 참조하세요.
사전 조건:
- 인스턴스에 대한 관리자 액세스 권한이 있어야 합니다.
POST /users/:id/ban
지원되는 속성:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
integer | 예 | 사용자 계정의 ID |
curl --request POST \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/users/42/ban"
반환 값:
- 성공 시
201 OK. - 사용자를 찾을 수 없는 경우
404 User Not Found. - 활성 상태가 아닌 사용자를 밴하려는 경우
403 Forbidden.
사용자 밴 해제#
이전에 밴된 특정 사용자 계정의 밴을 해제합니다.
사전 조건:
- 인스턴스에 대한 관리자 액세스 권한이 있어야 합니다.
POST /users/:id/unban
지원되는 속성:
| 속성 | 유형 | 필수 | 설명 |
|---|---|---|---|
id |
integer | 예 | 사용자 계정의 ID |
curl --request POST \
--header "PRIVATE-TOKEN: <your_access_token>" \
--url "https://gitlab.example.com/api/v4/users/42/unban"
반환 값:
- 성공 시
201 OK. - 사용자를 찾을 수 없는 경우
404 User Not Found. - 밴되지 않은 사용자의 밴을 해제하려는 경우
403 Forbidden.
