정책이 실효 적용되는 사용자 목록 조회

정책이 실효 적용되는 사용자 목록을 조회합니다. 직접 바인딩(Direct), 그룹 경유(Group:{name}), 역할 경유(Role:{name}) 경로를 포함합니다.

HTTP 요청

GET https://<your-console-host>/api/v1/iam/authz/policies/{policy_id}/attached-entities/users

URI 매개변수

이름	위치	필수	형식	설명
policy_id	path	필수	string

쿼리 매개변수

이름	필수	형식	설명
page	선택	integer	페이지 번호 (0: 전체). 기본값 1. 범위 0~
pageSize	선택	integer	페이지 크기. 기본값 10. 범위 1~100
username	선택	string 또는 null	사용자명 부분 일치 필터
status	선택	string 또는 null	상태 필터
attachment	선택	string 또는 null	연결 경로 필터 (Direct | Group | Role)
id	선택	string 또는 null	식별자(TPN) 부분 일치 필터
createdAtGte	선택	string 또는 null	생성일 시작 (ISO8601, 포함)
createdAtLte	선택	string 또는 null	생성일 종료 (ISO8601, 포함)

요청 헤더

인증 헤더는 모든 API 가 같습니다. 공통 규약을 참고하십시오.

응답

상태 코드	설명
200 OK	Successful Response
422 Unprocessable Entity	Validation Error

위 표는 정상 응답과 요청 검증 실패만 나열합니다. 이 API 는 그 밖에 401(인증 실패) · 403(권한 없음) · 404(리소스 없음) · 502(인프라 오류)를 반환할 수 있습니다. 조건은 오류 처리를 참고하십시오.

응답 본문 — 200

이름	필수	형식	설명
message	선택	string 또는 null	응답 메시지
timestamp	선택	string	응답 생성 시간
requestId	필수	string	요청 식별자
result	필수	object	데이터 목록 + 페이지네이션
result.data	선택	array (object)	데이터 목록
result.data[].tpn	필수	string	사용자 TPN
result.data[].username	선택	string 또는 null	사용자명
result.data[].displayName	선택	string 또는 null	표시명
result.data[].status	선택	string 또는 null	상태 (active, disabled 등)
result.data[].attachment	필수	string	연결 경로 (Direct | Group:{name} | Role:{name})
result.data[].bindingId	선택	string 또는 null	바인딩 ID (Direct 경로만, 상속 경로는 null). Detach에 사용
result.data[].createdAt	선택	string 또는 null	사용자 생성일 (ISO 8601)
result.data[].attachedAt	선택	string 또는 null	직접 바인딩 생성 시각 (Direct만)
result.dataCount	필수	integer	데이터 개수. 범위 0~
result.pagination	필수	object	페이지네이션 정보
result.pagination.page	필수	integer	현재 페이지 번호 (0=전체 조회). 범위 0~
result.pagination.pageSize	필수	integer	페이지 크기. 범위 1~
result.pagination.totalCount	필수	integer	전체 데이터 개수. 범위 0~
result.pagination.totalPages	필수	integer	전체 페이지 개수. 범위 0~
result.pagination.hasNext	필수	boolean	다음 페이지 존재 여부
result.pagination.hasPrev	필수	boolean	이전 페이지 존재 여부