---
title: "GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/instancePools/{instancePoolName}/usages"
method: GET
path: "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/instancePools/{instancePoolName}/usages"
tags: ["Usages"]
---

# GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/instancePools/{instancePoolName}/usages

`GET /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/instancePools/{instancePoolName}/usages`

Gets all instance pool usage metrics

## Path parameters

- `resourceGroupName` string, required
- `instancePoolName` string, required
- `subscriptionId` string, required

## Query parameters

- `expandChildren` boolean
- `api-version` string, required

## Response `200`

Successfully retrieved the instance pool usages.

- UsageListResult — A list of usages.
  - `value` Usage[] — Array of results.
    - `id` string — Resource ID.
    - `name` Name — ARM Usage Name
      - `value` string — Usage name value
      - `localizedValue` string — Usage name localized value.
    - `type` string — Resource type.
    - `unit` string — Usage unit.
    - `currentValue` integer — Usage current value.
    - `limit` integer — Usage limit.
    - `requestedLimit` integer — Usage requested limit.
  - `nextLink` string — Link to retrieve next page of results.

## Other responses

- `default` — *** Error Responses: *** * 400 InstancePoolWrongUsageName - Request for an instance pool's usage has an unsupported usage name * 400 InstancePoolManagedInstanceInfoUnavailable - Information for managed instances inside this instance pool is not available * 404 InstancePoolNotFound - An instance pool cannot be found

---

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