---
title: "Organization 개요"
slug: "organization-overview"
tags: ["Organization"]
updated: 2026-09-17T09:16:35Z
published: 2026-09-17T09:16:35Z
canonical: "api.ncloud-docs.com/organization-overview"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Organization 개요

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 - Access Key 발급 및 확인: [인증키 생성](/docs/common-ncpapi) 참조 - 서브 계정의 Access Key 발급 및 확인: [서브 계정 생성](https://guide.ncloud-docs.com/docs/subaccount-use#%EC%84%9C%EB%B8%8C-%EA%B3%84%EC%A0%95-%EC%83%9D%EC%84%B1) 참조 |
| `x-ncp-apigw-signature-v2` | Required | 네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명 - Secret Key 발급 및 확인: [인증키 생성](/docs/common-ncpapi) 참조 - 서명 생성: [시그니처 생성](/docs/common-ncpapi) 참조 |
| `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 응답 상태 코드](/docs/common-ncpapi#3%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오.

## Organization API

Organization 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

### Organization

Organization 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [Organization 조회](/docs/organization-get-org) | Organization 조회 - 마스터 계정 사용 가능 |
| [Organization 생성](/docs/organization-post-org) | Organization 생성 - 마스터 계정 사용 가능 |
| [Organization 삭제](/docs/organization-delete-org) | Organization 삭제 - 마스터 계정 사용 가능 |

### 계정

계정 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [계정 목록 조회](/docs/organization-get-account-group) | Organization 소속 계정 목록 조회 - 마스터 계정 사용 가능 |
| [계정 초대](/docs/organization-post-account-invite) | Organization 멤버 계정으로 초대 - 마스터 계정 사용 가능 |
| [초대 목록 조회](/docs/organization-get-account-invite) | Organization의 계정 초대 정보 조회 - 초대받은 독립 계정 사용 가능 |
| [초대 승인](/docs/organization-post-account-accept) | Organization 초대 승인 - 초대받은 독립 계정 사용 가능 |
| [초대 거절](/docs/organization-post-account-reject) | Organization 초대 거절 - 초대받은 독립 계정 사용 가능 |
| [탈퇴 신청 목록 조회](/docs/organization-get-account-leave) | Organization 탈퇴 신청 목록 조회 - 마스터 계정 사용 가능 |
| [탈퇴 신청 승인 및 반려](/docs/organization-post-account-leave) | Organization 멤버 계정 탈퇴 신청 승인 또는 반려 - 마스터 계정 사용 가능 |
| [강제 탈퇴](/docs/organization-get-account-leave-force) | Organization 멤버 계정 강제 탈퇴 - 마스터 계정 사용 가능 |

### 계정 그룹

계정 그룹 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [계정 그룹 목록 조회](/docs/organization-get-group-tree) | Organization 계정 그룹 목록 조회 - 마스터 계정 사용 가능 |
| [계정 그룹 생성](/docs/organization-post-group) | Organization 계정 그룹 생성 - 마스터 계정 사용 가능 |
| [계정 그룹 삭제](/docs/organization-delete-group) | Organization 계정 그룹 삭제 - 마스터 계정 사용 가능 |
| [계정 그룹 이름 변경](/docs/organization-put-group) | Organization 계정 그룹 이름 변경 - 마스터 계정 사용 가능 |
| [계정 그룹 이동](/docs/organization-post-group-move) | Organization 계정 그룹 위치 이동 - 마스터 계정 사용 가능 |

### Quota Policy

Quota Policy(이용 한도 정책) 관련 API에 대한 설명은 다음과 같습니다.

| API | 설명 |
| --- | --- |
| [리전 목록 조회](/docs/organization-get-policy-region) | Quota Policy 적용 가능한 리전 조회 - 마스터 계정 사용 가능 |
| [리소스 카테고리 목록 조회](/docs/organization-get-policy-category) | Quota Policy 적용 가능한 리소스 카테고리 조회 - 마스터 계정 사용 가능 |
| [리소스 목록 조회](/docs/organization-get-policy-resource) | Quota Policy 적용 가능한 리소스 조회 - 마스터 계정 사용 가능 |
| [리소스 유형 목록 조회](/docs/organization-get-policy-detail) | Quota Policy 적용 가능한 리소스 상세 유형 조회 - 마스터 계정 사용 가능 |
| [리소스 이용 한도 조회](/docs/organization-get-policy-allotment) | Organization 계정별 리소스 이용 한도 상세 조회 - 마스터 계정 사용 가능 |
| [Quota Policy 목록 조회](/docs/organization-get-policy-list) | Quota Policy 목록 조회 - 마스터 계정 사용 가능 |
| [Quota Policy 생성](/docs/organization-post-policy) | Quota Policy 생성 - 마스터 계정 사용 가능 |
| [Quota Policy 삭제](/docs/organization-delete-policy) | Quota Policy 삭제 - 마스터 계정 사용 가능 |
| [Quota Policy 적용 조회](/docs/organization-get-policy-applied) | Organization 계정 그룹에 적용된 Quota Policy 조회 - 마스터 계정 사용 가능 |
| [Quota Policy 적용](/docs/organization-post-policy-apply) | Organization 계정 그룹에 Quota Policy 적용 - 마스터 계정 사용 가능 |
| [Quota Policy 적용 해제](/docs/organization-post-policy-remove) | Organization 계정 그룹에 적용된 Quota Policy 해제 - 마스터 계정 사용 가능 |

## Organization 연관 리소스

Organization API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.

- Organization API 사용 방법
  - [서명(시그니처) 생성](/docs/common-ncpapi): 요청 헤더에 추가할 서명 생성 방법
  - [API Gateway 사용 가이드](https://guide.ncloud-docs.com/docs/apigw-apigw-1): 요청 헤더에 추가할 API Key 발급
  - [Sub Account 사용 가이드](https://guide.ncloud-docs.com/docs/subaccount-overview): 요청 헤더에 추가할 Access Key 발급 방법
  - [Ncloud 공통 응답 상태 코드](/docs/common-ncpapi#%EC%9D%91%EB%8B%B5): Organization 서비스에서 사용하는 네이버 클라우드 플랫폼의 공통 응답 상태 코드 정보
- Organization 서비스 사용 방법
  - [Organization 사용 가이드](https://guide.ncloud-docs.com/docs/organization-overview): 네이버 클라우드 플랫폼 콘솔에서 Organization 사용하는 방법
  - [Ncloud 사용 환경 가이드](https://guide.ncloud-docs.com/docs/environment-environment-1-1): VPC, Classic 환경 및 지원 여부에 대한 가이드
  - [요금 소개, 특징, 상세 기능](https://www.ncloud.com/product/management/organization): Organization의 요금 체계, 특징, 상세 기능 요약
  - [서비스 최신 소식](https://www.ncloud.com/intro/news): Organization 서비스 관련 최신 소식
  - [자주 하는 질문](https://www.ncloud.com/support/faq/prod?categoryCode2=MGMT&categoryCode3=SV_0153&page=1): Organization 서비스 사용자들이 자주 하는 질문
  - [문의하기](https://www.ncloud.com/support/question/general): API 가이드를 통해서도 궁금증이 해결되지 않는 경우, 직접 문의