Skip to content
DocsOpenAPI spec

    Get Region Quota

    $ nirvana quotas get
    GET/v1/quotas/{region}

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

    ParametersExpand Collapse
    --region: "us-sva-2" or "us-wdc-1"

    Region name

    ReturnsExpand Collapse
    quota: object { compute, networking, nks, 3 more }

    Quota response.

    compute: object { memory_gb, vcpu }

    Compute quota.

    memory_gb: object { limit, remaining, used }

    Quota dimension detail.

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

    Quota dimension detail.

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

    Networking quota.

    public_ips: object { limit, remaining, used }

    Quota dimension detail.

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

    Quota dimension detail.

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

    NKS quota.

    clusters: object { limit, remaining, used }

    Quota dimension detail.

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

    Quota dimension detail.

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

    Quota dimension detail.

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

    Quota dimension detail.

    limit: number
    remaining: number
    used: number
    region: "us-sva-2" or "us-wdc-1"

    Region the resource is in.

    "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: object { limit, remaining, used }

    Quota dimension detail.

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

    Quota dimension detail.

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

    Quota dimension detail.

    limit: number
    remaining: number
    used: number
    storage: object { 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: object { limit, remaining, used }

    Quota dimension detail.

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

    Quota dimension detail.

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

    Quota dimension detail.

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

    Quota dimension detail.

    limit: number
    remaining: number
    used: number

    Get Region Quota

    nirvana quotas get \
      --api-key 'My API Key' \
      --region us-sva-2
    {
      "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
        }
      }
    }