---
title: "Get global quotas"
method: GET
path: "/quotas"
tags: ["Quotas"]
---

# Get global quotas

`GET /quotas`

Get the cluster-wide resource quota configuration, together with the current utilization it is measured against.
The configuration is the same on every peer, but the reported utilization is for the node serving this request only -
memory and disk are node-local, so query each peer to see where the whole cluster stands.

## Response `200`

successful operation

- object
  - `usage` union
    - Usage — Usage of the hardware resources, spent to process the request
      - `hardware` union
        - HardwareUsage — Usage of the hardware resources, spent to process the request
          - `cpu` integer, required
          - `payload_io_read` integer, required
          - `payload_io_write` integer, required
          - `payload_index_io_read` integer, required
          - `payload_index_io_write` integer, required
          - `vector_io_read` integer, required
          - `vector_io_write` integer, required
        - unknown
      - `inference` union
        - InferenceUsage
          - `models` object, required
        - unknown
    - unknown
  - `time` number, float — Time spent to process this request
  - `status` string
  - `result` QuotaStatus — Quota configuration in effect, and how close each peer is to it. The configuration is cluster-wide; the utilization is not. `usage` is the node that served the request, and `peers` is what every peer that answered reports about itself — memory and disk are node-local, so one peer being under its limit says nothing about the others.
    - `config` QuotaConfig, required — Cluster-wide limits on node resources. An unset limit means the corresponding resource is not capped. Limits are only enforced while `enabled` is true.
      - `enabled` boolean — Whether the limits below are enforced.
      - `max_resident_memory_percent` integer, nullable — Reject memory-consuming updates once process resident memory reaches this percentage of total system memory (or of the cgroup limit, if one applies).
      - `max_disk_usage_percent` integer, nullable — Reject disk-consuming updates once the filesystem hosting the storage directory is filled to this percentage of its capacity.
      - `release_margin_percent` integer, nullable — How many percentage points below its limit a resource has to fall before this node starts accepting work again. Without a margin, a resource resting on its limit crosses it in both directions on the noise between two readings, putting the node in and out of service each time — and restarting a shard recovery with it. Raise it where usage is volatile; `0` disables the margin and releases as soon as usage is back under the limit. Unset leaves the built-in default in force, so a config written today does not pin a number that a later release may want to revise.
    - `usage` QuotaUsage, required — Utilization of the quota-managed resources **on this node alone** — memory and disk are node-local, so a peer under its limit says nothing about the rest of the cluster. A field is `null` when the platform does not expose the underlying stat.
      - `resident_memory_percent` integer, nullable — Resident memory of this node's process, as a percentage of the memory available to it (cgroup limit if one applies, else total system memory).
      - `disk_usage_percent` integer, nullable — Used space of this node's storage filesystem, as a percentage of its capacity.
    - `peers` object, nullable — Utilization reported by each peer, keyed by peer ID, including the one that served the request. Only peers that answered are listed: a peer missing from the map could not be reached, which is itself worth seeing. Absent entirely outside distributed mode, where there are no peers to ask.

## Other responses

- `default` — error
- `4XX` — error

---

[API](https://skmtc.net/qdrant/apis/qdrant-api.md) · [All operations](https://skmtc.net/qdrant/apis/qdrant-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qdrant/qdrant-api/revisions/d08b1f613f29/schema)