Cuotas

Ubicación en el admin: Services › Virtual Machines › Policy › Quota tab (/vm/policy?tab=quota). Por cliente: Customers › List › a customer › Overview (/customers/<id>), tarjeta Quota. Ubicación en el portal: Client › Quotas (/client/quotas).

Qué hace

Las cuotas protegen contra abusos de cuentas nuevas: cuanto más saldo real haya ingresado un cliente en su cuenta, más recursos podrá crear. Hay dos niveles:

• Recursos de VM y Kubernetes: total de vCPU, RAM y disco, y el número de VM. Los niveles son sus planes fijos.
• Cuotas de servicio: cantidad de IP, clústeres, VPC, GB de almacenamiento, etcétera, en cinco niveles (L0 a L4) determinados por el dinero depositado.

Las cuotas se comprueban antes de realizar cualquier cargo. Toda solicitud que supere el límite se rechaza con HTTP 403 quota_exceeded y un mensaje que indica al cliente cuánto debe recargar.

Requisitos

Elemento	Requisito
Rol	Un administrador.
Interruptor	Enable quota (quota_enabled) está desactivado por defecto. Nada de lo indicado a continuación se aplicará hasta que lo active.
Planes fijos	Al menos un plan no personalizado (consulte Plans): los niveles de recursos son sus planes fijos. Sin ningún plan, solo se aplica la regla de recuento de VM.
Dependencias	Las filas de cuotas de servicio solo existen para los productos que estén habilitados en su instalación (VPN, IPv6 proxy, Kubernetes, Private Cloud, Images, Object Storage, Dedicated).

Cómo se calcula la base

NexCMP no solo considera los pagos con tarjeta. La base es el saldo asentado en el monedero del cliente: las recargas por pasarela, los créditos de administrador (Credit / debit) y los vales de monedero canjeados cuentan una vez a través del libro de contabilidad del monedero. Los descuentos de pedidos y los créditos de servicio derivados de códigos promocionales no son saldo del monedero y no cuentan. La base máxima que un cliente haya alcanzado alguna vez se mantiene (por sitio): los gastos o reembolsos nunca rebajan un nivel ya desbloqueado.

Recursos de VM y Kubernetes

1. Los niveles son los planes fijos del sitio, ordenados por el costo de ejecutarlos durante 24 horas.
2. El cliente se ubica en el nivel más alto cuyo costo de 24 horas no supere su base. El límite corresponde a la vCPU, RAM y disco de dicho plan. Un cliente que no pueda cubrir ni siquiera el plan más económico seguirá obteniendo los recursos del plan más económico.
3. El uso contabilizado para el límite incluye todas las VM activas (incluidas las bloqueadas), los volúmenes de datos adquiridos (incluso si están desconectados) y los nodos de trabajo y planos de control de Kubernetes (los nodos de trabajo también cuentan como VM).
4. Recuento de VM: hasta Max VMs at 24h tier (predeterminado: 2). A partir de la siguiente VM, el saldo actual del monedero del cliente debe cubrir 30 días (720 horas) de todas sus VM existentes más la nueva, hasta Max VMs when meeting 30-day threshold (predeterminado: 10).
5. Crear una VM también requiere un saldo de al menos N horas de esa VM (Create VM: balance ≥ N hours, predeterminado: 2) y el saldo mínimo de la plataforma.
6. Reducir el tamaño de una VM nunca se bloquea. Solo se comprueba la dimensión que aumenta, por lo que un cliente que supere el límite de disco aún puede añadir vCPU si el límite de vCPU lo permite.

Configurar

1. Abra Services › Virtual Machines › Policy y seleccione la pestaña Quota.

2. Active Enable quota.

3. Revise los tres números (todos editables):

   Campo	Predeterminado	Rango
   Crear VM: saldo ≥ N horas	2	1 a 720
   Max VMs at 24h tier	2	1 a 100
   Máximo de VM al cumplir el umbral de 30 días	10	1 a 1000 (no inferior al campo anterior)

4. En Tier-based service quotas, edite la tabla (a continuación).

5. Haga clic en Save. NexCMP solicitará un motivo, que se registrará en el registro de auditoría junto con los valores anteriores y nuevos. El cambio se aplica a todos los clientes.

Tabla de cuotas de servicio

La tabla tiene cinco niveles. Las celdas de encabezado L0 a L4 contienen el umbral de depósito en centavos: los valores predeterminados 0, 1000, 5000, 20000, 100000 corresponden a L0 para una cuenta nueva, L1 a partir de $10, L2 a partir de $50, L3 a partir de $200 y L4 a partir de $1,000. El primer umbral debe permanecer en 0. Cada fila define la cuota de una clave por nivel; -1 significa ilimitado.

Clave	Significado	L0	L1	L2	L3	L4
vpn.ips	Direcciones IP de VPN	2	10	30	100	500
proxy6.ips	Direcciones IP de proxy IPv6	500	2000	10000	50000	-1
dedicated.servers	Servidores bare-metal	1	2	5	20	50
s3.storage_gb	GB asignados de Object Storage	2048	4096	10240	51200	-1
k8s.clusters	Clústeres de Kubernetes	1	2	5	10	30
k8s.workers	Nodos de trabajo de Kubernetes	3	9	18	50	200
vpc.count	Redes de Private Cloud	1	2	5	10	30
images.gb	GB de almacenamiento de imágenes personalizadas	50	100	200	500	2000

La tabla también enumera algunas filas de productos que no forman parte de esta versión; déjelas sin cambios. Si el producto de una clave está desactivado, esta se oculta y nunca se aplica. El valor debe ser -1 o situarse entre 0 y 10,000,000.

Las cuotas de servicio siguen la base de fondos, al igual que los niveles de VM: el saldo de monedero más alto alcanzado, no el total de pagos con tarjeta. Los clientes de revendedores utilizan los mismos valores predeterminados y el revendedor solo puede verlos.

Excepciones por cliente

1. Abra Customers › List, luego el cliente. En Overview busque la tarjeta Quota.

2. Recursos de VM: haga clic en Quota override y elija una de las siguientes opciones:

   • By top-up balance (remove override): comportamiento predeterminado;
   • Unlimited (including VM count): elimina cualquier límite para este cliente;
   • un nivel de plan: fija el límite máximo de recursos a ese plan; la regla de cantidad de VM se sigue aplicando.

   Introduzca un motivo. Los administradores de la plataforma pueden definir cualquier nivel; una excepción establecida por un revendedor no puede superar la base retenida del cliente.

3. Servicios: la tabla bajo Service quotas muestra cada clave con In use, el límite efectivo y su Source (nivel o excepción). Haga clic en Edit en una fila, escriba la New quota (-1 = ilimitado, vacío = volver al valor predeterminado del nivel) y un motivo.

Cada excepción se registra en el registro de auditoría con el administrador, el motivo y los valores anteriores y posteriores.

Lo que ve el cliente

Client › Quotas (/client/quotas) muestra el nivel actual del cliente, la cantidad en uso y total de vCPU, RAM, disco y número de VM (desglosado entre VM y Kubernetes), el saldo de monedero apto, la base de recursos retenida (no disminuye al gastar) y cuánto recargar para alcanzar el siguiente nivel. Un control deslizante permite elegir un nivel objetivo e ir directamente a la pantalla de depósito. La tarjeta Service Quotas enumera cada servicio con su cuota, la cantidad utilizada, su nivel (L0 a L4), cuánto más depositar para el siguiente nivel y un botón Request increase que abre un borrador de ticket de soporte. Un botón Quota policy explica las reglas.

Verificación

1. Active Enable quota y utilice un nuevo cliente de prueba con un saldo de $0.
2. Intente crear una VM superior a su plan más económico. La solicitud se rechazará con quota_exceeded y el mensaje "Exceeds the resources of tier ... Top up $X more to unlock tier ...".
3. Recargue la cantidad indicada. El nivel cambiará de inmediato y la misma solicitud se completará con éxito.
4. Compre direcciones IP de VPN por encima del límite de L0: HTTP 403 quota_exceeded con "scope":"service" y un enlace a /client/quotas.
5. En la tarjeta Quota del cliente, Source muestra tier; configure una excepción y compruebe cómo cambia a override.

Límites y notas

• Desactivado significa desactivado. Con quota_enabled desactivado, la regla anterior new_account_max_vms (Services › Virtual Machines › Policy › Sales) limita las cuentas nuevas a 2 VM hasta que sus depósitos alcancen los $10. Cuando la cuota está activada, dicha regla ya no se aplica.
• Las VM creadas por administradores no se bloquean.
• Los errores fallan de forma segura. Si no se puede leer el estado de la cuota, la solicitud se rechaza con quota_unavailable en lugar de permitirse.
• Las solicitudes de API, CLI y MCP utilizan los mismos controladores, por lo que se aplican los mismos límites.
• El crédito de promoción no aumenta de nivel (consulte Promociones).
• Los umbrales de nivel son centavos, no dólares.

Resolución de problemas

Síntoma	Causa	Solución
quota_exceeded, motivo resources	El nuevo total de vCPU/RAM/disco supera el nivel	Recargue el importe indicado en el mensaje o establezca una excepción.
quota_exceeded, motivo vm_30d	Supera la cantidad de VM del nivel de 24 h y el saldo aún no cubre 30 días de la flota	Recargue el importe mostrado.
quota_exceeded, motivo vm_max	Se ha alcanzado el límite absoluto de VM	Aumente Max VMs when meeting 30-day threshold o use una excepción.
quota_exceeded, scope: service	Se ha alcanzado un límite por servicio	Aumente el valor en la tabla o anule esa clave para el cliente.
quota_unavailable	No se pudo verificar el estado de la cuota	Reintente; consulte el registro del servidor si persiste.
"quota_max_vms_30d must be >= quota_max_vms_24h" al guardar	Valores invertidos	Haga que el valor de 30 días sea al menos igual al de 24 horas.
El cliente indica que el nivel se redujo	No se reduce; compare Held resource basis con el costo del plan	Consulte la lista de precios del plan: un aumento de precio del plan puede alterar los umbrales.