---
title: "GET /subscriptions/{subscriptionId}/providers/Microsoft.StorageCache/caches"
method: GET
path: "/subscriptions/{subscriptionId}/providers/Microsoft.StorageCache/caches"
tags: ["Caches"]
---

# GET /subscriptions/{subscriptionId}/providers/Microsoft.StorageCache/caches

`GET /subscriptions/{subscriptionId}/providers/Microsoft.StorageCache/caches`

Returns all Caches the user has access to under a subscription.

## Path parameters

- `subscriptionId` string, required

## Query parameters

- `api-version` string, required

## Response `200`

A list of Cache objects. Note that entity references might replace complete Cache objects, as described in http://docs.oasis-open.org/odata/odata-json-format/v4.01/cs01/odata-json-format-v4.01-cs01.html#sec_EntityReference

- CachesListResult — Result of the request to list Caches. It contains a list of Caches and a URL link to get the next set of results.
  - `nextLink` string — URL to get the next set of Cache list results, if there are any.
  - `value` Cache[] — List of Caches.
    - `tags` object — ARM tags as name/value pairs.
    - `id` string — A fully qualified URL.
    - `location` string — Region name string.
    - `name` string — Schema for the name of resources served by this provider. Note that objects will contain an odata @id annotation as appropriate. This will contain the complete URL of the object. These names are case-preserving, but not case sensitive.
    - `type` string — Type of the Cache; Microsoft.StorageCache/Cache
    - `properties` object — Properties of the Cache.
      - `cacheSizeGB` integer — The size of this Cache, in GB.
      - `health` CacheHealth — An indication of Cache health. Gives more information about health than just that related to provisioning.
        - `state` 'Unknown' | 'Healthy' | 'Degraded' | 'Down' | 'Transitioning' | 'Stopping' | 'Stopped' | 'Upgrading' | 'Flushing' — List of Cache health states.
        - `statusDescription` string — Describes explanation of state.
      - `mountAddresses` string[] — Array of IP addresses that can be used by clients mounting this Cache.
      - `provisioningState` 'Succeeded' | 'Failed' | 'Cancelled' | 'Creating' | 'Deleting' | 'Updating' — ARM provisioning state, see https://github.com/Azure/azure-resource-manager-rpc/blob/master/v1.0/Addendum.md#provisioningstate-property
      - `subnet` string — A fully qualified URL.
      - `upgradeStatus` CacheUpgradeStatus — Properties describing the software upgrade state of the Cache.
        - `currentFirmwareVersion` string — Version string of the firmware currently installed on this Cache.
        - `firmwareUpdateStatus` 'available' | 'unavailable' — True if there is a firmware update ready to install on this Cache. The firmware will automatically be installed after firmwareUpdateDeadline if not triggered earlier via the upgrade operation.
        - `firmwareUpdateDeadline` string, date-time — Time at which the pending firmware update will automatically be installed on the Cache.
        - `lastFirmwareUpdate` string, date-time — Time of the last successful firmware update.
        - `pendingFirmwareVersion` string — When firmwareUpdateAvailable is true, this field holds the version string for the update.
    - `sku` object — SKU for the Cache.
      - `name` string — SKU name for this Cache.

## Other responses

- `default` — Error response describing why the operation failed.

---

[API](https://skmtc.dev/azure/apis/storage-cache-mgmt-client.md) · [All operations](https://skmtc.dev/azure/apis/storage-cache-mgmt-client/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/storage-cache-mgmt-client/revisions/11e5dfc79bbd/schema)