Dela via


Virtual Machines - Install Patches

Installerar korrigeringar på den virtuella datorn.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/installPatches?api-version=2024-07-01

URI-parametrar

Name I Obligatorisk Typ Description
resourceGroupName
path True

string

Namnet på resursgruppen.

subscriptionId
path True

string

Prenumerationsautentiseringsuppgifter som unikt identifierar Microsoft Azure-prenumeration. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop.

vmName
path True

string

Namnet på den virtuella datorn.

api-version
query True

string

Klient-API-version.

Begärandetext

Name Typ Description
installPatchesInput

VirtualMachineInstallPatchesParameters

Indata för InstallPatches som tas emot direkt av API:et

Svar

Name Typ Description
200 OK

VirtualMachineInstallPatchesResult

OKEJ

202 Accepted

Accepterad

Other Status Codes

CloudError

Felsvar som beskriver varför åtgärden misslyckades.

Säkerhet

azure_auth

Azure Active Directory OAuth2 Flow

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

Install patch state of a virtual machine.

Exempelbegäran

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroupName/providers/Microsoft.Compute/virtualMachines/myVMName/installPatches?api-version=2024-07-01

{
  "maximumDuration": "PT4H",
  "rebootSetting": "IfRequired",
  "windowsParameters": {
    "classificationsToInclude": [
      "Critical",
      "Security"
    ],
    "maxPatchPublishDate": "2020-11-19T02:36:43.0539904+00:00"
  }
}

Exempelsvar

{
  "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-07-01

Definitioner

Name Description
ApiError

Api-fel.

ApiErrorBase

Api-felbas.

CloudError

Ett felsvar från Compute-tjänsten.

InnerError

Inre felinformation.

LinuxParameters

Indata för InstallPatches på en virtuell Linux-dator, som tas emot direkt av API:et

PatchInstallationDetail

Korrigeringarna som installerades under åtgärden.

PatchInstallationState

Status för korrigeringen när installationen har slutförts.

PatchOperationStatus

Åtgärdens övergripande status för lyckade eller misslyckade åtgärder. Den förblir "InProgress" tills åtgärden har slutförts. Då blir det "Failed", "Succeeded", "Unknown" eller "CompletedWithWarnings".

VirtualMachineInstallPatchesParameters

Indata för InstallPatches som tas emot direkt av API:et

VirtualMachineInstallPatchesResult

Resultatsammanfattningen för en installationsåtgärd.

VMGuestPatchClassification_Linux

De uppdateringsklassificeringar som ska väljas när du installerar korrigeringar för Linux.

VMGuestPatchClassification_Windows

De uppdateringsklassificeringar som ska väljas vid installation av korrigeringar för Windows.

VMGuestPatchRebootSetting

Definierar när det är acceptabelt att starta om en virtuell dator under en programuppdateringsåtgärd.

VMGuestPatchRebootStatus

Omstartstillståndet för den virtuella datorn efter att åtgärden har slutförts.

WindowsParameters

Indata för InstallPatches på en virtuell Windows-dator, som tas emot direkt av API:et

ApiError

Api-fel.

Name Typ Description
code

string

Felkoden.

details

ApiErrorBase[]

Api-felinformationen

innererror

InnerError

Api:ets inre fel

message

string

Felmeddelandet.

target

string

Målet för det specifika felet.

ApiErrorBase

Api-felbas.

Name Typ Description
code

string

Felkoden.

message

string

Felmeddelandet.

target

string

Målet för det specifika felet.

CloudError

Ett felsvar från Compute-tjänsten.

Name Typ Description
error

ApiError

Api-fel.

InnerError

Inre felinformation.

Name Typ Description
errordetail

string

Det interna felmeddelandet eller undantagsdumpen.

exceptiontype

string

Undantagstypen.

LinuxParameters

Indata för InstallPatches på en virtuell Linux-dator, som tas emot direkt av API:et

Name Typ Description
classificationsToInclude

VMGuestPatchClassification_Linux[]

De uppdateringsklassificeringar som ska väljas när du installerar korrigeringar för Linux.

maintenanceRunId

string

Detta används som en underhållskörningsidentifierare för automatisk vm-gästkorrigering i Linux.

packageNameMasksToExclude

string[]

paket som ska undantas i korrigeringsåtgärden. Format: packageName_packageVersion

packageNameMasksToInclude

string[]

paket som ska ingå i korrigeringsåtgärden. Format: packageName_packageVersion

PatchInstallationDetail

Korrigeringarna som installerades under åtgärden.

Name Typ Description
classifications

string[]

Korrigeringsutgivarens klassificeringar.

installationState

PatchInstallationState

Status för korrigeringen när installationen har slutförts.

kbId

string

KBID för korrigeringen. Gäller endast Windows-korrigeringar.

name

string

Det egna namnet på korrigeringen.

patchId

string

En unik identifierare för korrigeringen.

version

string

Versionssträngen för paketet. Den kan överensstämma med semantisk versionshantering. Gäller endast för Linux.

PatchInstallationState

Status för korrigeringen när installationen har slutförts.

Värde Description
Excluded
Failed
Installed
NotSelected
Pending
Unknown

PatchOperationStatus

Åtgärdens övergripande status för lyckade eller misslyckade åtgärder. Den förblir "InProgress" tills åtgärden har slutförts. Då blir det "Failed", "Succeeded", "Unknown" eller "CompletedWithWarnings".

Värde Description
CompletedWithWarnings
Failed
InProgress
Succeeded
Unknown

VirtualMachineInstallPatchesParameters

Indata för InstallPatches som tas emot direkt av API:et

Name Typ Description
linuxParameters

LinuxParameters

Indata för InstallPatches på en virtuell Linux-dator, som tas emot direkt av API:et

maximumDuration

string

Anger den maximala tid som åtgärden ska köras. Det måste vara en ISO 8601-kompatibel varaktighetssträng, till exempel PT4H (4 timmar)

rebootSetting

VMGuestPatchRebootSetting

Definierar när det är acceptabelt att starta om en virtuell dator under en programuppdateringsåtgärd.

windowsParameters

WindowsParameters

Indata för InstallPatches på en virtuell Windows-dator, som tas emot direkt av API:et

VirtualMachineInstallPatchesResult

Resultatsammanfattningen för en installationsåtgärd.

Name Typ Description
error

ApiError

De fel som påträffades under körningen av åtgärden. Informationsmatrisen innehåller listan över dem.

excludedPatchCount

integer

Antalet korrigeringar som inte har installerats på grund av att användaren blockerar installationen.

failedPatchCount

integer

Antalet korrigeringar som inte kunde installeras på grund av ett problem. Mer information finns i fel.

installationActivityId

string

Aktivitets-ID för den åtgärd som genererade det här resultatet. Det används för att korrelera mellan CRP- och tilläggsloggar.

installedPatchCount

integer

Antalet korrigeringar har installerats.

maintenanceWindowExceeded

boolean

Om åtgärden tog slut innan den slutförde alla avsedda åtgärder.

notSelectedPatchCount

integer

Antalet korrigeringar som identifierades som tillgängliga för installation, men som inte uppfyllde åtgärdens villkor.

patches

PatchInstallationDetail[]

Korrigeringarna som installerades under åtgärden.

pendingPatchCount

integer

Antalet korrigeringar som identifierades som uppfyller installationsvillkoren, men som inte kunde installeras. Detta inträffar vanligtvis när underhållWindowExceeded == true.

rebootStatus

VMGuestPatchRebootStatus

Omstartstillståndet för den virtuella datorn efter att åtgärden har slutförts.

startDateTime

string

UTC-tidsstämpeln när åtgärden påbörjades.

status

PatchOperationStatus

Åtgärdens övergripande status för lyckade eller misslyckade åtgärder. Den förblir "InProgress" tills åtgärden har slutförts. Då blir det "Failed", "Succeeded", "Unknown" eller "CompletedWithWarnings".

VMGuestPatchClassification_Linux

De uppdateringsklassificeringar som ska väljas när du installerar korrigeringar för Linux.

Värde Description
Critical
Other
Security

VMGuestPatchClassification_Windows

De uppdateringsklassificeringar som ska väljas vid installation av korrigeringar för Windows.

Värde Description
Critical
Definition
FeaturePack
Security
ServicePack
Tools
UpdateRollUp
Updates

VMGuestPatchRebootSetting

Definierar när det är acceptabelt att starta om en virtuell dator under en programuppdateringsåtgärd.

Värde Description
Always
IfRequired
Never

VMGuestPatchRebootStatus

Omstartstillståndet för den virtuella datorn efter att åtgärden har slutförts.

Värde Description
Completed
Failed
NotNeeded
Required
Started
Unknown

WindowsParameters

Indata för InstallPatches på en virtuell Windows-dator, som tas emot direkt av API:et

Name Typ Description
classificationsToInclude

VMGuestPatchClassification_Windows[]

De uppdateringsklassificeringar som ska väljas vid installation av korrigeringar för Windows.

excludeKbsRequiringReboot

boolean

Filtrerar bort kbs som inte har en InstallationRebootBehavior av "NeverReboots" när detta är inställt på true.

kbNumbersToExclude

string[]

KB:ar som ska undantas i korrigeringsåtgärden

kbNumbersToInclude

string[]

Kbs som ska inkluderas i korrigeringsåtgärden

maxPatchPublishDate

string

Detta används för att installera korrigeringar som publicerades på eller före det angivna maxpubliceringsdatumet.