MENU
      Organization 개요
        • PDF

        Organization 개요

        • PDF

        기사 요약

        Classic/VPC 환경에서 이용 가능합니다.

        Organization은 조직이 가진 모든 계정에서 발생한 비용의 통합 결제 및 자원 사용 정책 관리 기능을 제공하는 네이버 클라우드 플랫폼의 서비스입니다. Organization 서비스에서는 Organization, Account, Group, Quota Policy(이용 한도 정책) 기능에 대한 API를 RESTful 형태로 제공합니다.

        Organization 공통 설정

        Organization API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

        요청

        공통 요청 형식을 설명합니다.

        API URL

        요청 API URL은 다음과 같습니다.

        https://organization.apigw.ntruss.com
        HTTP

        요청 헤더

        헤더에 대한 설명은 다음과 같습니다.

        필드필수 여부설명
        x-ncp-apigw-timestampRequired1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초)
        • API Gateway 서버와 5분 이상 시간 차 발생 시 유효하지 않은 요청으로 간주
        • Unix Timestamp 형식
        x-ncp-iam-access-keyRequired네이버 클라우드 플랫폼에서 발급받은 Access Key
        x-ncp-apigw-signature-v2Required네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명
        AcceptOptional응답 데이터의 형식
        • application/json
        Content-typeOptional요청 데이터의 형식
        • application/json

        응답

        공통 응답 형식을 설명합니다.

        응답 상태 코드

        응답 상태 코드에 대한 설명은 다음과 같습니다.

        HTTP 상태 코드코드메시지설명
        401COMMON_201메인 계정으로만 수행할 수 있는 기능입니다.마스터 계정 아님
        403COMMON_101마스터 계정이 아닙니다.마스터 계정 아님
        403COMMON_102메일발송에 실패했습니다. 잠시 후 다시 시도해주세요.메일 발송 실패
        403COMMON_103내부 서버 오류가 발생 하였습니다. 문제가 계속 될 경우, 고객지원(1544-5876)으로 문의해 주세요.내부 서버 오류
        403COMMON_104잦은 요청으로 기능 수행이 잠시 제한됩니다.너무 잦은 요청
        403ACCOUNT_101현재 미납 요금이 존재하여 새로운 계정을 Organization에 초대할 수 없습니다.초대 승인 실패: 서비스 이용 요금 미납
        403ACCOUNT_102같은 거주지 국가의 계정만 초대할 수 있습니다.초대 실패: 거주지 국가 상이
        403ACCOUNT_103이미 초대한 계정입니다.초대 실패: 이미 초대한 계정
        403ACCOUNT_104이미 가입한 Organization이 존재합니다.초대 실패: 초대 대상의 다른 Organization 가입
        403ACCOUNT_105Account 정보를 다시 한 번 확인하세요.초대 실패: 계정 정보 입력 오류
        403ACCOUNT_106이미 Organization에 가입된 계정입니다.초대 승인 실패: 이미 가입된 계정
        403ACCOUNT_107Pin Code를 다시 확인해주세요.초대 승인 실패: 핀 코드 입력 오류
        403ACCOUNT_108초대 유효기간이 만료되었습니다.초대 승인 실패: 초대 유효 기간 만료
        403ACCOUNT_109아직 납부되지 않은 미납금액이 존재합니다.초대 승인 실패: 서비스 이용 요금 미납
        403ACCOUNT_111멤버 계정 초대는 마스터 계정과 동일한 사업자번호를 가진 기업회원에 한하여 초대가 가능합니다초대 실패: 마스터 계정과 초대 계정의 사업자 번호 상이
        403ACCOUNT_112파트너회원 체결/탈퇴 예정 및 파트너코드 변경 예정인 계정초대 승인 실패: 파트너 회원 체결/탈퇴 예정, 파트너 코드 변경 예정
        403ACCOUNT_113정상 회원이 아니거나 회원정보 확인이 불가한 계정초대 실패: 정상 회원이 아니거나 회원 정보 확인 불가
        403ACCOUNT_114Master 계정과 다른 통화코드를 가진 계정초대 실패: 마스터 계정과 통화 코드 상이
        403ACCOUNT_115Master 계정과 회원유형이 다른 계정초대 실패: 마스터 계정과 회원 유형 상이
        403ACCOUNT_116파트너 대표 계정초대 실패: 파트너 대표 계정
        403ACCOUNT_117Master 계정과 파트너코드가 다른 계정초대 실패: 마스터 계정과 파트너 코드 상이
        403ACCOUNT_201계정 이름 혹은 로그인 ID가 유효하지 않은 계정탈퇴 실패: loginId, memberNo 입력 오류
        403ACCOUNT_202미납이 존재합니다.탈퇴 실패: 서비스 이용 요금 미납
        403ACCOUNT_203결제수단이 존재하지 않습니다.탈퇴 실패: 결제 수단 미등록
        403ACCOUNT_204매월 1일 00시 00분 ~ 2일 23시 59분 사이에 탈퇴를 진행할 수 없습니다. 3일 이후에 진행해주세요.탈퇴 실패: 이용 제한 시간
        403ORG_101이미 가입한 Organization이 존재합니다.Organization 생성 실패: 다른 Organization에 가입한 계정
        403ORG_102사업자 계정이 아닙니다.Organization 생성 실패: 사업자 계정 아님
        403ORG_103결제수단이 존재하지 않습니다.Organization 생성 실패: 결제 수단 미등록
        403ORG_104미납이 존재합니다.Organization 생성 실패: 서비스 이용 요금 미납
        403ORG_201멤버 계정 혹은 대기중인 계정이 존재하는 Organization을 삭제할 수 없습니다.Organization 생성 실패: 멤버 계정 또는 초대 중인 계정 존재
        403GROUP_101이름은 필수값입니다.그룹 생성/수정 실패: 필수 입력값 누락
        403GROUP_102이름은 3~50자 사이여야합니다.그룹 생성/수정 실패: 값 입력 오류
        403GROUP_103이름은 영문자, 숫자, “-”, “_”, “.” 문자만 입력 가능합니다.그룹 생성/수정 실패: 값 입력 오류
        403GROUP_104그룹은 5단계까지만 생성가능합니다.그룹 생성/수정 실패: 제한 범위 초과
        403GROUP_105상위 노드가 존재하지 않습니다.그룹 생성/수정 실패: 상위 노드 누락
        403GROUP_106적합한 Organization이 아닙니다.그룹 생성/수정 실패: 잘못된 요청
        • 마스터 계정 본인 소유 그룹만 생성/수정 가능
        403GROUP_201적합한 Organization이 아닙니다.그룹 삭제 실패: 잘못된 요청
        • 마스터 계정 본인 소유 그룹만 삭제 가능
        403GROUP_202하위 그룹 혹은 계정이 존재하여 삭제할 수 없습니다.그룹 삭제 실패: 하위 그룹 또는 계정 존재
        403GROUP_301그룹은 5단계까지만 생성가능합니다.그룹 이동 실패: 제한 범위 초과
        403QUOTA_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에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.


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

        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.