유저 정보 단건 조회

인쇄
공유
PDF

기사 요약

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

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

서브계정, 삭제된 서브계정, 역할 사용자 등 계정에 권한이 부여된 모든 사용자를 조회합니다.

API

GET /users/{subAccountId}

요청

Path Variables

파라미터	필수여부	타입	제약사항	설명
includeDeleted	N	boolean	default: false	삭제된 사용자 포함 여부

응답

{
  "subAccountId": "string",
  "loginId": "string",
  "name": "string",
  "email": "string",
  "groups": [
    {
      "groupId": "string",
      "groupName": "string"
    }
  ],
  "active": true,
  "deleted": true,
  "createTime": "string",
  "principalType": "string",
  "sourceIdentity": {
    "type": "string",
    "id": "string",
    "provider": "string"
  },
  "roleNrn": "string"
}

항목	타입	설명	비고
principalType	string	사용자 유형	IamUser: 서브계정, IamRole: 역할 사용자
subAccountId	string	사용자 아이디
loginId	string	로그인 아이디
name	string	이름
email	string	이메일
groups	array	서브계정이 속한 그룹 목록
groups.groupId	string	그룹 아이디
groups.groupName	string	그룹 이름
active	boolean	Sub Account 상태 (true: 활성, false: 비활성)
deleted	boolean	삭제된 사용자 여부
createTime	string	생성일시 2019-08-10T13:21:00Z
sourceIdentity	object	역할 적용 대상자 정보	principalType이 IamRole인 경우에만 조회 가능 Source Identity 항목 참조
sourceIdentity.type	string	역할 적용 대상자 유형 (Principal Type)	principalType이 IamRole인 경우에만 조회 가능
sourceIdentity.id	string	역할 적용 대상자 고유 id	principalType이 IamRole인 경우에만 조회 가능
sourceIdentity.provider	string	역할 적용 대상자의 소속 구분	principalType이 IamRole인 경우에만 조회 가능
roleNrn	string	전환한 역할의 NRN	principalType이 IamRole인 경우에만 조회 가능

Source Identity

역할 적용 대상자 정보

역할 타입	Source Identity type	Source Identity provider	Source Identity id
Account Role	IamUser	회원 번호	서브계정 ID
Server Role	Server	N/A	N/A
SSO Role	FederatedUser	SSO tenant ID	SSO user ID
Service Role	NcloudService	서비스 ID	서비스 리소스 ID

에러

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

HTTP status code	에러 코드	에러 메시지
401	30	존재하지 않는 계정

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

What's Next

유저 id 조회