Virtual Machines - Assess Patches
Menilai patch pada VM.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/assessPatches?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. |
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
Jenis:
oauth2
Alur:
implicit
URL Otorisasi:
https://login.microsoftonline.com/common/oauth2/authorize
Cakupan
Nama | Deskripsi |
---|---|
user_impersonation | meniru akun pengguna Anda |
Contoh
Assess patch state of a virtual machine.
Permintaan sampel
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/virtualMachines/myVMName/assessPatches?api-version=2024-03-01
Respon sampel
{
"status": "Succeeded",
"assessmentActivityId": "68f8b292-dfc2-4646-9781-33cc88631968",
"rebootPending": true,
"criticalAndSecurityPatchCount": 1,
"otherPatchCount": 2,
"startDateTime": "2020-04-24T21:02:04.2556154Z",
"availablePatches": [
{
"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"
],
"rebootBehavior": "NeverReboots",
"activityId": "68f8b292-dfc2-4646-9781-33cc88631968",
"publishedDate": "2018-11-07T00:00:00Z",
"lastModifiedDateTime": "2020-04-24T21:18:45.2830263Z",
"assessmentState": "Available"
},
{
"patchId": "39f9cdd1-795c-4d0e-8c0a-73ab3f31746d",
"name": "Windows Malicious Software Removal Tool x64 - October 2018 (KB890830)",
"version": "",
"kbId": "890830",
"classifications": [
"Update Rollups"
],
"rebootBehavior": "CanRequestReboot",
"activityId": "68f8b292-dfc2-4646-9781-33cc88631968",
"publishedDate": "2018-11-07T00:00:00Z",
"lastModifiedDateTime": "2020-04-24T21:18:45.2830263Z",
"assessmentState": "Available"
}
],
"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. |
Patch |
Menjelaskan ketersediaan patch tertentu. |
Patch |
Status keberhasilan atau kegagalan operasi secara keseluruhan. Ini tetap "InProgress" sampai operasi selesai. Pada saat itu akan menjadi "Tidak Diketahui", "Gagal", "Berhasil", atau "CompletedWithWarnings." |
Virtual |
Menjelaskan properti hasil AssessPatches. |
Virtual |
Daftar patch yang telah terdeteksi tersedia untuk penginstalan. |
VMGuest |
Menjelaskan persyaratan reboot patch. |
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. |
PatchAssessmentState
Menjelaskan ketersediaan patch tertentu.
Nama | Jenis | Deskripsi |
---|---|---|
Available |
string |
|
Unknown |
string |
PatchOperationStatus
Status keberhasilan atau kegagalan operasi secara keseluruhan. Ini tetap "InProgress" sampai operasi selesai. Pada saat itu akan menjadi "Tidak Diketahui", "Gagal", "Berhasil", atau "CompletedWithWarnings."
Nama | Jenis | Deskripsi |
---|---|---|
CompletedWithWarnings |
string |
|
Failed |
string |
|
InProgress |
string |
|
Succeeded |
string |
|
Unknown |
string |
VirtualMachineAssessPatchesResult
Menjelaskan properti hasil AssessPatches.
Nama | Jenis | Deskripsi |
---|---|---|
assessmentActivityId |
string |
ID aktivitas operasi yang menghasilkan hasil ini. Ini digunakan untuk berkorelasi di seluruh log CRP dan ekstensi. |
availablePatches |
Daftar patch yang telah terdeteksi tersedia untuk penginstalan. |
|
criticalAndSecurityPatchCount |
integer |
Jumlah patch penting atau keamanan yang telah terdeteksi sebagai tersedia dan belum diinstal. |
error |
Kesalahan yang ditemui selama eksekusi operasi. Array detail berisi daftarnya. |
|
otherPatchCount |
integer |
Jumlah semua patch yang tersedia tidak termasuk penting dan keamanan. |
rebootPending |
boolean |
Status boot ulang keseluruhan VM. Ini akan benar ketika patch yang diinstal sebagian memerlukan boot ulang untuk menyelesaikan penginstalan tetapi boot ulang belum terjadi. |
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 "Tidak Diketahui", "Gagal", "Berhasil", atau "CompletedWithWarnings." |
VirtualMachineSoftwarePatchProperties
Daftar patch yang telah terdeteksi tersedia untuk penginstalan.
Nama | Jenis | Deskripsi |
---|---|---|
activityId |
string |
ID aktivitas operasi yang menghasilkan hasil ini. Ini digunakan untuk berkorelasi di seluruh log CRP dan ekstensi. |
assessmentState |
Menjelaskan ketersediaan patch tertentu. |
|
classifications |
string[] |
Klasifikasi patch seperti yang disediakan oleh penerbit patch. |
kbId |
string |
KBID patch. Hanya berlaku untuk patch Windows. |
lastModifiedDateTime |
string |
Tanda waktu UTC dari pembaruan terakhir untuk rekaman patch ini. |
name |
string |
Nama patch yang ramah. |
patchId |
string |
Pengidentifikasi unik untuk patch. |
publishedDate |
string |
Tanda waktu UTC ketika repositori menerbitkan patch ini. |
rebootBehavior |
Menjelaskan persyaratan reboot patch. |
|
version |
string |
Nomor versi patch. Properti ini hanya berlaku untuk patch Linux. |
VMGuestPatchRebootBehavior
Menjelaskan persyaratan reboot patch.
Nama | Jenis | Deskripsi |
---|---|---|
AlwaysRequiresReboot |
string |
|
CanRequestReboot |
string |
|
NeverReboots |
string |
|
Unknown |
string |