Delete VM Image

 

The Delete VM Image operation deletes the specified VM Image from the image repository that is associated with the specified subscription. A VM Image can represent a single operating system virtual hard drive (VHD) or it can represent an operating system VHD and its associated data VHDs. This operation deletes all VHDs that are represented by a VM Image.

Request

The Delete VM Image request may be specified as follows. Replace <subscription-id> with the subscription ID and <image-name> with the name of the VM image to delete.

Method

Request URI

DELETE

https://management.core.windows.net/<subscription-id>/services/vmimages/<image-name>

URI Parameters

URI Parameter

Description

comp=media

Specifies that the source blobs for the VM Image should also be deleted from storage. This parameter is optional with version 2014-06-01 or higher.

Request Headers

The following table describes request headers.

Request Header

Description

x-ms-version

Required. Specifies the version of the operation to use for this request. This header should be set to 2014-02-01 or higher.

Request Body

None.

Response

The response includes an HTTP status code and a set of response headers.

Status Code

A successful operation returns status code 200 (OK).

Response Headers

The response for this operation includes the following headers. The response may also include additional standard HTTP headers.

Response Header

Description

x-ms-request-id

A value that uniquely identifies a request made against the management service.

Response Body

None.