SALES: 1-800-867-1380

Delete Role Instances

Updated: September 30, 2014

The Delete Role Instances operation deletes multiple role instances from a deployment in a cloud service.

The Delete Role Instances request is specified as follows. Replace <subscription-id> with your subscription ID, <cloudservice-name> with the name of your service, <deployment-slot> with staging or production, or <deployment-name> with the name of the deployment.

 

Method Request URI

POST

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deployments/<deployment-name>/roleinstances/

POST

https://management.core.windows.net/<subscription-id>/services/hostedservices/<cloudservice-name>/deploymentslots/<deployment-slot>/roleinstances/

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 Description

comp=delete

Required. Specifies that the roles instances defined in the request should be deleted from the deployment.

The following table describes the 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 2013-08-01 or higher. For more information about versioning headers, see Service Management Versioning.

The format of the request body is as follows:

    
<RoleInstances xmlns="http://schemas.microsoft.com/windowsazure" xmlns:i="http://www.w3.org/2001/XMLSchema-instance">
  <Name>name-of-role-instance</Name>
</RoleInstances>

The following table describes the elements of the request body.

 

Element name Description

RoleInstances

Required. Specifies the set of role instances to delete.

Name

Required. Specifies the name of a role instance to delete.

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 Description

x-ms-request-id

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

You can find the names of role instances in a deployment by using Get Deployment.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft