Virtual Machines - Install Patches

參考

Service:: Compute

API Version:: 2024-03-01

在 VM 上安裝修補程式。

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

URI 參數

名稱	位於	必要	類型	Description
resourceGroupName	path	True	string	資源群組的名稱。
subscriptionId	path	True	string	可唯一識別 Microsoft Azure 訂用帳戶的訂用帳戶認證。訂用帳戶識別碼會構成每個服務呼叫 URI 的一部分。
vmName	path	True	string	虛擬機器的名稱。
api-version	query	True	string	用戶端 API 版本。

要求本文

名稱	類型	Description
installPatchesInput	VirtualMachineInstallPatchesParameters	由 API 直接接收的 InstallPatches 輸入

回應

名稱	類型	Description
200 OK	VirtualMachineInstallPatchesResult	確定
202 Accepted		已接受
Other Status Codes	CloudError	描述作業失敗原因的錯誤回應。

安全性

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

名稱	Description
user_impersonation	模擬您的用戶帳戶

範例

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"
  }
}


import com.azure.resourcemanager.compute.models.VMGuestPatchClassificationWindows;
import com.azure.resourcemanager.compute.models.VMGuestPatchRebootSetting;
import com.azure.resourcemanager.compute.models.VirtualMachineInstallPatchesParameters;
import com.azure.resourcemanager.compute.models.WindowsParameters;
import java.time.OffsetDateTime;
import java.util.Arrays;

/**
 * Samples for VirtualMachines InstallPatches.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/
     * virtualMachineExamples/VirtualMachine_InstallPatches.json
     */
    /**
     * Sample code: Install patch state of a virtual machine.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void installPatchStateOfAVirtualMachine(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getVirtualMachines().installPatches("myResourceGroupName",
            "myVMName",
            new VirtualMachineInstallPatchesParameters().withMaximumDuration("PT4H")
                .withRebootSetting(VMGuestPatchRebootSetting.IF_REQUIRED)
                .withWindowsParameters(new WindowsParameters()
                    .withClassificationsToInclude(Arrays.asList(VMGuestPatchClassificationWindows.CRITICAL,
                        VMGuestPatchClassificationWindows.SECURITY))
                    .withMaxPatchPublishDate(OffsetDateTime.parse("2020-11-19T02:36:43.0539904+00:00"))),
            com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

from typing import Any, IO, Union

from azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python virtual_machine_install_patches.py

    Before run the sample, please set the values of the client ID, tenant ID and client secret
    of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
    AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
    https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""


def main():
    client = ComputeManagementClient(
        credential=DefaultAzureCredential(),
        subscription_id="{subscription-id}",
    )

    response = client.virtual_machines.begin_install_patches(
        resource_group_name="myResourceGroupName",
        vm_name="myVMName",
        install_patches_input={
            "maximumDuration": "PT4H",
            "rebootSetting": "IfRequired",
            "windowsParameters": {
                "classificationsToInclude": ["Critical", "Security"],
                "maxPatchPublishDate": "2020-11-19T02:36:43.0539904+00:00",
            },
        },
    ).result()
    print(response)


# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_InstallPatches.json
if __name__ == "__main__":
    main()

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

package armcompute_test

import (
	"context"
	"log"

	"time"

	"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v5"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_InstallPatches.json
func ExampleVirtualMachinesClient_BeginInstallPatches() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	poller, err := clientFactory.NewVirtualMachinesClient().BeginInstallPatches(ctx, "myResourceGroupName", "myVMName", armcompute.VirtualMachineInstallPatchesParameters{
		MaximumDuration: to.Ptr("PT4H"),
		RebootSetting:   to.Ptr(armcompute.VMGuestPatchRebootSettingIfRequired),
		WindowsParameters: &armcompute.WindowsParameters{
			ClassificationsToInclude: []*armcompute.VMGuestPatchClassificationWindows{
				to.Ptr(armcompute.VMGuestPatchClassificationWindowsCritical),
				to.Ptr(armcompute.VMGuestPatchClassificationWindowsSecurity)},
			MaxPatchPublishDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-11-19T02:36:43.053Z"); return t }()),
		},
	}, nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	res, err := poller.PollUntilDone(ctx, nil)
	if err != nil {
		log.Fatalf("failed to pull the result: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.VirtualMachineInstallPatchesResult = armcompute.VirtualMachineInstallPatchesResult{
	// 	ExcludedPatchCount: to.Ptr[int32](0),
	// 	FailedPatchCount: to.Ptr[int32](0),
	// 	InstallationActivityID: to.Ptr("68f8b292-dfc2-4646-9781-33cc88631968"),
	// 	InstalledPatchCount: to.Ptr[int32](3),
	// 	MaintenanceWindowExceeded: to.Ptr(false),
	// 	NotSelectedPatchCount: to.Ptr[int32](0),
	// 	Patches: []*armcompute.PatchInstallationDetail{
	// 		{
	// 			Name: to.Ptr("Definition Update for Windows Defender Antivirus - KB2267602 (Definition 1.279.1373.0)"),
	// 			Classifications: []*string{
	// 				to.Ptr("Definition Updates")},
	// 				InstallationState: to.Ptr(armcompute.PatchInstallationStateInstalled),
	// 				KbID: to.Ptr("2267602"),
	// 				PatchID: to.Ptr("35428702-5784-4ba4-a6e0-5222258b5411"),
	// 				Version: to.Ptr(""),
	// 			},
	// 			{
	// 				Name: to.Ptr("Windows Malicious Software Removal Tool x64 - October 2018 (KB890830)"),
	// 				Classifications: []*string{
	// 					to.Ptr("Update Rollups")},
	// 					InstallationState: to.Ptr(armcompute.PatchInstallationStatePending),
	// 					KbID: to.Ptr("890830"),
	// 					PatchID: to.Ptr("39f9cdd1-795c-4d0e-8c0a-73ab3f31746d"),
	// 					Version: to.Ptr(""),
	// 			}},
	// 			PendingPatchCount: to.Ptr[int32](2),
	// 			RebootStatus: to.Ptr(armcompute.VMGuestPatchRebootStatusCompleted),
	// 			StartDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-04-24T21:02:04.255Z"); return t}()),
	// 			Status: to.Ptr(armcompute.PatchOperationStatusSucceeded),
	// 		}
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Installs patches on the VM.
 *
 * @summary Installs patches on the VM.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_InstallPatches.json
 */
async function installPatchStateOfAVirtualMachine() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroupName";
  const vmName = "myVMName";
  const installPatchesInput = {
    maximumDuration: "PT4H",
    rebootSetting: "IfRequired",
    windowsParameters: {
      classificationsToInclude: ["Critical", "Security"],
      maxPatchPublishDate: new Date("2020-11-19T02:36:43.0539904+00:00"),
    },
  };
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachines.beginInstallPatchesAndWait(
    resourceGroupName,
    vmName,
    installPatchesInput,
  );
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:: 200

{
  "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
}

Status code:: 202

Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2024-03-01

定義

名稱	Description
ApiError	Api 錯誤。
ApiErrorBase	Api 錯誤基底。
CloudError	計算服務的錯誤回應。
InnerError	內部錯誤詳細數據。
LinuxParameters	Linux VM 上的 InstallPatches 輸入，如 API 直接接收
PatchInstallationDetail	作業期間安裝的修補程式。
PatchInstallationState	安裝作業完成後的修補程序狀態。
PatchOperationStatus	作業的整體成功或失敗狀態。它會維持「InProgress」，直到作業完成為止。此時，它會變成「失敗」、「成功」、「未知」或「CompletedWithWarnings」。
VirtualMachineInstallPatchesParameters	由 API 直接接收的 InstallPatches 輸入
VirtualMachineInstallPatchesResult	安裝作業的結果摘要。
VMGuestPatchClassification_Linux	安裝 Linux 修補程式時要選取的更新分類。
VMGuestPatchClassification_Windows	安裝 Windows 修補程式時要選取的更新分類。
VMGuestPatchRebootSetting	定義在軟體更新作業期間可接受重新啟動 VM 的時機。
VMGuestPatchRebootStatus	完成作業之後 VM 的重新啟動狀態。
WindowsParameters	Windows VM 上 InstallPatches 的輸入，如 API 直接接收

ApiError

Api 錯誤。

名稱	類型	Description
code	string	錯誤碼。
details	ApiErrorBase[]	API 錯誤詳細數據
innererror	InnerError	Api 內部錯誤
message	string	錯誤訊息。
target	string	特定錯誤的目標。

ApiErrorBase

Api 錯誤基底。

名稱	類型	Description
code	string	錯誤碼。
message	string	錯誤訊息。
target	string	特定錯誤的目標。

CloudError

計算服務的錯誤回應。

名稱	類型	Description
error	ApiError	Api 錯誤。

InnerError

內部錯誤詳細數據。

名稱	類型	Description
errordetail	string	內部錯誤訊息或例外狀況傾印。
exceptiontype	string	例外狀況型別。

LinuxParameters

Linux VM 上的 InstallPatches 輸入，如 API 直接接收

名稱	類型	Description
classificationsToInclude	VMGuestPatchClassification_Linux[]	安裝 Linux 修補程式時要選取的更新分類。
maintenanceRunId	string	這會作為Linux中自動VM客體修補的維護執行標識碼。
packageNameMasksToExclude	string[]	修補作業中要排除的套件。格式：packageName_packageVersion
packageNameMasksToInclude	string[]	要包含在修補作業中的套件。格式：packageName_packageVersion

PatchInstallationDetail

作業期間安裝的修補程式。

名稱	類型	Description
classifications	string[]	修補程式發行者所提供的修補程序分類 () 。
installationState	PatchInstallationState	安裝作業完成後的修補程序狀態。
kbId	string	修補程式的 KBID。僅適用於 Windows 修補程式。
name	string	修補程式的易記名稱。
patchId	string	修補程式的唯一標識碼。
version	string	封裝的版本字串。它可能符合語意版本設定。僅適用於Linux。

PatchInstallationState

安裝作業完成後的修補程序狀態。

名稱	類型	Description
Excluded	string
Failed	string
Installed	string
NotSelected	string
Pending	string
Unknown	string

PatchOperationStatus

作業的整體成功或失敗狀態。它會維持「InProgress」，直到作業完成為止。此時，它會變成「失敗」、「成功」、「未知」或「CompletedWithWarnings」。

名稱	類型	Description
CompletedWithWarnings	string
Failed	string
InProgress	string
Succeeded	string
Unknown	string

VirtualMachineInstallPatchesParameters

由 API 直接接收的 InstallPatches 輸入

名稱	類型	Description
linuxParameters	LinuxParameters	Linux VM 上的 InstallPatches 輸入，如 API 直接接收
maximumDuration	string	指定作業將執行的最大時間量。它必須是符合 ISO 8601 規範的持續時間字串，例如 PT4H (4 小時)
rebootSetting	VMGuestPatchRebootSetting	定義在軟體更新作業期間可接受重新啟動 VM 的時機。
windowsParameters	WindowsParameters	Windows VM 上 InstallPatches 的輸入，如 API 直接接收

VirtualMachineInstallPatchesResult

安裝作業的結果摘要。

名稱	類型	Description
error	ApiError	執行作業期間遇到的錯誤。詳細數據陣列包含它們的清單。
excludedPatchCount	integer	因為使用者封鎖其安裝而未安裝的修補程式數目。
failedPatchCount	integer	因某些問題而無法安裝的修補程式數目。如需詳細資訊，請參閱錯誤。
installationActivityId	string	產生此結果之作業的活動標識碼。它用來相互關聯CRP和延伸模組記錄。
installedPatchCount	integer	已成功安裝的修補程式數目。
maintenanceWindowExceeded	boolean	作業在完成所有預定動作之前，是否已用盡時間。
notSelectedPatchCount	integer	偵測到為可供安裝的修補程式數目，但不符合作業的準則。
patches	PatchInstallationDetail[]	作業期間安裝的修補程式。
pendingPatchCount	integer	識別為符合安裝準則但無法安裝的修補程式數目。一般而言，當 maintenanceWindowExceeded == true 時，就會發生這種情況。
rebootStatus	VMGuestPatchRebootStatus	完成作業之後 VM 的重新啟動狀態。
startDateTime	string	作業開始時的 UTC 時間戳。
status	PatchOperationStatus	作業的整體成功或失敗狀態。它會維持「InProgress」，直到作業完成為止。此時，它會變成「失敗」、「成功」、「未知」或「CompletedWithWarnings」。

VMGuestPatchClassification_Linux

安裝 Linux 修補程式時要選取的更新分類。

名稱	類型	Description
Critical	string
Other	string
Security	string

VMGuestPatchClassification_Windows

安裝 Windows 修補程式時要選取的更新分類。

名稱	類型	Description
Critical	string
Definition	string
FeaturePack	string
Security	string
ServicePack	string
Tools	string
UpdateRollUp	string
Updates	string

VMGuestPatchRebootSetting

定義在軟體更新作業期間可接受重新啟動 VM 的時機。

名稱	類型	Description
Always	string
IfRequired	string
Never	string

VMGuestPatchRebootStatus

完成作業之後 VM 的重新啟動狀態。

名稱	類型	Description
Completed	string
Failed	string
NotNeeded	string
Required	string
Started	string
Unknown	string

WindowsParameters

Windows VM 上 InstallPatches 的輸入，如 API 直接接收

名稱	類型	Description
classificationsToInclude	VMGuestPatchClassification_Windows[]	安裝 Windows 修補程式時要選取的更新分類。
excludeKbsRequiringReboot	boolean	篩選掉當此值設定為 true 時，沒有 'NeverReboots' 的 InstallationRebootBehavior 的 Kb。
kbNumbersToExclude	string[]	修補作業中要排除的 Kbs
kbNumbersToInclude	string[]	要包含在修補作業中的 Kbs
maxPatchPublishDate	string	這是用來安裝在此指定發行日期上限之前或之前發佈的修補程式。

Share via

Virtual Machines - Install Patches

URI 參數

要求本文

回應

安全性

azure_auth

Scopes

範例

Install patch state of a virtual machine.

Sample Request

Sample Response

定義

ApiError

ApiErrorBase

CloudError

InnerError

LinuxParameters

PatchInstallationDetail

PatchInstallationState

PatchOperationStatus

VirtualMachineInstallPatchesParameters

VirtualMachineInstallPatchesResult

VMGuestPatchClassification_Linux

VMGuestPatchClassification_Windows

VMGuestPatchRebootSetting

VMGuestPatchRebootStatus

WindowsParameters

其他資源