Delete VM Image

 

Updated: July 10, 2015

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.

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

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.

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

A successful operation returns status code 200 (OK).

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.

Show: