Virtual Machines - Power Off

Service:

Compute

API-versie:

2025-04-01

De bewerking om een virtuele machine uit te schakelen (stoppen). De virtuele machine kan opnieuw worden opgestart met dezelfde ingerichte resources. Er worden nog steeds kosten in rekening gebracht voor deze virtuele machine.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/powerOff?api-version=2025-04-01

Met optionele parameters:

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/powerOff?api-version=2025-04-01&skipShutdown={skipShutdown}

URI-parameters

Name	In	Vereist	Type	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	De naam van de resourcegroep. De naam is hoofdletterongevoelig.
subscriptionId	path	True	string minLength: 1	De id van het doelabonnement.
vmName	path	True	string	De naam van de virtuele machine.
api-version	query	True	string minLength: 1	De API-versie die voor deze bewerking moet worden gebruikt.
skipShutdown	query		boolean	De parameter om niet-sierlijke VM-afsluiting aan te vragen. True-waarde voor deze vlag geeft niet-sierlijk afsluiten aan, terwijl false anders aangeeft. De standaardwaarde voor deze vlag is onwaar als deze niet is opgegeven

Antwoorden

Name	Type	Description
200 OK		De aanvraag is voltooid.
202 Accepted		Resourcebewerking geaccepteerd. Kopteksten Location: string Retry-After: integer
Other Status Codes	CloudError	Een onverwachte foutreactie.

Beveiliging

azure_auth

OAuth2-stroom voor Azure Active Directory.

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

VirtualMachine_PowerOff_MaximumSet_Gen

VirtualMachine_PowerOff_MinimumSet_Gen

VirtualMachine_PowerOff_MaximumSet_Gen

Voorbeeldaanvraag

HTTP

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaaaaaaaaaaaaaaaa/powerOff?api-version=2025-04-01&skipShutdown=True

Voorbeeldrespons

Statuscode:

200

Statuscode:

202

location: https://foo.com/operationstatus

VirtualMachine_PowerOff_MinimumSet_Gen

Voorbeeldaanvraag

HTTP

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaaaaaaa/powerOff?api-version=2025-04-01

Voorbeeldrespons

Statuscode:

200

Statuscode:

202

location: https://foo.com/operationstatus

Definities

Name	Description
ApiError	Api-fout.
ApiErrorBase	Api-foutbasis.
CloudError	Een foutreactie van de Compute-service.
InnerError	Interne foutdetails.

ApiError

Object

Api-fout.

Name	Type	Description
code	string	De foutcode.
details	ApiErrorBase[]	Details van de Api-fout
innererror	InnerError	De innerlijke fout van de Api
message	string	Het foutbericht.
target	string	Het doel van de specifieke fout.

ApiErrorBase

Object

Api-foutbasis.

Name	Type	Description
code	string	De foutcode.
message	string	Het foutbericht.
target	string	Het doel van de specifieke fout.

CloudError

Object

Een foutreactie van de Compute-service.

Name	Type	Description
error	ApiError	Api-fout.

InnerError

Object

Interne foutdetails.

Name	Type	Description
errordetail	string	De interne foutmelding of uitzonderingsdump.
exceptiontype	string	Het uitzonderingstype.