Skip to content
DocsOpenAPI spec

    List Quotas

    GET/v1/quotas

    List quota usage and limits for the current organization across all regions

    Query ParametersExpand Collapse
    cursor: optional string

    Pagination cursor returned by a previous request. Only valid for the same filters and sort order.

    limit: optional number

    Maximum number of items to return

    maximum100
    minimum10
    region: optional string

    Filter by region

    sort: optional string

    Comma-separated sort terms in precedence order, each field:asc or field:desc. Fields: region

    ReturnsExpand Collapse
    QuotaList object { items, pagination }
    items: array of Quota { compute, networking, nks, 3 more }
    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

    List Quotas

    curl https://api.nirvanalabs.io/v1/quotas \
        -H "Authorization: Bearer $NIRVANA_LABS_API_KEY"
    {
      "items": [
        {
          "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
            }
          }
        }
      ],
      "pagination": {
        "next_cursor": "RhwniMT4B74siYZcPF8TnCdGI1l9rpPvg",
        "previous_cursor": "ARhwnmi1hA7wEbHbMjdYQlOB_ZusP4fYvw",
        "total_count": 125
      }
    }
    Returns Examples
    {
      "items": [
        {
          "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
            }
          }
        }
      ],
      "pagination": {
        "next_cursor": "RhwniMT4B74siYZcPF8TnCdGI1l9rpPvg",
        "previous_cursor": "ARhwnmi1hA7wEbHbMjdYQlOB_ZusP4fYvw",
        "total_count": 125
      }
    }