Organization 개요

Prev Next

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

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

Organization 공통 설정

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

요청

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

API URL

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

https://organization.apigw.ntruss.com

요청 헤더

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

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

응답

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

응답 상태 코드

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

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에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.