SALES: 1-800-867-1380

Delete Role


Updated: July 10, 2015

The Delete Role operation deletes the specified Virtual Machine.

The Delete Role request may be specified as follows. Replace <subscription-id> with the subscription ID, <cloudservice-name> with the name of the cloud service, <deployment-name> with the name of the deployment, and <role-name> with the name of the Virtual Machine to delete.


Request URI


You must make sure that the request that is made to the management service is secure. For additional details, see Authenticating Service Management Requests.

URI Parameter



Optional. Specifies that the operating system disk, attached data disks, and the source blobs for the disks should also be deleted from storage.

The comp=media parameter is only available using version 2013-08-01 and higher.

The following table describes the request headers.

Request Header



Required. Specifies the version of the operation to use for this request. This header should be set to 2012-03-01 or higher. For more information about versioning headers, see Service Management Versioning.

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

A successful operation returns status code 202 (Accepted). For information about status codes, see Service Management Status and Error Codes.

The response for this operation includes the following headers. The response may also include additional standard HTTP headers. All standard headers conform to the HTTP/1.1 protocol specification.

Response Header



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

You can also delete a Virtual Machine by using the Management Portal or by using the Remove-AzureVM cmdlet.

If the deployment that is being deleted is using a reserved IP address, the address continues to be reserved for your subscription. The unused reserved IP address continues to incur charges. For more information, see Reserved IP Pricing. To delete the reserved IP address if you don’t need it anymore, use Delete Reserved IP Address.

© 2016 Microsoft