---
title: "Lists the usage metrics, aggregated by Pool across individual time intervals,
for the specified Account."
method: GET
path: "/poolusagemetrics"
tags: ["Pools"]
---

# Lists the usage metrics, aggregated by Pool across individual time intervals,
for the specified Account.

`GET /poolusagemetrics`

If you do not specify a $filter clause including a poolId, the response
includes all Pools that existed in the Account in the time range of the
returned aggregation intervals. If you do not specify a $filter clause
including a startTime or endTime these filters default to the start and end
times of the last aggregation interval currently available; that is, only the
last aggregation interval is returned.

## Query parameters

- `api-version` string, required
- `timeOut` integer
- `maxresults` integer
- `startTime` string, date-time
- `endtime` string, date-time
- `$filter` string

## Headers

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

## Response `200`

The request has succeeded.

- BatchPoolListUsageMetricsResult — The result of a listing the usage metrics for an Account.
  - `value` BatchPoolUsageMetrics[] — The Pool usage metrics data.
    - `poolId` string, required — The ID of the Pool whose metrics are aggregated in this entry.
    - `startTime` string, date-time, required — The start time of the aggregation interval covered by this entry.
    - `endTime` string, date-time, required — The end time of the aggregation interval covered by this entry.
    - `vmSize` string, required — The size of virtual machines in the Pool. All VMs in a Pool are the same size. For information about available sizes of virtual machines in Pools, see Choose a VM size for Compute Nodes in an Azure Batch Pool (https://learn.microsoft.com/azure/batch/batch-pool-vm-sizes).
    - `totalCoreHours` number, float, required — The total core hours used in the Pool during this aggregation interval.
  - `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)