---
title: "Get the list of cached images."
method: GET
path: "/subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/locations/{location}/cachedImages"
---

# Get the list of cached images.

`GET /subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/locations/{location}/cachedImages`

Get the list of cached images on specific OS type for a subscription in a region.

## Parameters

- `../../../../../../common-types/resource-management/v5/types.json#/components/parameters/ApiVersionParameter` — unresolved $ref
- `../../../../../../common-types/resource-management/v5/types.json#/components/parameters/SubscriptionIdParameter` — unresolved $ref
- `../../../../../../common-types/resource-management/v5/types.json#/components/parameters/LocationParameter` — unresolved $ref

## Response `200`

The request has succeeded.

- CachedImagesListResult — The response containing cached images.
  - `value` CachedImages[] — The cached images.
    - `osType` string, required — The OS type of the cached image.
    - `image` string, required — The cached image name.
  - `nextLink` string — The URL to get the next set of results.

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2017-08-01-preview) `540a7f5ef13b` — 3 warning
  - deleted the `path` request parameter `location`
  - deleted the `path` request parameter `subscriptionId`
  - deleted the `query` request parameter `api-version`
- **2026-07-13** (2017-08-01-preview) `114fa0867ea1` — 3 warning
  - deleted the `path` request parameter `location`
  - deleted the `path` request parameter `subscriptionId`
  - deleted the `query` request parameter `api-version`
- **2026-07-13** (2017-08-01-preview) `3b95c53f2960` — 3 breaking
  - added the new path request parameter `location`
  - added the new path request parameter `subscriptionId`
  - added the new required `query` request parameter `api-version`
- **2026-07-13** (2017-08-01-preview) `6deb25ec5d7a` — 1 info
  - endpoint added
- **2026-07-13** (2017-08-01-preview) `d623baae3494` — 1 info
  - api operation id `ListCachedImages` removed and replaced with `Location_ListCachedImages`

[Change history](https://skmtc.dev/azure/apis/containerinstance-microsoft-containerinstance-containerinsta/changes/subscriptions/:subscriptionId/providers/Microsoft.ContainerInstance/locations/:location/cachedImages/get.md)

---

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