User를 포함하는 Group 목록 조회

인쇄
공유
PDF

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

Classic/VPC 환경에서 이용 가능합니다.

User가 속한 Group 목록을 조회합니다.

요청

GET /users/{userId}/groups

요청 Path

파라미터	필수 여부	타입	설명	제약사항
userId	Y	String	User Id

요청 파라미터

파라미터	필수 여부	타입	제약사항	설명
searchColumn	N	String	groupName, groupNrn, groupId	검색 컬럼 groupName, groupNrn, groupId
searchWord	N	String		검색어
page	N	int		페이지 번호 기본값: 0
size	N	int		결과 목록 크기 기본값: 20

응답

응답 바디

{
  "page" : "integer",
  "totalPages" : "integer",
  "totalItems" : "integer",
  "hasPrevious" : "boolean",
  "hasNext" : "boolean",
  "items" : [ {
    "groupId":"String",
    "groupName":"String",
    "nrn":"String",
    "createdAt":"String",
    "updatedAt":"String",
    "description":"String",
    "relationCreatedAt":"String"
    }
  ],
  "isFirst" : "boolean",
  "isLast" : "boolean"
}

파라미터	타입	설명
page	Number	반환받은 결과의 page
totalPages	Number	반환받은 결과의 totalPage
totalItems	Number	반환 받은 결과의 totalItems
hasPrevious	Boolean	현재 페이지 기준으로 이전 페이지 존재 여부
hasNext	Boolean	현재 페이지 기준으로 다음 페이지 존재 여부
isFirst	Boolean	전체 페이지 기준으로 현재 페이지가 처음 페이지인지 여부
isLast	Boolean	전체 페이지 기준으로 현재 페이지가 마지막 페이지인지 여부
items.[].groupId	String	그룹 아이디(UUID)
items.[].groupName	String	그룹 이름
items.[].nrn	String	그룹 nrn
items.[].description	String	그룹 설명
items.[].createdAt	String	생성 일시(UTC, 예: 2023-04-25T13:11:50Z)
items.[].updatedAt	String	수정 일시(UTC, 예: 2023-04-25T13:11:50Z)
items.[].relationCreatedAt	String	추가 일시/그룹에 유저가 추가된 시간(UTC, 예: 2023-04-25T13:11:50Z))

에러

아래 에러 코드는 이 액션(Action)에서 특징적으로 발생하는 에러입니다. 에러 응답 형식은 ErrorResponse를 참조해 주십시오.
공통적으로 발생하는 에러에 대한 상세한 설명은 NAVER Cloud Platform API를 참고해 주십시오.

HTTP status code	에러 코드	에러 메시지
400	9050	사용자가 존재하지 않습니다.

이 문서가 도움이 되었습니까?

What's Next

User를 포함하는 Group 단건 조회

요청
응답
에러