List Cached Images - List Cached Images

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

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ContainerInstance/locations/{location}/cachedImages?api-version=2018-10-01

URI Parameters

Name In Required Type Description
subscriptionId
path True
  • string

Subscription credentials which uniquely identify Microsoft Azure subscription. The subscription ID forms part of the URI for every service call.

location
path True
  • string

The identifier for the physical azure location.

api-version
query True
  • string

Client API version

Responses

Name Type Description
200 OK

OK

Other Status Codes

Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation Impersonate your user account

Examples

CachedImages

Sample Request

GET https://management.azure.com/subscriptions/subid/providers/Microsoft.ContainerInstance/locations/westcentralus/cachedImages?api-version=2018-10-01

Sample Response

{
  "value": [
    {
      "osType": "Linux",
      "image": "ubuntu:16.04"
    },
    {
      "osType": "Linux",
      "image": "alpine:3.6"
    },
    {
      "osType": "Windows",
      "image": "microsoft/nanoserver:10.0.14393.2485"
    }
  ]
}

Definitions

cachedImages

The cached image and OS type.

CachedImagesListResult

The response containing cached images.

CloudError

An error response from the Batch service.

CloudErrorBody

An error response from the Batch service.

cachedImages

The cached image and OS type.

Name Type Description
id
  • string

The resource Id of the cached image.

image
  • string

The cached image name.

osType
  • string

The OS type of the cached image.

CachedImagesListResult

The response containing cached images.

Name Type Description
nextLink
  • string

The URI to fetch the next page of cached images.

value

The list of cached images.

CloudError

An error response from the Batch service.

Name Type Description
error

An error response from the Batch service.

CloudErrorBody

An error response from the Batch service.

Name Type Description
code
  • string

An identifier for the error. Codes are invariant and are intended to be consumed programmatically.

details

A list of additional details about the error.

message
  • string

A message describing the error, intended to be suitable for display in a user interface.

target
  • string

The target of the particular error. For example, the name of the property in error.