Virtual Machine Scale Sets - Reimage

Service:

Compute

API Version:

2024-03-01

Menggambar ulang (meningkatkan sistem operasi) satu atau beberapa komputer virtual dalam set skala VM yang tidak memiliki disk OS sementara, untuk komputer virtual yang memiliki disk OS sementara, komputer virtual diatur ulang ke keadaan awal.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/reimage?api-version=2024-03-01

Parameter URI

Nama	Dalam	Diperlukan	Jenis	Deskripsi
resourceGroupName	path	True	string	Nama grup sumber daya.
subscriptionId	path	True	string	Kredensial langganan yang secara unik mengidentifikasi langganan Microsoft Azure. ID langganan membentuk bagian dari URI untuk setiap panggilan layanan.
vmScaleSetName	path	True	string	Nama set skala VM.
api-version	query	True	string	Versi Api Klien.

Isi Permintaan

Nama	Jenis	Deskripsi
exactVersion	string	Menentukan dalam angka desimal, versi yang harus digambatkan kembali oleh disk OS. Jika versi yang tepat tidak disediakan, disk OS direimage ke versi Disk OS yang ada.
forceUpdateOSDiskForEphemeral	boolean	Parameter untuk memaksa pembaruan disk OS ephemeral untuk VM set skala komputer virtual
instanceIds	string[]	Id instans set skala komputer virtual. Menghilangkan id instans set skala komputer virtual akan mengakibatkan operasi dilakukan pada semua komputer virtual dalam set skala komputer virtual.
osProfile	OSProfileProvisioningData	Menentukan informasi yang diperlukan untuk meniru kembali disk OS non-sementara.
tempDisk	boolean	Menentukan apakah akan mengganti nama disk sementara. Nilai default: salah. Catatan: Parameter reimage disk sementara ini hanya didukung untuk VM/VMSS dengan disk OS Sementara.

Respons

Nama	Jenis	Deskripsi
200 OK		OK
202 Accepted		Diterima
Other Status Codes	CloudError	Respons kesalahan yang menjelaskan mengapa operasi gagal.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nama	Deskripsi
user_impersonation	meniru akun pengguna Anda

Contoh

VirtualMachineScaleSet_Reimage_MaximumSet_Gen

VirtualMachineScaleSet_Reimage_MinimumSet_Gen

VirtualMachineScaleSet_Reimage_MaximumSet_Gen

Sample Request

HTTP

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2024-03-01

{
  "instanceIds": [
    "aaaaaaaaaa"
  ],
  "forceUpdateOSDiskForEphemeral": true,
  "tempDisk": true
}

Sample Response

Status code:

200

Status code:

202

location: https://foo.com/operationstatus

VirtualMachineScaleSet_Reimage_MinimumSet_Gen

Sample Request

HTTP

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2024-03-01

Sample Response

Status code:

200

Status code:

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.
OSProfileProvisioningData	Parameter tambahan untuk Meniru Ulang Komputer Virtual Non-Sementara.
VirtualMachineScaleSetReimageParameters	Menjelaskan Parameter Reimage VM Virtual Machine Scale Set.

ApiError

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

Basis kesalahan api.

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

CloudError

Respons kesalahan dari layanan Komputasi.

Nama	Jenis	Deskripsi
error	ApiError	Kesalahan api.

InnerError

Detail kesalahan dalam.

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

OSProfileProvisioningData

Parameter tambahan untuk Meniru Ulang Komputer Virtual Non-Sementara.

Nama	Jenis	Deskripsi
adminPassword	string	Menentukan kata sandi akun administrator. Panjang minimum (Windows): 8 karakter Panjang minimum (Linux): 6 karakter Panjang maksimum (Windows): 123 karakter Panjang maksimum (Linux): 72 karakter Persyaratan kompleksitas: 3 dari 4 kondisi di bawah ini perlu dipenuhi Memiliki karakter yang lebih rendah Memiliki karakter atas Memiliki digit Memiliki karakter khusus (Kecocokan regex [\W_]) Nilai yang tidak diizinkan: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!" Untuk mengatur ulang kata sandi, lihat Cara mengatur ulang layanan Desktop Jauh atau kata sandi masuknya di VM Windows Untuk mengatur ulang kata sandi root, lihat Mengelola pengguna, SSH, dan memeriksa atau memperbaiki disk di VM Linux Azure menggunakan Ekstensi VMAccess
customData	string	Menentukan string data kustom yang dikodekan base-64. String yang dikodekan base-64 didekodekan ke array biner yang disimpan sebagai file pada Komputer Virtual. Panjang maksimum array biner adalah 65535 byte. Catatan: Jangan berikan rahasia atau kata sandi apa pun di properti customData. Properti ini tidak dapat diperbarui setelah VM dibuat. CustomData properti diteruskan ke VM untuk disimpan sebagai file, untuk informasi selengkapnya lihat Data Kustom di Azure VM. Jika menggunakan cloud-init untuk VM Linux Anda, lihat Menggunakan cloud-init untuk menyesuaikan VM Linux selama pembuatan.

VirtualMachineScaleSetReimageParameters

Menjelaskan Parameter Reimage VM Virtual Machine Scale Set.

Nama	Jenis	Deskripsi
exactVersion	string	Menentukan dalam angka desimal, versi yang harus digambatkan kembali oleh disk OS. Jika versi yang tepat tidak disediakan, disk OS direimage ke versi Disk OS yang ada.
forceUpdateOSDiskForEphemeral	boolean	Parameter untuk memaksa pembaruan disk OS ephemeral untuk VM set skala komputer virtual
instanceIds	string[]	Id instans set skala komputer virtual. Menghilangkan id instans set skala komputer virtual akan mengakibatkan operasi dilakukan pada semua komputer virtual dalam set skala komputer virtual.
osProfile	OSProfileProvisioningData	Menentukan informasi yang diperlukan untuk meniru kembali disk OS non-sementara.
tempDisk	boolean	Menentukan apakah akan mengganti nama disk sementara. Nilai default: salah. Catatan: Parameter reimage disk sementara ini hanya didukung untuk VM/VMSS dengan disk OS Sementara.