Organization 개요
- 인쇄
- PDF
Organization 개요
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
Classic/VPC 환경에서 이용 가능합니다.
Organization은 조직이 가진 모든 계정에서 발생한 비용의 통합 결제 및 자원 사용 정책 관리 기능을 제공하는 네이버 클라우드 플랫폼의 서비스입니다. Organization 서비스에서는 Organization, Account, Group, Quota Policy(이용 한도 정책) 기능에 대한 API를 RESTful 형태로 제공합니다.
Organization 공통 설정
Organization API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.
요청
공통 요청 형식을 설명합니다.
API URL
요청 API URL은 다음과 같습니다.
요청 헤더
헤더에 대한 설명은 다음과 같습니다.
필드 | 필수 여부 | 설명 |
---|---|---|
x-ncp-apigw-timestamp | Required | 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초)
|
x-ncp-iam-access-key | Required | 네이버 클라우드 플랫폼에서 발급받은 Access Key |
x-ncp-apigw-signature-v2 | Required | 네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명 |
Accept | Optional | 응답 데이터의 형식
|
Content-type | Optional | 요청 데이터의 형식
|
응답
공통 응답 형식을 설명합니다.
응답 상태 코드
응답 상태 코드에 대한 설명은 다음과 같습니다.
HTTP 상태 코드 | 코드 | 메시지 | 설명 |
---|---|---|---|
401 | COMMON_201 | 메인 계정으로만 수행할 수 있는 기능입니다. | 마스터 계정 아님 |
403 | COMMON_101 | 마스터 계정이 아닙니다. | 마스터 계정 아님 |
403 | COMMON_102 | 메일발송에 실패했습니다. 잠시 후 다시 시도해주세요. | 메일 발송 실패 |
403 | COMMON_103 | 내부 서버 오류가 발생 하였습니다. 문제가 계속 될 경우, 고객지원(1544-5876)으로 문의해 주세요. | 내부 서버 오류 |
403 | COMMON_104 | 잦은 요청으로 기능 수행이 잠시 제한됩니다. | 너무 잦은 요청 |
403 | ACCOUNT_101 | 현재 미납 요금이 존재하여 새로운 계정을 Organization에 초대할 수 없습니다. | 초대 승인 실패: 서비스 이용 요금 미납 |
403 | ACCOUNT_102 | 같은 거주지 국가의 계정만 초대할 수 있습니다. | 초대 실패: 거주지 국가 상이 |
403 | ACCOUNT_103 | 이미 초대한 계정입니다. | 초대 실패: 이미 초대한 계정 |
403 | ACCOUNT_104 | 이미 가입한 Organization이 존재합니다. | 초대 실패: 초대 대상의 다른 Organization 가입 |
403 | ACCOUNT_105 | Account 정보를 다시 한 번 확인하세요. | 초대 실패: 계정 정보 입력 오류 |
403 | ACCOUNT_106 | 이미 Organization에 가입된 계정입니다. | 초대 승인 실패: 이미 가입된 계정 |
403 | ACCOUNT_107 | Pin Code를 다시 확인해주세요. | 초대 승인 실패: 핀 코드 입력 오류 |
403 | ACCOUNT_108 | 초대 유효기간이 만료되었습니다. | 초대 승인 실패: 초대 유효 기간 만료 |
403 | ACCOUNT_109 | 아직 납부되지 않은 미납금액이 존재합니다. | 초대 승인 실패: 서비스 이용 요금 미납 |
403 | ACCOUNT_111 | 멤버 계정 초대는 마스터 계정과 동일한 사업자번호를 가진 기업회원에 한하여 초대가 가능합니다 | 초대 실패: 마스터 계정과 초대 계정의 사업자 번호 상이 |
403 | ACCOUNT_112 | 파트너회원 체결/탈퇴 예정 및 파트너코드 변경 예정인 계정 | 초대 승인 실패: 파트너 회원 체결/탈퇴 예정, 파트너 코드 변경 예정 |
403 | ACCOUNT_113 | 정상 회원이 아니거나 회원정보 확인이 불가한 계정 | 초대 실패: 정상 회원이 아니거나 회원 정보 확인 불가 |
403 | ACCOUNT_114 | Master 계정과 다른 통화코드를 가진 계정 | 초대 실패: 마스터 계정과 통화 코드 상이 |
403 | ACCOUNT_115 | Master 계정과 회원유형이 다른 계정 | 초대 실패: 마스터 계정과 회원 유형 상이 |
403 | ACCOUNT_116 | 파트너 대표 계정 | 초대 실패: 파트너 대표 계정 |
403 | ACCOUNT_117 | Master 계정과 파트너코드가 다른 계정 | 초대 실패: 마스터 계정과 파트너 코드 상이 |
403 | ACCOUNT_201 | 계정 이름 혹은 로그인 ID가 유효하지 않은 계정 | 탈퇴 실패: loginId , memberNo 입력 오류 |
403 | ACCOUNT_202 | 미납이 존재합니다. | 탈퇴 실패: 서비스 이용 요금 미납 |
403 | ACCOUNT_203 | 결제수단이 존재하지 않습니다. | 탈퇴 실패: 결제 수단 미등록 |
403 | ACCOUNT_204 | 매월 1일 00시 00분 ~ 2일 23시 59분 사이에 탈퇴를 진행할 수 없습니다. 3일 이후에 진행해주세요. | 탈퇴 실패: 이용 제한 시간 |
403 | ORG_101 | 이미 가입한 Organization이 존재합니다. | Organization 생성 실패: 다른 Organization에 가입한 계정 |
403 | ORG_102 | 사업자 계정이 아닙니다. | Organization 생성 실패: 사업자 계정 아님 |
403 | ORG_103 | 결제수단이 존재하지 않습니다. | Organization 생성 실패: 결제 수단 미등록 |
403 | ORG_104 | 미납이 존재합니다. | Organization 생성 실패: 서비스 이용 요금 미납 |
403 | ORG_201 | 멤버 계정 혹은 대기중인 계정이 존재하는 Organization을 삭제할 수 없습니다. | Organization 생성 실패: 멤버 계정 또는 초대 중인 계정 존재 |
403 | GROUP_101 | 이름은 필수값입니다. | 그룹 생성/수정 실패: 필수 입력값 누락 |
403 | GROUP_102 | 이름은 3~50자 사이여야합니다. | 그룹 생성/수정 실패: 값 입력 오류 |
403 | GROUP_103 | 이름은 영문자, 숫자, “-”, “_”, “.” 문자만 입력 가능합니다. | 그룹 생성/수정 실패: 값 입력 오류 |
403 | GROUP_104 | 그룹은 5단계까지만 생성가능합니다. | 그룹 생성/수정 실패: 제한 범위 초과 |
403 | GROUP_105 | 상위 노드가 존재하지 않습니다. | 그룹 생성/수정 실패: 상위 노드 누락 |
403 | GROUP_106 | 적합한 Organization이 아닙니다. | 그룹 생성/수정 실패: 잘못된 요청
|
403 | GROUP_201 | 적합한 Organization이 아닙니다. | 그룹 삭제 실패: 잘못된 요청
|
403 | GROUP_202 | 하위 그룹 혹은 계정이 존재하여 삭제할 수 없습니다. | 그룹 삭제 실패: 하위 그룹 또는 계정 존재 |
403 | GROUP_301 | 그룹은 5단계까지만 생성가능합니다. | 그룹 이동 실패: 제한 범위 초과 |
403 | QUOTA_101 | 최대 갯수를 넘어 생성할 수 없습니다. | 정책 생성 실패: 리소스 최대한도 초과 |
참고
네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.
Organization API
Organization 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.
Organization
Organization 관련 API에 대한 설명은 다음과 같습니다.
API | 설명 |
---|---|
Organization 조회 | Organization 조회
|
Organization 생성 | Organization 생성
|
Organization 삭제 | Organization 삭제
|
계정
계정 관련 API에 대한 설명은 다음과 같습니다.
API | 설명 |
---|---|
계정 목록 조회 | Organization 소속 계정 목록 조회
|
계정 초대 | Organization 멤버 계정으로 초대
|
초대 목록 조회 | Organization의 계정 초대 정보 조회
|
초대 승인 | Organization 초대 승인
|
초대 거절 | Organization 초대 거절
|
탈퇴 신청 목록 조회 | 탈퇴 신청 목록 조회
|
탈퇴 신청 승인 및 반려 | 멤버 계정 탈퇴 신청 승인 또는 반려
|
강제 탈퇴 | 멤버 계정 강제 탈퇴
|
계정 그룹
계정 그룹 관련 API에 대한 설명은 다음과 같습니다.
API | 설명 |
---|---|
계정 그룹 목록 조회 | 계정 그룹 목록 조회
|
계정 그룹 생성 | 계정 그룹 생성
|
계정 그룹 삭제 | 계정 그룹 삭제
|
계정 그룹 이름 변경 | 계정 그룹 이름 변경
|
계정 그룹 이동 | 계정 그룹 위치 이동
|
Quota Policy
Quota Policy(이용 한도 정책) 관련 API에 대한 설명은 다음과 같습니다.
API | 설명 |
---|---|
리전 목록 조회 | Quota Policy 적용 가능한 리전 조회
|
리소스 카테고리 목록 조회 | Quota Policy 적용 가능한 리소스 카테고리 조회
|
리소스 목록 조회 | Quota Policy 적용 가능한 리소스 조회
|
리소스 유형 목록 조회 | Quota Policy 적용 가능한 리소스 상세 유형 조회
|
리소스 이용 한도 조회 | 계정별 리소스 이용 한도 상세 조회
|
Quota Policy 목록 조회 | Quota Policy 목록 조회
|
Quota Policy 생성 | Quota Policy 생성
|
Quota Policy 삭제 | Quota Policy 삭제
|
Quota Policy 적용 조회 | 계정 그룹에 적용된 Quota Policy 조회
|
Quota Policy 적용 | 계정 그룹에 Quota Policy 적용
|
Quota Policy 적용 해제 | 계정 그룹에 적용된 Quota Policy 해제
|
Organization 연관 리소스
Organization API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.
- Organization API 사용 방법
- 서명(시그니처) 생성: 요청 헤더에 추가할 서명 생성 방법
- API Gateway 사용 가이드: 요청 헤더에 추가할 API Key 발급
- Sub Account 사용 가이드: 요청 헤더에 추가할 Access Key 발급 방법
- Ncloud 공통 응답 상태 코드: Organization 서비스에서 사용하는 네이버 클라우드 플랫폼의 공통 응답 상태 코드 정보
- Organization 서비스 사용 방법
- Organization 사용 가이드: 네이버 클라우드 플랫폼 콘솔에서 Organization 사용하는 방법
- Ncloud 사용 환경 가이드: VPC, Classic 환경 및 지원 여부에 대한 가이드
- 요금 소개, 특징, 상세 기능: Organization의 요금 체계, 특징, 상세 기능 요약
- 서비스 최신 소식: Organization 서비스 관련 최신 소식
- 자주 하는 질문: Organization 서비스 사용자들이 자주 하는 질문
- 문의하기: API 가이드를 통해서도 궁금증이 해결되지 않는 경우, 직접 문의
이 문서가 도움이 되었습니까?