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

# GET /poolusagemetrics

`GET /poolusagemetrics`

Lists the usage metrics, aggregated by pool across individual time intervals, for the specified account.

## Query parameters

- `starttime` string, date-time
- `endtime` string, date-time
- `$filter` string
- `maxresults` integer
- `timeout` integer
- `api-version` string, required

## Headers

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

## Response `200`

OK

- PoolListPoolUsageMetricsResult — Response to an AccountOperation.ListPoolUsageMetrics request.
  - `value` PoolUsageMetrics[] — The pool usage metrics data.
    - `poolId` string, required — The id of the pool whose metrics are being aggregated.
    - `startTime` string, date-time, required — The start time of the aggregation interval.
    - `endTime` string, date-time, required — The end time of the aggregation interval.
    - `vmSize` string, required — The size of virtual machines in the pool. All VMs in a pool are the same size.
    - `totalCoreHours` number, double, required — The total core hours used in the pool during this aggregation interval.
    - `dataIngressGiB` number, double, required — The cross data center network ingress in GiB to the pool during this interval.
    - `dataEgressGiB` number, double, required — The cross data center network egress in GiB from the pool during this interval.
  - `odata.nextLink` string — The URL to get the next set of results.

## Other responses

- `default` — The error from the Batch service.

---

[API](https://skmtc.dev/azure/apis/batch-batch.md) · [All operations](https://skmtc.dev/azure/apis/batch-batch/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/batch-batch/revisions/bee2d837bf8f/schema)