---
title: "Changes to POST /subscriptions/{subscriptionId}/metrics:getBatch"
method: POST
path: "/subscriptions/{subscriptionId}/metrics:getBatch"
---

# Changes to POST /subscriptions/{subscriptionId}/metrics:getBatch

`POST /subscriptions/{subscriptionId}/metrics:getBatch`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 4 revisions.

- **2026-07-13** (2023-03-01-preview) `af342767e7a8` — 1 warning, 6 info
- **2026-07-13** (2023-03-01-preview) `69964f0a31d4` — 3 warning
- **2026-07-13** (2023-03-01-preview) `a5bfe58e450c` — 2 warning, 2 info
- **2026-07-13** (2023-03-01-preview) `23b83fdbaa7b` — 1 warning, 3 info

## Changes

- **2026-07-13** (2023-03-01-preview) `af342767e7a8` — 1 warning, 6 info
  - the optional response header `x-ms-error-code` removed for the status `default`
  - api operation id `MetricsBatch_Batch` removed and replaced with `Batch`
  - api tag `Metrics` removed
  - added the new optional `query` request parameter `aggregation`
  - added the new optional `query` request parameter `orderby`
  - added the new optional `query` request parameter `rollupby`
  - added the new optional `query` request parameter `top`
- **2026-07-13** (2023-03-01-preview) `69964f0a31d4` — 3 warning
  - deleted the `query` request parameter `aggregation`
  - deleted the `query` request parameter `orderby`
  - deleted the `query` request parameter `top`
- **2026-07-13** (2023-03-01-preview) `a5bfe58e450c` — 2 warning, 2 info
  - deleted the `query` request parameter `endtime`
  - deleted the `query` request parameter `starttime`
  - api operation id `MetricsBatch_Batch` removed and replaced with `Metrics_Batch`
  - added the new optional `query` request parameter `timespan`
- **2026-07-13** (2023-03-01-preview) `23b83fdbaa7b` — 1 warning, 3 info
  - deleted the `query` request parameter `timespan`
  - api operation id `Metrics_Batch` removed and replaced with `MetricsBatch_Batch`
  - added the new optional `query` request parameter `endtime`
  - added the new optional `query` request parameter `starttime`

---

[Operation](https://skmtc.dev/azure/apis/monitor-insights/docs/subscriptions/:subscriptionId/metrics:getBatch/post.md) · [API](https://skmtc.dev/azure/apis/monitor-insights.md) · [Page](https://skmtc.dev/azure/apis/monitor-insights/changes/subscriptions/:subscriptionId/metrics:getBatch/post)
