---
title: "GET /nodecounts"
method: GET
path: "/nodecounts"
tags: ["Pools"]
---

# GET /nodecounts

`GET /nodecounts`

Gets the number of Compute Nodes in each state, grouped by Pool. Note that the
numbers returned may not always be up to date. If you need exact node counts,
use a list query.

## Query parameters

- `api-version` string, required
- `timeOut` integer
- `maxresults` integer
- `$filter` string

## Headers

- `client-request-id` string
- `return-client-request-id` boolean
- `ocp-date` string, date-time-rfc7231

## Response `200`

The request has succeeded.

- BatchPoolNodeCountsListResult — The result of listing the Compute Node counts in the Account.
  - `value` BatchPoolNodeCounts[] — A list of Compute Node counts by Pool.
    - `poolId` string, required — The ID of the Pool.
    - `dedicated` BatchNodeCounts — The number of Compute Nodes in each Compute Node state.
      - `creating` integer, required — The number of Compute Nodes in the creating state.
      - `idle` integer, required — The number of Compute Nodes in the idle state.
      - `offline` integer, required — The number of Compute Nodes in the offline state.
      - `preempted` integer, required — The number of Compute Nodes in the preempted state.
      - `rebooting` integer, required — The count of Compute Nodes in the rebooting state.
      - `reimaging` integer, required — The number of Compute Nodes in the reimaging state.
      - `running` integer, required — The number of Compute Nodes in the running state.
      - `starting` integer, required — The number of Compute Nodes in the starting state.
      - `startTaskFailed` integer, required — The number of Compute Nodes in the startTaskFailed state.
      - `leavingPool` integer, required — The number of Compute Nodes in the leavingPool state.
      - `unknown` integer, required — The number of Compute Nodes in the unknown state.
      - `unusable` integer, required — The number of Compute Nodes in the unusable state.
      - `waitingForStartTask` integer, required — The number of Compute Nodes in the waitingForStartTask state.
      - `deallocated` integer, required — The number of Compute Nodes in the deallocated state.
      - `deallocating` integer, required — The number of Compute Nodes in the deallocating state.
      - `total` integer, required — The total number of Compute Nodes.
      - `upgradingOS` integer, required — The number of Compute Nodes in the upgradingOS state.
    - `lowPriority` BatchNodeCounts — The number of Compute Nodes in each Compute Node state.
      - `creating` integer, required — The number of Compute Nodes in the creating state.
      - `idle` integer, required — The number of Compute Nodes in the idle state.
      - `offline` integer, required — The number of Compute Nodes in the offline state.
      - `preempted` integer, required — The number of Compute Nodes in the preempted state.
      - `rebooting` integer, required — The count of Compute Nodes in the rebooting state.
      - `reimaging` integer, required — The number of Compute Nodes in the reimaging state.
      - `running` integer, required — The number of Compute Nodes in the running state.
      - `starting` integer, required — The number of Compute Nodes in the starting state.
      - `startTaskFailed` integer, required — The number of Compute Nodes in the startTaskFailed state.
      - `leavingPool` integer, required — The number of Compute Nodes in the leavingPool state.
      - `unknown` integer, required — The number of Compute Nodes in the unknown state.
      - `unusable` integer, required — The number of Compute Nodes in the unusable state.
      - `waitingForStartTask` integer, required — The number of Compute Nodes in the waitingForStartTask state.
      - `deallocated` integer, required — The number of Compute Nodes in the deallocated state.
      - `deallocating` integer, required — The number of Compute Nodes in the deallocating state.
      - `total` integer, required — The total number of Compute Nodes.
      - `upgradingOS` integer, required — The number of Compute Nodes in the upgradingOS state.
  - `odata.nextLink` string, uri — The URL to get the next set of results.

## Other responses

- `default` — An unexpected error response.

---

[API](https://skmtc.net/azure/apis/batch-batch.md) · [All operations](https://skmtc.net/azure/apis/batch-batch/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/batch-batch/versions/8427acd8fd77/schema)