Copy page

Cloud Platform

Quotas

Unikraft Cloud enforces per-account resource quotas to govern how many instances, service groups, volumes, and compute resources you can provision. Use the quotas endpoint to inspect your current usage and limits.

Endpoints

Code
GET /users/quotas
GET /users/{uuid}/quotas

GET /users/quotas (no UUID) returns the quota for the authenticated user.

Response structure

The response contains a top-level quotas array. Each element has three sections: used, hard, and limits.

used: Current resource usage

Field	Type	Description
instances	int	Total number of instances (stopped + running).
live_instances	int	Number of currently running instances.
live_vcpus	int	Number of vCPUs in use across running instances.
live_memory_mb	int	Memory (MB) in use across running instances.
service_groups	int	Number of allocated service groups.
services	int	Number of allocated services (published ports).
volumes	int	Number of allocated volumes.
total_volume_mb	int	Total volume storage in use (MB).

hard: Maximum allowed allocations

Field	Type	Description
instances	int	Maximum number of instances.
live_vcpus	int	Maximum vCPUs running simultaneously.
live_memory_mb	int	Maximum memory (MB) running simultaneously.
service_groups	int	Maximum number of service groups.
services	int	Maximum number of services.
volumes	int	Maximum number of volumes.
total_volume_mb	int	Maximum total volume storage (MB).

limits: Per-resource range constraints

These define the minimum and maximum values you can specify when creating individual resources.

Field	Type	Description
min_memory_mb	int	Minimum memory (MB) per instance.
max_memory_mb	int	Maximum memory (MB) per instance.
min_vcpus	int	Minimum vCPUs per instance.
max_vcpus	int	Maximum vCPUs per instance.
min_volume_mb	int	Minimum volume size (MB).
max_volume_mb	int	Maximum volume size (MB).
min_autoscale_size	int	Minimum autoscale group size.
max_autoscale_size	int	Maximum autoscale group size.

Example

Set UKC_TOKEN and UKC_METRO for the API call:

curl -X GET \
    -H "Authorization: Bearer $UKC_TOKEN" \
    -H "Content-Type: application/json" \
    "https://api.$UKC_METRO.unikraft.cloud/v1/users/quotas"

{
  "quotas": [
    {
      "status": "ok",
      "uuid": "a1b2c3d4-...",
      "used": {
        "instances": 3,
        "live_instances": 2,
        "live_vcpus": 2,
        "live_memory_mb": 512,
        "service_groups": 2,
        "services": 4,
        "volumes": 1,
        "total_volume_mb": 512
      },
      "hard": {
        "instances": 50,
        "live_vcpus": 16,
        "live_memory_mb": 4096,
        "service_groups": 20,
        "services": 40,
        "volumes": 20,
        "total_volume_mb": 20480
      },
      "limits": {
        "min_memory_mb": 16,
        "max_memory_mb": 4096,
        "min_vcpus": 1,
        "max_vcpus": 8,
        "min_volume_mb": 128,
        "max_volume_mb": 10240,
        "min_autoscale_size": 0,
        "max_autoscale_size": 10
      }
    }
  ]
}

Learn more

• Unikraft Cloud's REST API reference
• Instances
• Volumes
• Services