Skip to content
DocsOpenAPI spec

    Get Region Quota

    GET/v1/quotas/{region}

    Get quota usage and limits for the current organization in a single region

    Path ParametersExpand Collapse
    region: "us-sva-2" or "us-wdc-1"
    One of the following:
    "us-sva-2"
    "us-wdc-1"
    ReturnsExpand Collapse
    Quota object { compute, networking, nks, 3 more }

    Quota response.

    compute: QuotaCompute { memory_gb, vcpu }

    Compute quota.

    memory_gb: QuotaDimensionDetail { limit, remaining, used }

    Quota dimension detail.

    limit: number
    remaining: number
    used: number
    vcpu: QuotaDimensionDetail { limit, remaining, used }

    Quota dimension detail.

    limit: number
    remaining: number
    used: number
    networking: QuotaNetworking { public_ips, vpcs }

    Networking quota.

    public_ips: QuotaDimensionDetail { limit, remaining, used }

    Quota dimension detail.

    limit: number
    remaining: number
    used: number
    vpcs: QuotaDimensionDetail { limit, remaining, used }

    Quota dimension detail.

    limit: number
    remaining: number
    used: number
    nks: QuotaNKS { clusters, node_pool_memory_gb, node_pool_vcpu, public_ips }

    NKS quota.

    clusters: QuotaDimensionDetail { limit, remaining, used }

    Quota dimension detail.

    limit: number
    remaining: number
    used: number
    node_pool_memory_gb: QuotaDimensionDetail { limit, remaining, used }

    Quota dimension detail.

    limit: number
    remaining: number
    used: number
    node_pool_vcpu: QuotaDimensionDetail { limit, remaining, used }

    Quota dimension detail.

    limit: number
    remaining: number
    used: number
    public_ips: QuotaDimensionDetail { limit, remaining, used }

    Quota dimension detail.

    limit: number
    remaining: number
    used: number
    region: RegionName

    Region the resource is in.

    One of the following:
    "us-sva-2"
    "us-wdc-1"
    sandboxes: object { clusters, memory_gb, vcpu }

    Sandbox quota. vcpu and memory_gb count the nodes of the organization’s sandbox clusters in the region.

    clusters: QuotaDimensionDetail { limit, remaining, used }

    Quota dimension detail.

    limit: number
    remaining: number
    used: number
    memory_gb: QuotaDimensionDetail { limit, remaining, used }

    Quota dimension detail.

    limit: number
    remaining: number
    used: number
    vcpu: QuotaDimensionDetail { limit, remaining, used }

    Quota dimension detail.

    limit: number
    remaining: number
    used: number
    storage: QuotaStorage { abs, local_nvme, longhorn, object_storage }

    Storage quota. object_storage is the data stored in the organization’s buckets in the region, in GB (10^9 bytes), rounded up per project. It is measured periodically, so it can trail recent writes by several minutes and can exceed the limit. New buckets cannot be created once used reaches the limit; a limit of 0 means object storage is not available to the organization in the region.

    abs: QuotaDimensionDetail { limit, remaining, used }

    Quota dimension detail.

    limit: number
    remaining: number
    used: number
    local_nvme: QuotaDimensionDetail { limit, remaining, used }

    Quota dimension detail.

    limit: number
    remaining: number
    used: number
    longhorn: QuotaDimensionDetail { limit, remaining, used }

    Quota dimension detail.

    limit: number
    remaining: number
    used: number
    object_storage: QuotaDimensionDetail { limit, remaining, used }

    Quota dimension detail.

    limit: number
    remaining: number
    used: number

    Get Region Quota

    curl https://api.nirvanalabs.io/v1/quotas/$REGION \
        -H "Authorization: Bearer $NIRVANA_LABS_API_KEY"
    {
      "compute": {
        "memory_gb": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "vcpu": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        }
      },
      "networking": {
        "public_ips": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "vpcs": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        }
      },
      "nks": {
        "clusters": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "node_pool_memory_gb": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "node_pool_vcpu": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "public_ips": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        }
      },
      "region": "us-sva-2",
      "sandboxes": {
        "clusters": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "memory_gb": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "vcpu": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        }
      },
      "storage": {
        "abs": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "local_nvme": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "longhorn": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "object_storage": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        }
      }
    }
    Returns Examples
    {
      "compute": {
        "memory_gb": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "vcpu": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        }
      },
      "networking": {
        "public_ips": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "vpcs": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        }
      },
      "nks": {
        "clusters": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "node_pool_memory_gb": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "node_pool_vcpu": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "public_ips": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        }
      },
      "region": "us-sva-2",
      "sandboxes": {
        "clusters": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "memory_gb": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "vcpu": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        }
      },
      "storage": {
        "abs": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "local_nvme": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "longhorn": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        },
        "object_storage": {
          "limit": 32,
          "remaining": 24,
          "used": 8
        }
      }
    }