![Doug Erickson [MSFT]](https://github.com/erickson-doug.png?size=16)
Manage the virtual machines in a Virtual Machine Scale Set. You can use this task to start, restart, stop, delete, or upgrade a virtual machine in the scale set.
Request
For information about getting started with Azure REST operations including request authentication, see Azure REST API Reference.
| Method | Request URI |
|---|---|
| POST | https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroup}/providers/Microsoft.Compute/VirtualMachineScaleSets/{vmScaleSet}/{action}?api-version={apiVersion} |
| Parameter | Description |
|---|---|
| subscriptionId | The identifier of your subscription. |
| resourceGroup | The resource group that contains the scale set. |
| vmScaleSet | The name of the scale set. |
| action | The action that you want to perform. Possible values are: start, restart, powerOff, deallocate, delete, manualUpgrade, reimage, or reimageAllDisks. |
| apiVersion | The version of the API to use. The current version is 2016-04-30-preview. |
{
"instanceIds" : [ "0","1","2","3"... ]
}
You can also use an asterisk (*) to apply the action to all virtual machines in the scale set.
{
"instanceIds" : [ "*" ]
}
| Element name | Required | Type | Description |
|---|---|---|---|
| instanceIds | No | Collection | Specifies a list of instance identifiers for the virtual machines on which the action should be performed. You must provide at least one identifier. To find the identifier of a virtual machine, see List all VMs in a set. |
Response
Status code: 200 (OK).
Remarks
If you are deleting a virtual machine, the persistent disk blobs associated with the machine are also deleted. If you use the asterisk (*) with the delete action and change the capacity to 0, autoscale will not function.