Virtual Machines - Install Patches
Menginstal patch pada VM.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/installPatches?api-version=2024-03-01
Parameter URI
Nama | Dalam | Diperlukan | Jenis | Deskripsi |
---|---|---|---|---|
resource
|
path | True |
string |
Nama grup sumber daya. |
subscription
|
path | True |
string |
Kredensial langganan yang secara unik mengidentifikasi langganan Microsoft Azure. ID langganan membentuk bagian dari URI untuk setiap panggilan layanan. |
vm
|
path | True |
string |
Nama mesin virtual. |
api-version
|
query | True |
string |
Versi Api Klien. |
Isi Permintaan
Nama | Jenis | Deskripsi |
---|---|---|
installPatchesInput |
Input untuk InstallPatches seperti yang diterima langsung oleh API |
Respons
Nama | Jenis | Deskripsi |
---|---|---|
200 OK |
OK |
|
202 Accepted |
Diterima |
|
Other Status Codes |
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
Install patch state of a virtual machine.
Sample Request
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/virtualMachines/myVMName/installPatches?api-version=2024-03-01
{
"maximumDuration": "PT4H",
"rebootSetting": "IfRequired",
"windowsParameters": {
"classificationsToInclude": [
"Critical",
"Security"
],
"maxPatchPublishDate": "2020-11-19T02:36:43.0539904+00:00"
}
}
Sample Response
{
"status": "Succeeded",
"installationActivityId": "68f8b292-dfc2-4646-9781-33cc88631968",
"rebootStatus": "Completed",
"maintenanceWindowExceeded": false,
"excludedPatchCount": 0,
"notSelectedPatchCount": 0,
"pendingPatchCount": 2,
"installedPatchCount": 3,
"failedPatchCount": 0,
"startDateTime": "2020-04-24T21:02:04.2556154Z",
"patches": [
{
"patchId": "35428702-5784-4ba4-a6e0-5222258b5411",
"name": "Definition Update for Windows Defender Antivirus - KB2267602 (Definition 1.279.1373.0)",
"version": "",
"kbId": "2267602",
"classifications": [
"Definition Updates"
],
"installationState": "Installed"
},
{
"patchId": "39f9cdd1-795c-4d0e-8c0a-73ab3f31746d",
"name": "Windows Malicious Software Removal Tool x64 - October 2018 (KB890830)",
"version": "",
"kbId": "890830",
"classifications": [
"Update Rollups"
],
"installationState": "Pending"
}
],
"error": null
}
Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2024-03-01
Definisi
Nama | Deskripsi |
---|---|
Api |
Kesalahan api. |
Api |
Basis kesalahan api. |
Cloud |
Respons kesalahan dari layanan Komputasi. |
Inner |
Detail kesalahan dalam. |
Linux |
Input untuk InstallPatches pada VM Linux, seperti yang diterima langsung oleh API |
Patch |
Patch yang diinstal selama operasi. |
Patch |
Status patch setelah operasi penginstalan selesai. |
Patch |
Status keberhasilan atau kegagalan operasi secara keseluruhan. Ini tetap "InProgress" sampai operasi selesai. Pada saat itu akan menjadi "Gagal", "Berhasil", "Tidak Diketahui" atau "CompletedWithWarnings." |
Virtual |
Input untuk InstallPatches seperti yang diterima langsung oleh API |
Virtual |
Ringkasan hasil operasi penginstalan. |
VMGuest |
Klasifikasi pembaruan yang akan dipilih saat menginstal patch untuk Linux. |
VMGuest |
Klasifikasi pembaruan yang akan dipilih saat menginstal patch untuk Windows. |
VMGuest |
Menentukan kapan dapat diterima untuk me-reboot VM selama operasi pembaruan perangkat lunak. |
VMGuest |
Status boot ulang VM setelah penyelesaian operasi. |
Windows |
Input untuk InstallPatches pada VM Windows, seperti yang diterima langsung oleh API |
ApiError
Kesalahan api.
Nama | Jenis | Deskripsi |
---|---|---|
code |
string |
Kode kesalahan. |
details |
Detail kesalahan Api |
|
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 |
Kesalahan api. |
InnerError
Detail kesalahan dalam.
Nama | Jenis | Deskripsi |
---|---|---|
errordetail |
string |
Pesan kesalahan internal atau cadangan pengecualian. |
exceptiontype |
string |
Jenis pengecualian. |
LinuxParameters
Input untuk InstallPatches pada VM Linux, seperti yang diterima langsung oleh API
Nama | Jenis | Deskripsi |
---|---|---|
classificationsToInclude |
Klasifikasi pembaruan yang akan dipilih saat menginstal patch untuk Linux. |
|
maintenanceRunId |
string |
Ini digunakan sebagai pengidentifikasi eksekusi pemeliharaan untuk Patching Tamu VM Otomatis di Linux. |
packageNameMasksToExclude |
string[] |
paket yang akan dikecualikan dalam operasi patch. Format: packageName_packageVersion |
packageNameMasksToInclude |
string[] |
paket untuk disertakan dalam operasi patch. Format: packageName_packageVersion |
PatchInstallationDetail
Patch yang diinstal selama operasi.
Nama | Jenis | Deskripsi |
---|---|---|
classifications |
string[] |
Klasifikasi patch sebagaimana disediakan oleh penerbit patch. |
installationState |
Status patch setelah operasi penginstalan selesai. |
|
kbId |
string |
KBID patch. Hanya berlaku untuk patch Windows. |
name |
string |
Nama patch yang ramah. |
patchId |
string |
Pengidentifikasi unik untuk patch. |
version |
string |
String versi paket. Ini mungkin sesuai dengan Penerapan Versi Semantik. Hanya berlaku untuk Linux. |
PatchInstallationState
Status patch setelah operasi penginstalan selesai.
Nama | Jenis | Deskripsi |
---|---|---|
Excluded |
string |
|
Failed |
string |
|
Installed |
string |
|
NotSelected |
string |
|
Pending |
string |
|
Unknown |
string |
PatchOperationStatus
Status keberhasilan atau kegagalan operasi secara keseluruhan. Ini tetap "InProgress" sampai operasi selesai. Pada saat itu akan menjadi "Gagal", "Berhasil", "Tidak Diketahui" atau "CompletedWithWarnings."
Nama | Jenis | Deskripsi |
---|---|---|
CompletedWithWarnings |
string |
|
Failed |
string |
|
InProgress |
string |
|
Succeeded |
string |
|
Unknown |
string |
VirtualMachineInstallPatchesParameters
Input untuk InstallPatches seperti yang diterima langsung oleh API
Nama | Jenis | Deskripsi |
---|---|---|
linuxParameters |
Input untuk InstallPatches pada VM Linux, seperti yang diterima langsung oleh API |
|
maximumDuration |
string |
Menentukan jumlah waktu maksimum operasi akan berjalan. Ini harus berupa string durasi yang mematuhi ISO 8601 seperti PT4H (4 jam) |
rebootSetting |
Menentukan kapan dapat diterima untuk me-reboot VM selama operasi pembaruan perangkat lunak. |
|
windowsParameters |
Input untuk InstallPatches pada VM Windows, seperti yang diterima langsung oleh API |
VirtualMachineInstallPatchesResult
Ringkasan hasil operasi penginstalan.
Nama | Jenis | Deskripsi |
---|---|---|
error |
Kesalahan yang ditemui selama eksekusi operasi. Array detail berisi daftarnya. |
|
excludedPatchCount |
integer |
Jumlah patch yang tidak diinstal karena pengguna memblokir penginstalan mereka. |
failedPatchCount |
integer |
Jumlah patch yang tidak dapat diinstal karena beberapa masalah. Lihat kesalahan untuk detailnya. |
installationActivityId |
string |
ID aktivitas operasi yang menghasilkan hasil ini. Ini digunakan untuk berkorelasi di seluruh log CRP dan ekstensi. |
installedPatchCount |
integer |
Jumlah patch berhasil diinstal. |
maintenanceWindowExceeded |
boolean |
Apakah operasi kehabisan waktu sebelum menyelesaikan semua tindakan yang dimaksudkan. |
notSelectedPatchCount |
integer |
Jumlah patch yang terdeteksi tersedia untuk diinstal, tetapi tidak memenuhi kriteria operasi. |
patches |
Patch yang diinstal selama operasi. |
|
pendingPatchCount |
integer |
Jumlah patch yang diidentifikasi sebagai memenuhi kriteria penginstalan, tetapi tidak dapat diinstal. Biasanya ini terjadi ketika maintenanceWindowExceeded == true. |
rebootStatus |
Status boot ulang VM setelah penyelesaian operasi. |
|
startDateTime |
string |
Tanda waktu UTC ketika operasi dimulai. |
status |
Status keberhasilan atau kegagalan operasi secara keseluruhan. Ini tetap "InProgress" sampai operasi selesai. Pada saat itu akan menjadi "Gagal", "Berhasil", "Tidak Diketahui" atau "CompletedWithWarnings." |
VMGuestPatchClassification_Linux
Klasifikasi pembaruan yang akan dipilih saat menginstal patch untuk Linux.
Nama | Jenis | Deskripsi |
---|---|---|
Critical |
string |
|
Other |
string |
|
Security |
string |
VMGuestPatchClassification_Windows
Klasifikasi pembaruan yang akan dipilih saat menginstal patch untuk Windows.
Nama | Jenis | Deskripsi |
---|---|---|
Critical |
string |
|
Definition |
string |
|
FeaturePack |
string |
|
Security |
string |
|
ServicePack |
string |
|
Tools |
string |
|
UpdateRollUp |
string |
|
Updates |
string |
VMGuestPatchRebootSetting
Menentukan kapan dapat diterima untuk me-reboot VM selama operasi pembaruan perangkat lunak.
Nama | Jenis | Deskripsi |
---|---|---|
Always |
string |
|
IfRequired |
string |
|
Never |
string |
VMGuestPatchRebootStatus
Status boot ulang VM setelah penyelesaian operasi.
Nama | Jenis | Deskripsi |
---|---|---|
Completed |
string |
|
Failed |
string |
|
NotNeeded |
string |
|
Required |
string |
|
Started |
string |
|
Unknown |
string |
WindowsParameters
Input untuk InstallPatches pada VM Windows, seperti yang diterima langsung oleh API
Nama | Jenis | Deskripsi |
---|---|---|
classificationsToInclude |
Klasifikasi pembaruan yang akan dipilih saat menginstal patch untuk Windows. |
|
excludeKbsRequiringReboot |
boolean |
Memfilter Kbs yang tidak memiliki InstallationRebootBehavior dari 'NeverReboots' ketika ini diatur ke true. |
kbNumbersToExclude |
string[] |
Kbs untuk dikecualikan dalam operasi patch |
kbNumbersToInclude |
string[] |
Kbs untuk disertakan dalam operasi patch |
maxPatchPublishDate |
string |
Ini digunakan untuk menginstal patch yang diterbitkan pada atau sebelum tanggal publikasi maks yang diberikan ini. |