Virtual Machines - Install Patches
Installeert patches op de VM.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/installPatches?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. |
Aanvraagbody
Name | Type | Description |
---|---|---|
installPatchesInput |
Invoer voor InstallPatches zoals rechtstreeks ontvangen door de API |
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
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | Uw gebruikersaccount imiteren |
Voorbeelden
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
Definities
Name | Description |
---|---|
Api |
API-fout. |
Api |
API-foutbasis. |
Cloud |
Een foutreactie van de Compute-service. |
Inner |
Details van interne fout. |
Linux |
Invoer voor InstallPatches op een Virtuele Linux-machine, zoals rechtstreeks ontvangen door de API |
Patch |
De patches die tijdens de bewerking zijn geïnstalleerd. |
Patch |
De status van de patch nadat de installatiebewerking is voltooid. |
Patch |
De algehele geslaagde of mislukte status van de bewerking. Het blijft 'InProgress' totdat de bewerking is voltooid. Op dat moment wordt het 'Failed', 'Succeeded', 'Unknown' of 'CompletedWithWarnings'. |
Virtual |
Invoer voor InstallPatches zoals rechtstreeks ontvangen door de API |
Virtual |
De samenvatting van het resultaat van een installatiebewerking. |
VMGuest |
De updateclassificaties die moeten worden geselecteerd bij het installeren van patches voor Linux. |
VMGuest |
De updateclassificaties die moeten worden geselecteerd bij het installeren van patches voor Windows. |
VMGuest |
Definieert wanneer het acceptabel is om een VM opnieuw op te starten tijdens een software-updatebewerking. |
VMGuest |
De status van het opnieuw opstarten van de VM na voltooiing van de bewerking. |
Windows |
Invoer voor InstallPatches op een Windows-VM, zoals rechtstreeks ontvangen door de API |
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. |
LinuxParameters
Invoer voor InstallPatches op een Virtuele Linux-machine, zoals rechtstreeks ontvangen door de API
Name | Type | Description |
---|---|---|
classificationsToInclude |
De updateclassificaties die moeten worden geselecteerd bij het installeren van patches voor Linux. |
|
maintenanceRunId |
string |
Dit wordt gebruikt als een onderhoudsuitvoerings-id voor automatische VM-gastpatching in Linux. |
packageNameMasksToExclude |
string[] |
pakketten die moeten worden uitgesloten in de patchbewerking. Indeling: packageName_packageVersion |
packageNameMasksToInclude |
string[] |
pakketten die moeten worden opgenomen in de patchbewerking. Indeling: packageName_packageVersion |
PatchInstallationDetail
De patches die tijdens de bewerking zijn geïnstalleerd.
Name | Type | Description |
---|---|---|
classifications |
string[] |
De classificatie(s) van de patch zoals opgegeven door de uitgever van de patch. |
installationState |
De status van de patch nadat de installatiebewerking is voltooid. |
|
kbId |
string |
De KBID van de patch. Alleen van toepassing op Windows-patches. |
name |
string |
De beschrijvende naam van de patch. |
patchId |
string |
Een unieke id voor de patch. |
version |
string |
De versietekenreeks van het pakket. Het kan voldoen aan Semantic Versioning. Alleen van toepassing op Linux. |
PatchInstallationState
De status van de patch nadat de installatiebewerking is voltooid.
Name | Type | Description |
---|---|---|
Excluded |
string |
|
Failed |
string |
|
Installed |
string |
|
NotSelected |
string |
|
Pending |
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 'Failed', 'Succeeded', 'Unknown' of 'CompletedWithWarnings'.
Name | Type | Description |
---|---|---|
CompletedWithWarnings |
string |
|
Failed |
string |
|
InProgress |
string |
|
Succeeded |
string |
|
Unknown |
string |
VirtualMachineInstallPatchesParameters
Invoer voor InstallPatches zoals rechtstreeks ontvangen door de API
Name | Type | Description |
---|---|---|
linuxParameters |
Invoer voor InstallPatches op een Virtuele Linux-machine, zoals rechtstreeks ontvangen door de API |
|
maximumDuration |
string |
Hiermee geeft u de maximale tijdsduur op die de bewerking moet worden uitgevoerd. Het moet een ISO 8601-compatibele duurtekenreeks zijn, zoals PT4H (4 uur) |
rebootSetting |
Definieert wanneer het acceptabel is om een VM opnieuw op te starten tijdens een software-updatebewerking. |
|
windowsParameters |
Invoer voor InstallPatches op een Windows-VM, zoals rechtstreeks ontvangen door de API |
VirtualMachineInstallPatchesResult
De samenvatting van het resultaat van een installatiebewerking.
Name | Type | Description |
---|---|---|
error |
De fouten die zijn opgetreden tijdens het uitvoeren van de bewerking. De matrix met details bevat de lijst ervan. |
|
excludedPatchCount |
integer |
Het aantal patches dat niet is geïnstalleerd omdat de gebruiker de installatie heeft geblokkeerd. |
failedPatchCount |
integer |
Het aantal patches dat niet kan worden geïnstalleerd vanwege een probleem. Zie fouten voor meer informatie. |
installationActivityId |
string |
De activiteits-id van de bewerking die dit resultaat heeft gegenereerd. Het wordt gebruikt om te correleren tussen CRP- en extensielogboeken. |
installedPatchCount |
integer |
Het aantal patches dat is geïnstalleerd. |
maintenanceWindowExceeded |
boolean |
Of de bewerking te laat is voordat alle beoogde acties zijn voltooid. |
notSelectedPatchCount |
integer |
Het aantal patches dat is gedetecteerd als beschikbaar voor installatie, maar niet voldoet aan de criteria van de bewerking. |
patches |
De patches die tijdens de bewerking zijn geïnstalleerd. |
|
pendingPatchCount |
integer |
Het aantal patches dat aan de installatiecriteria voldoet, maar niet kan worden geïnstalleerd. Dit gebeurt meestal wanneer maintenanceWindowExceeded == true is. |
rebootStatus |
De status van het opnieuw opstarten van de VM na voltooiing van de bewerking. |
|
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 'Failed', 'Succeeded', 'Unknown' of 'CompletedWithWarnings'. |
VMGuestPatchClassification_Linux
De updateclassificaties die moeten worden geselecteerd bij het installeren van patches voor Linux.
Name | Type | Description |
---|---|---|
Critical |
string |
|
Other |
string |
|
Security |
string |
VMGuestPatchClassification_Windows
De updateclassificaties die moeten worden geselecteerd bij het installeren van patches voor Windows.
Name | Type | Description |
---|---|---|
Critical |
string |
|
Definition |
string |
|
FeaturePack |
string |
|
Security |
string |
|
ServicePack |
string |
|
Tools |
string |
|
UpdateRollUp |
string |
|
Updates |
string |
VMGuestPatchRebootSetting
Definieert wanneer het acceptabel is om een VM opnieuw op te starten tijdens een software-updatebewerking.
Name | Type | Description |
---|---|---|
Always |
string |
|
IfRequired |
string |
|
Never |
string |
VMGuestPatchRebootStatus
De status van het opnieuw opstarten van de VM na voltooiing van de bewerking.
Name | Type | Description |
---|---|---|
Completed |
string |
|
Failed |
string |
|
NotNeeded |
string |
|
Required |
string |
|
Started |
string |
|
Unknown |
string |
WindowsParameters
Invoer voor InstallPatches op een Windows-VM, zoals rechtstreeks ontvangen door de API
Name | Type | Description |
---|---|---|
classificationsToInclude |
De updateclassificaties die moeten worden geselecteerd bij het installeren van patches voor Windows. |
|
excludeKbsRequiringReboot |
boolean |
Filtert Kb's uit die geen InstallationRebootBehavior van 'NeverReboots' hebben wanneer dit is ingesteld op true. |
kbNumbersToExclude |
string[] |
Kbs die moeten worden uitgesloten in de patchbewerking |
kbNumbersToInclude |
string[] |
Kbs die moeten worden opgenomen in de patchbewerking |
maxPatchPublishDate |
string |
Dit wordt gebruikt voor het installeren van patches die zijn gepubliceerd op of vóór deze opgegeven maximale publicatiedatum. |