Sdílet prostřednictvím

Virtual Machines - Power Off

Služba:
Compute
Verze rozhraní API:
2025-04-01

Operace vypnutí (zastavení) virtuálního počítače. Virtuální počítač lze restartovat se stejnými zřízenými prostředky. Za tento virtuální počítač se vám budou účtovat poplatky.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
resourceGroupName
 path True

string

minLength: 1
maxLength: 90

Název skupiny prostředků. Název nerozlišuje malá a velká písmena.
subscriptionId
 path True

string

minLength: 1

ID cílového předplatného.
vmName
 path True

string

Název virtuálního počítače.
api-version
 query True

string

minLength: 1

Verze rozhraní API, která se má použít pro tuto operaci.
skipShutdown
 query

boolean

Parametr pro požadavek na neřádné vypnutí virtuálního počítače. Hodnota True pro tento příznak označuje nesplněné vypnutí, zatímco false označuje jinak. Výchozí hodnota pro tento příznak je false, pokud není specifikována

Odpovědi

Name Typ Description
200 OK

Žádost byla úspěšná.
202 Accepted

Operace prostředku byla přijata.

Hlavičky

  • Location: string
  • Retry-After: integer
Other Status Codes

CloudError

Neočekávaná chybová odpověď

Zabezpečení

azure_auth

Tok OAuth2 v Azure Active Directory

Typ: oauth2
Tok: implicit
URL autorizace: https://login.microsoftonline.com/common/oauth2/authorize

Rozsahy

Name Description
user_impersonation zosobnění uživatelského účtu

Příklady

VirtualMachine_PowerOff_MaximumSet_Gen
VirtualMachine_PowerOff_MinimumSet_Gen

VirtualMachine_PowerOff_MaximumSet_Gen

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
200
Stavový kód:
202 
location: https://foo.com/operationstatus

VirtualMachine_PowerOff_MinimumSet_Gen

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
200
Stavový kód:
202 
location: https://foo.com/operationstatus

Definice

Name Description
ApiError

Chyba rozhraní API.
ApiErrorBase

Chybová základna API.
CloudError

Chybová odpověď ze služby Compute.
InnerError

Podrobnosti vnitřní chyby.

ApiError

Objekt

Chyba rozhraní API.

Name Typ Description
code

string

Kód chyby.
details

ApiErrorBase[]

Podrobnosti o chybě rozhraní API
innererror

InnerError

Vnitřní chyba Api
message

string

Chybová zpráva.
target

string

Cíl konkrétní chyby.

ApiErrorBase

Objekt

Chybová základna API.

Name Typ Description
code

string

Kód chyby.
message

string

Chybová zpráva.
target

string

Cíl konkrétní chyby.

CloudError

Objekt

Chybová odpověď ze služby Compute.

Name Typ Description
error

ApiError

Chyba rozhraní API.

InnerError

Objekt

Podrobnosti vnitřní chyby.

Name Typ Description
errordetail

string

Vnitřní chybová zpráva nebo výpis výjimky.
exceptiontype

string

Typ výjimky.