Bagikan melalui


Virtual Machines - Reimage

Menggambar ulang (meningkatkan sistem operasi) komputer virtual yang tidak memiliki disk OS sementara, untuk komputer virtual yang memiliki disk OS sementara, komputer virtual diatur ulang ke keadaan awal. CATATAN: Mempertahankan disk OS lama tergantung pada nilai deleteOption disk OS. Jika deleteOption dicopot, disk OS lama akan dipertahankan setelah pencitraan ulang. Jika deleteOption dihapus, disk OS lama akan dihapus setelah gambar ulang. DeleteOption disk OS harus diperbarui sebelum melakukan reimage.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/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.

vmName
path True

string

Nama mesin virtual.

api-version
query True

string

Versi Api Klien.

Isi Permintaan

Nama Jenis Deskripsi
parameters

VirtualMachineReimageParameters

Parameter yang disediakan untuk operasi Reimage Virtual Machine.

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

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

Cakupan

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

Reimage a Non-Ephemeral Virtual Machine.
Reimage a Virtual Machine.

Reimage a Non-Ephemeral Virtual Machine.

Permintaan sampel

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

{
  "tempDisk": true,
  "exactVersion": "aaaaaa",
  "osProfile": {
    "adminPassword": "{your-password}",
    "customData": "{your-custom-data}"
  }
}

Respon sampel

Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2024-03-01

Reimage a Virtual Machine.

Permintaan sampel

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

{
  "tempDisk": true
}

Respon sampel

Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2024-03-01

Definisi

Nama Deskripsi
ApiError

Kesalahan api.

ApiErrorBase

Basis kesalahan api.

CloudError

Respons kesalahan dari layanan Komputasi.

InnerError

Detail kesalahan dalam.

OSProfileProvisioningData

Menentukan informasi yang diperlukan untuk meniru kembali disk OS non-sementara.

VirtualMachineReimageParameters

Parameter yang disediakan untuk operasi Reimage Virtual Machine.

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

Menentukan informasi yang diperlukan untuk meniru kembali disk OS 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 Azure Linux VM 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. Properti customData 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.

VirtualMachineReimageParameters

Parameter yang disediakan untuk operasi Reimage Virtual Machine.

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 digambut ulang ke versi Disk OS yang ada.

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.