---
title: "Global ResourceManager view"
method: GET
path: "/api/global/resources"
tags: ["Global"]
---

# Global ResourceManager view

`GET /api/global/resources`

## Request

- The document declares no server URL.
- Auth: none declared

## Response `200`

OK

- ServerGlobalResourcesResponse
  - `agentList` ServerGlobalResourcesAgent[]: Agents the RM has placement for, each with the exact graphite token its per-agent series are keyed on (resourcemanager.agent.<token>.{dbu,apu,plan_dbu,plan_apu}) so the GUI targets them.
    - `cores` number
    - `name` string
    - `token` string
  - `agents` integer
  - `axes` ServerGlobalResourcesAxis[]
    - `axis` string: cpu|mem|io|disk|network
    - `capacityDbu` number: projected to DBU (0 for network)
    - `capacityRaw` number: native units
    - `consumedDbu` number: consumed on this axis (0 for network)
    - `source` string: config|agents
    - `unit` string: cores|MB|iops|GB|Mbps
  - `bindingAxis` string
  - `bindingAxisApu` string
  - `capacityApu` number: APU (Compute) infra view -- the SAME metal projected into APU (1c/2GB/10GB, no IO).
  - `capacityDbu` number
  - `capacityGwu` number: the same capacity in GWU (1 GWU = cloud18-marketplace-gwu-unit-mbit Mb/s)
  - `clusters` ServerGlobalResourcesCluster[]
    - `apu` number: real consumed APU pivot -- the cluster's share of infra APU
    - `cluster` string
    - `dbu` number: real consumed pivot (max axis) -- the cluster's share of infra DBU
    - `dbuCpu` number
    - `dbuDisk` number
    - `dbuIo` number
    - `dbuMem` number
    - `gwu` number: gateway bandwidth consumed, in GWU (#1872)
    - `planApu` number: the cluster's APU reservation contract (prov-service-plan-apu)
    - `planDbu` number: the cluster's DBU reservation contract (prov-service-plan-dbu)
    - `planGwu` number: its GWU plan: gateway capacity / clusters present, or pinned
    - `planStatefulDbu` number: their DBU reservation, own line (never in planDbu)
    - `servers` integer
    - `statefulDbu` number: real consumed DBU of the stateful apps (app-stateful)
  - `consumedApu` number
  - `consumedDbu` number
  - `consumedGwu` number: Σ clusters
  - `gatewayCapacityMbit` number
  - `gatewayDomains` string[]: Gateways: the shared uplinks the clusters' traffic is tracked against (#1872), Mb/s.
  - `ledger` ClusterResourceLedger
    - `borrowPot` ClusterUnitPots
      - `apu` number
      - `bku` number
      - `dbu` number
    - `borrowed` ClusterLedgerAxes
      - `cores` number
      - `diskBytes` number
      - `iops` number
      - `memBytes` number
    - `capacity` ClusterLedgerAxes
      - `cores` number
      - `diskBytes` number
      - `iops` number
      - `memBytes` number
    - `known` boolean
    - `overCommitPot` ClusterLedgerAxes
      - `cores` number
      - `diskBytes` number
      - `iops` number
      - `memBytes` number
    - `overdrawn` boolean: an over-commit pot axis is negative: borrowed resources must give way
    - `planPot` ClusterLedgerAxes
      - `cores` number
      - `diskBytes` number
      - `iops` number
      - `memBytes` number
    - `planPotUnits` ClusterUnitPots
      - `apu` number
      - `bku` number
      - `dbu` number
    - `quotaPct` number
    - `reserved` ClusterLedgerAxes
      - `cores` number
      - `diskBytes` number
      - `iops` number
      - `memBytes` number
    - `reservedUnits` ClusterUnitPots
      - `apu` number
      - `bku` number
      - `dbu` number
    - `sellable` ClusterLedgerAxes
      - `cores` number
      - `diskBytes` number
      - `iops` number
      - `memBytes` number
  - `quotaPct` number
  - `slackApu` number
  - `slackDbu` number
  - `unitRatios` object: the manager's ratios, the page's only source of unit arithmetic
  - `usableApu` number
  - `usableDbu` number
  - `usableGwu` number: = capacity: the uplink has no quota

## Changes

- **2026-10-05** `1bf429f49b60`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/changes/api/global/resources/get.md)

---

[API](https://skmtc.dev/signal18/apis/signal-18-dashboard-api.md) - [All operations](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signal18/apis/signal-18-dashboard-api/revisions/8ee8a1e31294?raw)