Virtual Machines - Assess Patches
A virtuális gépen lévő javítások értékelése.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/assessPatches?api-version=2024-03-01
URI-paraméterek
Name | In | Kötelező | Típus | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Az erőforráscsoport neve. |
subscription
|
path | True |
string |
Az előfizetés hitelesítő adatai, amelyek egyedileg azonosítják a Microsoft Azure-előfizetést. Az előfizetés-azonosító az URI részét képezi minden szolgáltatáshíváshoz. |
vm
|
path | True |
string |
A virtuális gép neve. |
api-version
|
query | True |
string |
Ügyfél API-verziója. |
Válaszok
Name | Típus | Description |
---|---|---|
200 OK |
OK |
|
202 Accepted |
Elfogadva |
|
Other Status Codes |
Hibaválasz, amely leírja, hogy a művelet miért hiúsult meg. |
Biztonság
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | felhasználói fiók megszemélyesítése |
Példák
Assess patch state of a virtual machine.
Sample Request
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/virtualMachines/myVMName/assessPatches?api-version=2024-03-01
Sample Response
{
"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
Definíciók
Name | Description |
---|---|
Api |
Api-hiba. |
Api |
Api-hibabázis. |
Cloud |
Hibaválasz a Számítási szolgáltatástól. |
Inner |
Belső hiba részletei. |
Patch |
Egy adott javítás rendelkezésre állását ismerteti. |
Patch |
A művelet általános sikeressége vagy sikertelensége. A művelet befejezéséig a "Bejövő forgalom" marad. Ekkor "Ismeretlen", "Failed", "Succeeded" vagy "CompletedWithWarnings" lesz. |
Virtual |
Az AssessPatches-eredmények tulajdonságait ismerteti. |
Virtual |
A telepítéshez elérhetőként észlelt javítások listája. |
VMGuest |
A javítás újraindítási követelményeit ismerteti. |
ApiError
Api-hiba.
Name | Típus | Description |
---|---|---|
code |
string |
A hibakód. |
details |
Az API-hiba részletei |
|
innererror |
Az API belső hibája |
|
message |
string |
A hibaüzenet. |
target |
string |
Az adott hiba célja. |
ApiErrorBase
Api-hibabázis.
Name | Típus | Description |
---|---|---|
code |
string |
A hibakód. |
message |
string |
A hibaüzenet. |
target |
string |
Az adott hiba célja. |
CloudError
Hibaválasz a Számítási szolgáltatástól.
Name | Típus | Description |
---|---|---|
error |
Api-hiba. |
InnerError
Belső hiba részletei.
Name | Típus | Description |
---|---|---|
errordetail |
string |
A belső hibaüzenet vagy kivételkép. |
exceptiontype |
string |
A kivétel típusa. |
PatchAssessmentState
Egy adott javítás rendelkezésre állását ismerteti.
Name | Típus | Description |
---|---|---|
Available |
string |
|
Unknown |
string |
PatchOperationStatus
A művelet általános sikeressége vagy sikertelensége. A művelet befejezéséig a "Bejövő forgalom" marad. Ekkor "Ismeretlen", "Failed", "Succeeded" vagy "CompletedWithWarnings" lesz.
Name | Típus | Description |
---|---|---|
CompletedWithWarnings |
string |
|
Failed |
string |
|
InProgress |
string |
|
Succeeded |
string |
|
Unknown |
string |
VirtualMachineAssessPatchesResult
Az AssessPatches-eredmények tulajdonságait ismerteti.
Name | Típus | Description |
---|---|---|
assessmentActivityId |
string |
Az eredményt eredményező művelet tevékenységazonosítója. A CRP és a bővítménynaplók közötti korrelációra szolgál. |
availablePatches |
A telepítéshez elérhetőként észlelt javítások listája. |
|
criticalAndSecurityPatchCount |
integer |
Az elérhetőként észlelt és még nem telepített kritikus vagy biztonsági javítások száma. |
error |
A művelet végrehajtása során tapasztalt hibák. A részletek tömb tartalmazza a lista őket. |
|
otherPatchCount |
integer |
Az összes elérhető javítás száma, kivéve a kritikus és a biztonságot. |
rebootPending |
boolean |
A virtuális gép általános újraindítási állapota. Ez akkor lesz igaz, ha a részben telepített javítások újraindítást igényelnek a telepítés befejezéséhez, de az újraindítás még nem történt meg. |
startDateTime |
string |
A művelet kezdetének UTC időbélyege. |
status |
A művelet általános sikeressége vagy sikertelensége. A művelet befejezéséig a "Bejövő forgalom" marad. Ekkor "Ismeretlen", "Failed", "Succeeded" vagy "CompletedWithWarnings" lesz. |
VirtualMachineSoftwarePatchProperties
A telepítéshez elérhetőként észlelt javítások listája.
Name | Típus | Description |
---|---|---|
activityId |
string |
Az eredményt eredményező művelet tevékenységazonosítója. A CRP és a bővítménynaplók közötti korrelációra szolgál. |
assessmentState |
Egy adott javítás rendelkezésre állását ismerteti. |
|
classifications |
string[] |
A javításnak a javítás közzétevője által megadott besorolása(i). |
kbId |
string |
A javítás KBID azonosítója. Csak a Windows-javításokra vonatkozik. |
lastModifiedDateTime |
string |
A javításrekord utolsó frissítésének UTC időbélyege. |
name |
string |
A javítás rövid neve. |
patchId |
string |
A javítás egyedi azonosítója. |
publishedDate |
string |
Az UTC időbélyeg, amikor az adattár közzétette ezt a javítást. |
rebootBehavior |
A javítás újraindítási követelményeit ismerteti. |
|
version |
string |
A javítás verziószáma. Ez a tulajdonság csak Linux-javításokra vonatkozik. |
VMGuestPatchRebootBehavior
A javítás újraindítási követelményeit ismerteti.
Name | Típus | Description |
---|---|---|
AlwaysRequiresReboot |
string |
|
CanRequestReboot |
string |
|
NeverReboots |
string |
|
Unknown |
string |