서브계정 생성
- 인쇄
- PDF
서브계정 생성
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
서브계정을 생성합니다.
API
- POST /sub-accounts
요청
Body
{
"active": "boolean",
"canAPIGatewayAccess": "boolean",
"canConsoleAccess": "boolean",
"email": "string",
"loginId": "string",
"memo": "string",
"name": "string",
"needPasswordReset": "boolean",
"needPasswordGenerate": "boolean",
"password": "string",
"isMfaMandatory": "boolean",
"useConsolePermitIp": "boolean",
"consolePermitIps": [
"string"
],
"useApiAllowSource": "boolean",
"apiAllowSources": [
{
"type": "string",
"source": "string"
}
]
}
| 파라미터 | 필수여부 | 타입 | 제약사항 | 설명 |
|---|---|---|---|---|
| active | Y | boolean | Sub Account 상태 (true: 활성, false: 비활성) | |
| canAPIGatewayAccess | Y | boolean | - API Gateway Access - Access Key를 생성하여 해당 키로 API Gateway에 등록된 API 사용 가능 | |
| canConsoleAccess | Y | boolean | - Console Access - 서브 계정이 관리 콘솔에 접근할 수 있도록 설정 | |
| N | string | 이메일 | ||
| loginId | Y | string | 최소 3자, 최대 60자 | 로그인 아이디 |
| memo | N | string | 최대 300bytes | 메모 |
| name | Y | string | 최소 2자, 최대 30자 | 이름 |
| needPasswordReset | Y | boolean | - 비밀번호 재설정 필요 여부 - 생성된 서브계정으로 로그인 시 새로운 비밀번호로 변경하도록 안내 | |
| needPasswordGenerate | N | boolean | 비밀번호 자동생성 필요 여부 | |
| password | N | string | needPasswordGenerate가 false 인 경우 필수 | 비밀번호 |
| isMfaMandatory | N | boolean | 2차인증 필수여부 (true: 필수, false: 선택) | |
| useConsolePermitIp | N | boolean | 콘솔 접근 시 IP 대역 제한을 사용 가능 (default: false) | |
| consolePermitIps | N | array | 콘솔 접근 가능한 IP 대역 목록 | |
| useApiAllowSource | N | boolean | API 이용 시 접근 제한을 사용 가능 | |
| apiAllowSources | N | array | API 접근 가능한 목록 | |
| apiAllowSources[].type | N | string | 접근 가능 소스의 타입 (IP, VPC, VPC_SERVER) | |
| apiAllowSources[].source | N | string | 접근 가능 소스 정보 (IP, InstanceNo) |
응답
- 응답
| 파라미터 명 | 필수여부 | 타입 | 설명 |
|---|---|---|---|
| ProcessResultWithPassword | Y | ProcessResultWithPassword | 처리 결과 |
- 응답 예시 - 등록 성공
{
"success": true,
"id": "subAccountId",
"generatedPassword": "Pa$$w0rd"
}
에러
아래 에러 코드는 이 액션(Action)에서 특징적으로 발생하는 에러입니다. 에러 응답 형식은 ErrorResponse를 참조해 주십시오.
공통적으로 발생하는 에러에 대한 상세한 설명은 NAVER Cloud Platform API를 참고해 주십시오.
| HTTP status code | 에러 코드 | 에러 메시지 |
|---|---|---|
| 400 | 120 | - 중복된 ID - 다른 ID 입력 필요 |
| 400 | 9015 | 안전하지 않은 비밀번호 |
이 문서가 도움이 되었습니까?