---
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.

## Path parameters

- `subscriptionId` string, required
- `location` string, required

## Query parameters

- `api-version` string, required

## Response `200`

OK

- CachedImagesListResult — The response containing cached images.
  - `value` CachedImages[] — The list of cached images.
    - `id` string — The resource Id of the cached image.
    - `osType` string, required — The OS type of the cached image.
    - `image` string, required — The cached image name.
  - `nextLink` string — The URI to fetch the next page of cached images.

## Other responses

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

## Changes

- **2018-12-13** (2018-10-01) `7325980db6db` — 1 info
  - endpoint added

[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/7325980db6db/schema)