Virtual Machines - Power Off

Layanan:

Compute

Versi API:

2025-04-01

Operasi untuk mematikan (menghentikan) komputer virtual. Komputer virtual dapat dimulai ulang dengan sumber daya yang disediakan yang sama. Anda masih dikenakan biaya untuk komputer virtual ini.

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

Dengan parameter opsional:

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

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.
subscriptionId	path	True	string minLength: 1	ID langganan target.
vmName	path	True	string	Nama mesin virtual.
api-version	query	True	string minLength: 1	Versi API yang digunakan untuk operasi ini.
skipShutdown	query		boolean	Parameter untuk meminta shutdown VM yang tidak sah. Nilai benar untuk bendera ini menunjukkan pematian yang tidak anggun sedangkan false menunjukkan sebaliknya. Nilai default untuk bendera ini adalah false jika tidak ditentukan

Respons

Nama	Jenis	Deskripsi
200 OK		Permintaan itu berhasil.
202 Accepted		Operasi sumber daya diterima. Header Location: string Retry-After: integer
Other Status Codes	CloudError	Respons kesalahan tak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

VirtualMachine_PowerOff_MaximumSet_Gen

VirtualMachine_PowerOff_MinimumSet_Gen

VirtualMachine_PowerOff_MaximumSet_Gen

Permintaan sampel

HTTP

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

Respon sampel

Kode status:

200

Kode status:

202

location: https://foo.com/operationstatus

VirtualMachine_PowerOff_MinimumSet_Gen

Permintaan sampel

HTTP

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

Respon sampel

Kode status:

200

Kode status:

202

location: https://foo.com/operationstatus

Definisi

Nama	Deskripsi
ApiError	Kesalahan API.
ApiErrorBase	Basis kesalahan API.
CloudError	Respons kesalahan dari layanan Komputasi.
InnerError	Detail kesalahan dalam.

ApiError

Objek

Kesalahan API.

Nama	Jenis	Deskripsi
code	string	Kode kesalahan.
details	ApiErrorBase[]	Detail kesalahan Api
innererror	InnerError	Kesalahan dalam Api
message	string	Pesan kesalahan.
target	string	Target kesalahan tertentu.

ApiErrorBase

Objek

Basis kesalahan API.

Nama	Jenis	Deskripsi
code	string	Kode kesalahan.
message	string	Pesan kesalahan.
target	string	Target kesalahan tertentu.

CloudError

Objek

Respons kesalahan dari layanan Komputasi.

Nama	Jenis	Deskripsi
error	ApiError	Kesalahan API.

InnerError

Objek

Detail kesalahan dalam.

Nama	Jenis	Deskripsi
errordetail	string	Pesan kesalahan internal atau dump pengecualian.
exceptiontype	string	Jenis pengecualian.