서브계정 단건 조회

인쇄
공유
PDF

기사 요약

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

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

서브계정 단건을 조회합니다.

API

GET /sub-accounts/{subAccountId}

요청

Path Variables

파라미터	필수여부	타입	제약사항	설명
subAccountId	Y	String		Sub Account Id

응답

{
    "nrn": "string",
    "active": "boolean",
    "canAPIGatewayAccess": "boolean",
    "canConsoleAccess": "boolean",
    "consolePermitIps": [
        "string"
    ],
    "createTime": "string",
    "email": "string",
    "groups": [
        {
            "groupId": "string",
            "groupName": "string",
            "policies": [
                {}
            ],
            "subAccounts": [
                {}
            ]
        }
    ],
    "lastLoginTime": "string",
    "loginId": "string",
    "memo": "string",
    "modifiedTime": "string",
    "name": "string",
    "needPasswordReset": "boolean",
    "policies": [
        {
            "policyId": "string",
            "policyName": "string",
            "policyType": "string"
        }
    ],
    "subAccountId": "string",
    "useConsolePermitIp": "boolean",
    "useApiAllowSource": "boolean",
    "apiAllowSources": [
        {
            "type": "string",
            "source": "string"
        }
    ]
}

항목	타입	설명
nrn	string	Ncloud의 리소스를 표현하기 위한 Naming Rule
active	boolean	Sub Account 상태 (true: 활성, false: 비활성)
canAPIGatewayAccess	boolean	- API Gateway Access Access Key를 생성하여 해당 키로 API Gateway에 등록된 API 사용 가능
canConsoleAccess	boolean	- Console Access 서브 계정이 관리 콘솔에 접근할 수 있도록 설정
consolePermitIps	array	콘솔 접근 가능한 IP 대역 목록
createTime	string	생성일시 2019-08-10T13:21:00Z
email	string	이메일
groups	array	서브계정이 속한 그룹 목록
groups.groupId	string	그룹 아이디
groups.groupName	string	그룹 이름
groups.policies	array	그룹에 할당된 정책 리스트
groups.subAccounts	array	그룹에 속한 서브계정 리스트
lastLoginTime	string	최종 접속일시 2019-08-10T13:21:00Z
loginId	string	로그인 아이디
memo	string	메모 (max: 100 bytes)
modifiedTime	string	최종 수정일시 2019-08-10T13:21:00Z
name	string	이름
needPasswordReset	boolean	- 비밀번호 재설정 필요여부 생성된 생성된 서브계정으로 로그인 시, 새로운 비밀번호로 변경하도록 안내
policies	array	서브계정이 부여받은 정책 목록
policies.policyId	string	정책 아이디
policies.policyName	string	정책 이름
policies.policyType	string	정책 유형 (SYSTEM_MANAGED, USER_CREATED)
subAccountId	string	서브계정 아이디
useConsolePermitIp	boolean	콘솔 접근 시 IP 대역 제한을 사용하는지 여부
useApiAllowSource	boolean	API 이용 시 접근 제한을 사용 가능
apiAllowSources	array	API 이용 시 접근 가능한 목록
apiAllowSources[].type	string	접근 가능 소스의 타입 (IP, VPC, VPC_SERVER)
apiAllowSources[].source	string	접근 가능 소스 정보 (IP, InstanceNo)

에러

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

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

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

What's Next

서브계정 생성

태그

Sub Account