서브계정 단건 조회
- 인쇄
- PDF
서브계정 단건 조회
- 인쇄
- 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"
}
],
"subAccountNo": "integer",
"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 | |
| 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) | |
| subAccountNo | integer | 서브 계정 No | |
| 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 | 존재하지 않는 계정 |
이 문서가 도움이 되었습니까?