Virtual Machines - Assess Patches
Patches op de VM evalueren.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/assessPatches?api-version=2024-03-01
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string |
De naam van de resourcegroep. |
subscription
|
path | True |
string |
Abonnementsreferenties waarmee het Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke service-aanroep. |
vm
|
path | True |
string |
De naam van de virtuele machine. |
api-version
|
query | True |
string |
Client-API-versie. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
OK |
|
202 Accepted |
Geaccepteerd |
|
Other Status Codes |
Foutreactie waarin wordt beschreven waarom de bewerking is mislukt. |
Beveiliging
azure_auth
Azure Active Directory OAuth2-stroom
Type:
oauth2
Stroom:
implicit
Autorisatie-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiken
Name | Description |
---|---|
user_impersonation | uw gebruikersaccount imiteren |
Voorbeelden
Assess patch state of a virtual machine.
Voorbeeldaanvraag
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/virtualMachines/myVMName/assessPatches?api-version=2024-03-01
Voorbeeldrespons
{
"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
Definities
Name | Description |
---|---|
Api |
API-fout. |
Api |
API-foutbasis. |
Cloud |
Een foutreactie van de Compute-service. |
Inner |
Details van interne fout. |
Patch |
Beschrijft de beschikbaarheid van een bepaalde patch. |
Patch |
De algehele geslaagde of mislukte status van de bewerking. Het blijft 'InProgress' totdat de bewerking is voltooid. Op dat moment wordt het 'Onbekend', 'Mislukt', 'Geslaagd' of 'CompletedWithWarnings'. |
Virtual |
Beschrijft de eigenschappen van een AssessPatches-resultaat. |
Virtual |
De lijst met patches die zijn gedetecteerd als beschikbaar voor installatie. |
VMGuest |
Beschrijft de vereisten voor opnieuw opstarten van de patch. |
ApiError
API-fout.
Name | Type | Description |
---|---|---|
code |
string |
De foutcode. |
details |
De API-foutdetails |
|
innererror |
De interne API-fout |
|
message |
string |
Het foutbericht. |
target |
string |
Het doel van de specifieke fout. |
ApiErrorBase
API-foutbasis.
Name | Type | Description |
---|---|---|
code |
string |
De foutcode. |
message |
string |
Het foutbericht. |
target |
string |
Het doel van de specifieke fout. |
CloudError
Een foutreactie van de Compute-service.
Name | Type | Description |
---|---|---|
error |
API-fout. |
InnerError
Details van interne fout.
Name | Type | Description |
---|---|---|
errordetail |
string |
Het interne foutbericht of de uitzonderingsdump. |
exceptiontype |
string |
Het uitzonderingstype. |
PatchAssessmentState
Beschrijft de beschikbaarheid van een bepaalde patch.
Name | Type | Description |
---|---|---|
Available |
string |
|
Unknown |
string |
PatchOperationStatus
De algehele geslaagde of mislukte status van de bewerking. Het blijft 'InProgress' totdat de bewerking is voltooid. Op dat moment wordt het 'Onbekend', 'Mislukt', 'Geslaagd' of 'CompletedWithWarnings'.
Name | Type | Description |
---|---|---|
CompletedWithWarnings |
string |
|
Failed |
string |
|
InProgress |
string |
|
Succeeded |
string |
|
Unknown |
string |
VirtualMachineAssessPatchesResult
Beschrijft de eigenschappen van een AssessPatches-resultaat.
Name | Type | Description |
---|---|---|
assessmentActivityId |
string |
De activiteits-id van de bewerking die dit resultaat heeft geproduceerd. Het wordt gebruikt om te correleren tussen CRP- en extensielogboeken. |
availablePatches |
De lijst met patches die zijn gedetecteerd als beschikbaar voor installatie. |
|
criticalAndSecurityPatchCount |
integer |
Het aantal kritieke of beveiligingspatches dat is gedetecteerd als beschikbaar en nog niet geïnstalleerd. |
error |
De fouten die zijn opgetreden tijdens het uitvoeren van de bewerking. De detailmatrix bevat de lijst met de details. |
|
otherPatchCount |
integer |
Het aantal beschikbare patches, met uitzondering van kritiek en beveiliging. |
rebootPending |
boolean |
De algehele status van opnieuw opstarten van de VM. Dit is waar wanneer gedeeltelijk geïnstalleerde patches opnieuw moeten worden opgestart om de installatie te voltooien, maar het opnieuw opstarten nog niet heeft plaatsgevonden. |
startDateTime |
string |
De UTC-tijdstempel wanneer de bewerking is gestart. |
status |
De algehele geslaagde of mislukte status van de bewerking. Het blijft 'InProgress' totdat de bewerking is voltooid. Op dat moment wordt het 'Onbekend', 'Mislukt', 'Geslaagd' of 'CompletedWithWarnings'. |
VirtualMachineSoftwarePatchProperties
De lijst met patches die zijn gedetecteerd als beschikbaar voor installatie.
Name | Type | Description |
---|---|---|
activityId |
string |
De activiteits-id van de bewerking die dit resultaat heeft geproduceerd. Het wordt gebruikt om te correleren tussen CRP- en extensielogboeken. |
assessmentState |
Beschrijft de beschikbaarheid van een bepaalde patch. |
|
classifications |
string[] |
De classificatie(s) van de patch zoals opgegeven door de uitgever van de patch. |
kbId |
string |
De KBID van de patch. Alleen van toepassing op Windows-patches. |
lastModifiedDateTime |
string |
Het UTC-tijdstempel van de laatste update voor deze patchrecord. |
name |
string |
De beschrijvende naam van de patch. |
patchId |
string |
Een unieke id voor de patch. |
publishedDate |
string |
Het UTC-tijdstempel toen de opslagplaats deze patch heeft gepubliceerd. |
rebootBehavior |
Beschrijft de vereisten voor opnieuw opstarten van de patch. |
|
version |
string |
Het versienummer van de patch. Deze eigenschap is alleen van toepassing op Linux-patches. |
VMGuestPatchRebootBehavior
Beschrijft de vereisten voor opnieuw opstarten van de patch.
Name | Type | Description |
---|---|---|
AlwaysRequiresReboot |
string |
|
CanRequestReboot |
string |
|
NeverReboots |
string |
|
Unknown |
string |