Virtual Machine Scale Set VMs - Power Off
Ausschalten (Beenden) eines virtuellen Computers in einer VM-Skalierungsgruppe. Beachten Sie, dass ressourcen noch angefügt sind und sie für die Ressourcen in Rechnung gestellt werden. Verwenden Sie stattdessen deallocate, um Ressourcen freizugeben und Gebühren zu vermeiden.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/virtualMachines/{instanceId}/powerOff?api-version=2025-11-01
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/virtualMachines/{instanceId}/powerOff?api-version=2025-11-01&skipShutdown={skipShutdown}
URI-Parameter
| Name | In | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
instance
|
path | True |
string |
Die Instanz-ID des virtuellen Computers. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet. |
|
subscription
|
path | True |
string minLength: 1 |
Die ID des Zielabonnements. |
|
vm
|
path | True |
string |
Der Name des VM-Skalierungssatzes. |
|
api-version
|
query | True |
string minLength: 1 |
Die API-Version, die für diesen Vorgang verwendet werden soll. |
|
skip
|
query |
boolean |
Der Parameter, um ein nicht ordnungsgemäßes Herunterfahren der VM anzufordern. True-Wert für dieses Flag gibt an, dass das Herunterfahren nicht ordnungsgemäß ist, während "false" andernfalls angibt. Der Standardwert für dieses Flag ist false, wenn es nicht angegeben ist |
Antworten
| Name | Typ | Beschreibung |
|---|---|---|
| 200 OK |
Die Anforderung ist erfolgreich. |
|
| 202 Accepted |
Ressourcenvorgang akzeptiert. Header
|
|
| Other Status Codes |
Unerwartete Fehlerantwort. |
Sicherheit
azure_auth
Azure Active Directory OAuth2 Flow.
Typ:
oauth2
Ablauf:
implicit
Autorisierungs-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiche
| Name | Beschreibung |
|---|---|
| user_impersonation | Identitätswechsel ihres Benutzerkontos |
Beispiele
|
Virtual |
|
Virtual |
VirtualMachineScaleSetVM_PowerOff_MaximumSet_Gen
Beispielanforderung
Beispiel für eine Antwort
location: https://foo.com/operationstatus
VirtualMachineScaleSetVM_PowerOff_MinimumSet_Gen
Beispielanforderung
Beispiel für eine Antwort
location: https://foo.com/operationstatus
Definitionen
| Name | Beschreibung |
|---|---|
|
Api |
API-Fehler. |
|
Api |
API-Fehlerbasis. |
|
Cloud |
Eine Fehlerantwort vom Compute-Dienst. |
|
Inner |
Innere Fehlerdetails. |
ApiError
API-Fehler.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Der Fehlercode. |
| details |
Die Details zum API-Fehler |
|
| innererror |
Der innere API-Fehler |
|
| message |
string |
Die Fehlermeldung. |
| target |
string |
Das Ziel des bestimmten Fehlers. |
ApiErrorBase
API-Fehlerbasis.
| Name | Typ | Beschreibung |
|---|---|---|
| code |
string |
Der Fehlercode. |
| message |
string |
Die Fehlermeldung. |
| target |
string |
Das Ziel des bestimmten Fehlers. |
CloudError
Eine Fehlerantwort vom Compute-Dienst.
| Name | Typ | Beschreibung |
|---|---|---|
| error |
API-Fehler. |
InnerError
Innere Fehlerdetails.
| Name | Typ | Beschreibung |
|---|---|---|
| errordetail |
string |
Die interne Fehlermeldung oder der Ausnahmedump. |
| exceptiontype |
string |
Der Ausnahmetyp. |