---
title: 할당량
description: 고객이 지갑을 충전하기 전까지 신규 고객이 생성할 수 있는 리소스를 제한하세요. VM 리소스 계층, VM 수, 서비스별 할당량 및 고객별 재정의를 지원합니다.
url: https://nexcmp.com/ko/docs/billing/quotas/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# 할당량 {#quotas}

> **관리자 위치:** Services › Virtual Machines › Policy › Quota 탭(`/vm/policy?tab=quota`). 고객별: Customers › List › a customer › Overview(`/customers/<id>`), **Quota** 카드. **포털 위치:** Client › Quotas(`/client/quotas`).

## 작동 내용 {#what-it-does}

할당량은 신규 계정의 어뷰징으로부터 시스템을 보호합니다. 고객이 지갑에 실제 자금을 많이 충전할수록 더 많은 리소스를 생성할 수 있습니다. 여기에는 두 가지 계층이 있습니다:

- **VM 및 Kubernetes 리소스**: 총 vCPU, RAM 및 디스크와 VM 수. 티어는 고정 플랜입니다.
- **서비스 할당량**: 입금액에 따라 결정되는 5개의 티어(L0부터 L4까지)에 따른 IP, 클러스터, VPC, 저장소 GB 등의 수량입니다.

할당량은 요금이 청구되기 **전에** 확인됩니다. 한도를 초과한 요청은 HTTP 403 `quota_exceeded` 및 고객에게 필요한 충전 금액을 안내하는 메시지와 함께 거부됩니다.

## 요구 사항 {#requirements}

| 항목 | 요구 사항 |
|---|---|
| 역할 | 관리자. |
| 스위치 | **Enable quota**(`quota_enabled`)는 기본적으로 **꺼져** 있습니다. 활성화하기 전까지 아래 내용은 적용되지 않습니다. |
| 고정 플랜 | 적어도 하나의 커스텀이 아닌 플랜([Plans](https://nexcmp.com/ko/docs/catalog/plans/) 참조) — 리소스 티어는 고정 플랜입니다. 플랜이 없는 경우 VM 수 규칙만 적용됩니다. |
| 의존성 | 서비스 할당량 행은 설치 시 활성화된 제품(VPN, IPv6 프록시, Kubernetes, 프라이빗 클라우드, 이미지, Object Storage, 전용 서버)에만 존재합니다. |

## 기준 계산 방식 {#how-the-basis-is-calculated}

NexCMP는 카드 결제만 확인하지 않습니다. **기준**은 고객의 **기록된 지갑 잔액**입니다. 게이트웨이 충전, 관리자 크레딧(**Credit / debit**) 및 적립된 지갑 바우처 모두 지갑 원장을 통해 한 번씩 합산됩니다. 프로모션 코드의 주문 할인 및 서비스 크레딧은 지갑 자금이 아니므로 합산되지 않습니다. 고객이 도달한 최고 기준은 사이트별로 **유지**되며, 사용이나 환불로 인해 이미 달성된 티어가 낮아지지 않습니다.

### VM 및 Kubernetes 리소스 {#vm-and-kubernetes-resources}

1. 티어는 24시간 운영 비용을 기준으로 정렬된 사이트의 고정 플랜입니다.
2. 고객은 24시간 비용이 자신의 기준을 초과하지 않는 가장 높은 티어에 속하게 됩니다. 한도는 해당 플랜의 vCPU, RAM 및 디스크입니다. 가장 저렴한 플랜조차 감당할 수 없는 고객에게도 가장 저렴한 플랜의 리소스가 제공됩니다.
3. 한도에 합산되는 사용량은 실행 중인 모든 VM(잠긴 VM 포함), 구매한 데이터 볼륨(분리된 경우도 포함), Kubernetes 워커 및 제어 평면(워커도 VM으로 합산)입니다.
4. **VM 수:** **Max VMs at 24h tier**(기본값 2)까지 허용됩니다. 다음 VM부터는 고객의 *현재* 지갑 잔액이 기존 모든 VM과 신규 VM을 합산한 **30일(720시간)** 분량의 비용을 충족해야 하며, 최대 **Max VMs when meeting 30-day threshold**(기본값 10)까지 허용됩니다.
5. **VM 생성** 시에는 해당 VM의 최소 **N시간** 분량 잔액(**Create VM: balance ≥ N hours**, 기본값 2)과 플랫폼 최소 잔액도 필요합니다.
6. VM 크기를 줄이는 것은 차단되지 않습니다. 증가하는 항목만 확인하므로 디스크 한도를 초과한 고객이라도 vCPU 한도가 허용한다면 vCPU를 추가할 수 있습니다.

## 구성 {#configure}

1. **Services › Virtual Machines › Policy**를 열고 **Quota** 탭을 선택합니다.
2. **Enable quota**를 켭니다.
3. 세 가지 숫자(모두 편집 가능)를 검토합니다:

   | 필드 | Default | 범위 |
   |---|---|---|
   | VM 생성: 잔액 ≥ N시간 | 2 | 1 ~ 720 |
   | Max VMs at 24h tier | 2 | 1 ~ 100 |
   | 30일 임계값 충족 시 최대 VM 수 | 10 | 1 ~ 1000 (이전 필드보다 작을 수 없음) |

4. **Tier-based service quotas**에서 표(아래)를 편집합니다.
5. **Save**를 클릭합니다. NexCMP가 **사유(reason)**를 입력받으며, 이는 변경 전후의 값과 함께 감사 로그에 기록됩니다. 변경 사항은 모든 고객에게 적용됩니다.

![활성화 스위치, VM 한도 및 티어 기반 서비스 할당량 표가 있는 Quota 탭](https://nexcmp.com/ko/docs/images/billing/quotas-01-policy.webp)

### 서비스 할당량 표 {#service-quota-table}

이 표는 5개의 등급으로 구성됩니다. **L0**부터 **L4**까지의 헤더 셀은 **센트 단위의 예치금 임계값**을 나타냅니다. 기본값 `0, 1000, 5000, 20000, 100000`은 신규 계정의 경우 L0, $10 이상은 L1, $50 이상은 L2, $200 이상은 L3, $1,000 이상은 L4를 의미합니다. 첫 번째 임계값은 `0` 상태로 유지되어야 합니다. 각 행은 등급별로 키 하나의 할당량을 설정하며, **-1은 무제한**을 의미합니다.

| 키 | 의미 | L0 | L1 | L2 | L3 | L4 |
|---|---|---|---|---|---|---|
| `vpn.ips` | VPN IP | 2 | 10 | 30 | 100 | 500 |
| `proxy6.ips` | IPv6 프록시 IP | 500 | 2000 | 10000 | 50000 | -1 |
| `dedicated.servers` | 베어메탈 서버 | 1 | 2 | 5 | 20 | 50 |
| `s3.storage_gb` | 할당된 Object Storage GB | 2048 | 4096 | 10240 | 51200 | -1 |
| `k8s.clusters` | Kubernetes 클러스터 | 1 | 2 | 5 | 10 | 30 |
| `k8s.workers` | Kubernetes 워커 노드 | 3 | 9 | 18 | 50 | 200 |
| `vpc.count` | Private Cloud 네트워크 | 1 | 2 | 5 | 10 | 30 |
| `images.gb` | 커스텀 이미지 스토리지 GB | 50 | 100 | 200 | 500 | 2000 |

이 표에는 이번 릴리스에 포함되지 않은 제품에 대한 몇 가지 행도 나열되어 있으며, 해당 행은 변경하지 마십시오. 제품이 비활성화된 키는 숨겨지며 적용되지 않습니다. 값은 `-1`이거나 `0`과 `10,000,000` 사이여야 합니다.

서비스 할당량은 VM 등급과 마찬가지로 카드 결제 총액이 아닌 도달한 최고 지갑 잔액인 **자금 기준**을 따릅니다. 리셀러 고객은 동일한 기본값을 사용하며, 리셀러는 이를 조회만 할 수 있습니다.

## 고객별 재할당 {#per-customer-overrides}

1. **Customers › List**를 연 다음 해당 고객을 엽니다. **Overview**에서 **Quota** 카드를 찾습니다.
2. **VM 리소스:** **Quota override**를 클릭하고 다음 중 하나를 선택합니다.
   - **충전 잔액 기준(재할당 제거)** — 기본 동작입니다.
   - **무제한(VM 수 포함)** — 이 고객에 대한 모든 제한을 제거합니다.
   - **플랜 등급** — 리소스 상한선을 해당 플랜으로 고정하며, VM 수 규칙은 계속 적용됩니다.

   사유를 입력하세요. 플랫폼 관리자는 모든 등급을 설정할 수 있으며, 리셀러가 설정한 재할당은 고객의 보관된 기준을 초과할 수 없습니다.
3. **서비스:** *Service quotas* 아래의 표에는 각 키의 *In use*, 유효 제한 및 해당 *Source*(등급 또는 재할당)가 표시됩니다. 행의 **Edit**을 클릭하고 **New quota**(`-1` = 무제한, 비워둠 = 등급 기본값으로 복원)와 사유를 입력합니다.

![등급, 리소스 사용량, 재할당이 포함된 서비스 할당량 표가 있는 Customer Quota 카드](https://nexcmp.com/ko/docs/images/billing/quotas-02-customer.webp)

모든 재할당은 관리자, 사유 및 변경 전후 값과 함께 감사 로그에 기록됩니다.

## 고객 화면 {#what-the-customer-sees}

**Client › Quotas**(`/client/quotas`)는 고객의 **현재 등급**, 사용된 vCPU·RAM·disk 및 VM 총수(VM과 Kubernetes로 분할), **적격 지갑 잔액**, **보유 리소스 기준**(소비해도 감소하지 않음), 그리고 다음 등급까지 충전해야 할 금액을 보여줍니다. 슬라이더를 통해 목표 등급을 선택하고 예치금 화면으로 바로 이동할 수 있습니다. **Service Quotas** 카드는 각 서비스의 할당량, 사용량, 등급(L0~L4), 다음 등급을 위해 추가로 예치해야 할 금액, 그리고 지원 티켓 초안을 여는 **Request increase** 버튼을 나열합니다. **Quota policy** 버튼은 규칙을 설명합니다.

![현재 등급, 리소스 사용량 및 서비스 할당량이 표시된 Portal Quotas 페이지](https://nexcmp.com/ko/docs/images/billing/quotas-03-portal.webp)

## 확인 {#verify}

1. **Enable quota**를 켜고 잔액이 $0인 새로운 테스트 고객을 사용합니다.
2. 가장 저렴한 플랜보다 더 큰 VM을 생성해 보십시오. `quota_exceeded` 및 "Exceeds the resources of tier ... Top up $X more to unlock tier ..." 메시지와 함께 요청이 거부됩니다.
3. 표시된 금액을 충전하십시오. 등급이 즉시 변경되며 동일한 요청이 성공합니다.
4. L0 한도를 초과하여 VPN IP를 구매합니다: HTTP 403 `quota_exceeded`(`"scope":"service"` 및 `/client/quotas` 링크 포함).
5. 고객의 Quota 카드에서 **Source**는 *tier*를 표시하며, 재할당을 설정하면 *override*로 변경되는 것을 확인할 수 있습니다.

## 한도 및 참고 사항 {#limits-notes}

- **끄면 꺼집니다.** `quota_enabled`이(가) 꺼져 있으면 이전 규칙 `new_account_max_vms`(**Services › Virtual Machines › Policy › Sales**)에 따라 신규 계정은 예치금이 $10에 도달할 때까지 VM이 2개로 제한됩니다. 할당량이 켜져 있으면 해당 규칙은 더 이상 적용되지 않습니다.
- **관리자가 생성한 VM은 차단되지 않습니다.**
- **오류 발생 시 차단됩니다.** 할당량 상태를 읽을 수 없는 경우, 요청은 허용되는 대신 `quota_unavailable`(으)로 거부됩니다.
- **API, CLI 및 MCP** 요청은 동일한 핸들러를 사용하므로 동일한 제한이 적용됩니다.
- **프로모션 크레딧**은 등급을 높이지 않습니다([Promotions](https://nexcmp.com/ko/docs/billing/promotions/) 참조).
- **등급 임계값은 달러가 아니라 센트**입니다.

## Troubleshooting {#troubleshooting}

| 증상 | 원인 | 해결 방법 |
|---|---|---|
| `quota_exceeded`, 사유 `resources` | 새로운 총 vCPU/RAM/디스크가 등급을 초과함 | 메시지에 표시된 금액을 충전하거나 오버라이드를 설정하세요. |
| `quota_exceeded`, 사유 `vm_30d` | 24시간 등급 VM 수를 초과하고 지갑이 아직 30일간의 플릿을 충족하지 못함 | 표시된 금액을 충전하세요. |
| `quota_exceeded`, 사유 `vm_max` | 절대 VM 상한선에 도달함 | **Max VMs when meeting 30-day threshold**를 상향하거나 개별 설정을 사용하십시오. |
| `quota_exceeded`, `scope: service` | 서비스별 제한에 도달함 | 테이블 값을 높이거나 해당 고객의 키를 오버라이드하세요. |
| `quota_unavailable` | 할당량 상태를 확인할 수 없음 | 다시 시도하고, 지속될 경우 서버 로그를 확인하세요. |
| 저장 시 "quota_max_vms_30d must be >= quota_max_vms_24h" | 값 뒤바뀜 | 30일 숫자를 최소한 24시간 숫자로 만드세요. |
| 고객이 등급이 하락했다고 함 | 하락하지 않습니다; **Held resource basis**을(를) 플랜 비용과 비교하세요. | 플랜 가격표를 확인하세요: 플랜 가격 인상으로 인해 임계값이 이동할 수 있습니다. |