Virtual Machines - Assess Patches

Hizmet:: Compute

API Sürümü:: 2025-11-01

VM'deki düzeltme eklerini değerlendirin.

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

URI Parametreleri

Name	İçinde	Gerekli	Tür	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Kaynak grubunun adı. İsim büyük/küçük harfe duyarsızdır.
subscriptionId	path	True	string minLength: 1	Hedef aboneliğin kimliği.
vmName	path	True	string	Sanal makinenin adı.
api-version	query	True	string minLength: 1	Bu işlem için kullanılacak API sürümü.

Yanıtlar

Name

Tür

Description

200 OK

VirtualMachineAssessPatchesResult

Azure işlemi başarıyla tamamlandı.

202 Accepted

Kaynak işlemi kabul edildi.

Üst Bilgiler

Location: string
Retry-After: integer

Other Status Codes

Beklenmeyen bir hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow.

Tür: oauth2
Akış: implicit
Yetkilendirme URL’si: https://login.microsoftonline.com/common/oauth2/authorize

Kapsamlar

Name	Description
user_impersonation	kullanıcı hesabınızın kimliğine bürünme

Örnekler

Assess patch state of a virtual machine.

Örnek isteği

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


/**
 * Samples for VirtualMachines AssessPatches.
 */
public final class Main {
    /*
     * x-ms-original-file: 2025-11-01/virtualMachineExamples/VirtualMachine_AssessPatches.json
     */
    /**
     * Sample code: Assess patch state of a virtual machine.
     * 
     * @param manager Entry point to ComputeManager.
     */
    public static void assessPatchStateOfAVirtualMachine(com.azure.resourcemanager.compute.ComputeManager manager) {
        manager.serviceClient().getVirtualMachines().assessPatches("myResourceGroupName", "myVMName",
            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 azure.identity import DefaultAzureCredential

from azure.mgmt.compute import ComputeManagementClient

"""
# PREREQUISITES
    pip install azure-identity
    pip install azure-mgmt-compute
# USAGE
    python virtual_machine_assess_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_assess_patches(
        resource_group_name="myResourceGroupName",
        vm_name="myVMName",
    ).result()
    print(response)


# x-ms-original-file: 2025-11-01/virtualMachineExamples/VirtualMachine_AssessPatches.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"

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

// Generated from example definition: 2025-11-01/virtualMachineExamples/VirtualMachine_AssessPatches.json
func ExampleVirtualMachinesClient_BeginAssessPatches() {
	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().BeginAssessPatches(ctx, "myResourceGroupName", "myVMName", 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 = armcompute.VirtualMachinesClientAssessPatchesResponse{
	// 	VirtualMachineAssessPatchesResult: &armcompute.VirtualMachineAssessPatchesResult{
	// 		Status: to.Ptr(armcompute.PatchOperationStatusSucceeded),
	// 		AssessmentActivityID: to.Ptr("68f8b292-dfc2-4646-9781-33cc88631968"),
	// 		RebootPending: to.Ptr(true),
	// 		CriticalAndSecurityPatchCount: to.Ptr[int32](1),
	// 		OtherPatchCount: to.Ptr[int32](2),
	// 		StartDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-04-24T21:02:04.2556154Z"); return t}()),
	// 		AvailablePatches: []*armcompute.VirtualMachineSoftwarePatchProperties{
	// 			{
	// 				PatchID: to.Ptr("35428702-5784-4ba4-a6e0-5222258b5411"),
	// 				Name: to.Ptr("Definition Update for Windows Defender Antivirus - KB2267602 (Definition 1.279.1373.0)"),
	// 				Version: to.Ptr(""),
	// 				KbID: to.Ptr("2267602"),
	// 				Classifications: []*string{
	// 					to.Ptr("Definition Updates"),
	// 				},
	// 				RebootBehavior: to.Ptr(armcompute.VMGuestPatchRebootBehaviorNeverReboots),
	// 				ActivityID: to.Ptr("68f8b292-dfc2-4646-9781-33cc88631968"),
	// 				PublishedDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-11-07T00:00:00Z"); return t}()),
	// 				LastModifiedDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-04-24T21:18:45.2830263Z"); return t}()),
	// 				AssessmentState: to.Ptr(armcompute.PatchAssessmentStateAvailable),
	// 			},
	// 			{
	// 				PatchID: to.Ptr("39f9cdd1-795c-4d0e-8c0a-73ab3f31746d"),
	// 				Name: to.Ptr("Windows Malicious Software Removal Tool x64 - October 2018 (KB890830)"),
	// 				Version: to.Ptr(""),
	// 				KbID: to.Ptr("890830"),
	// 				Classifications: []*string{
	// 					to.Ptr("Update Rollups"),
	// 				},
	// 				RebootBehavior: to.Ptr(armcompute.VMGuestPatchRebootBehaviorCanRequestReboot),
	// 				ActivityID: to.Ptr("68f8b292-dfc2-4646-9781-33cc88631968"),
	// 				PublishedDate: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2018-11-07T00:00:00Z"); return t}()),
	// 				LastModifiedDateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-04-24T21:18:45.2830263Z"); return t}()),
	// 				AssessmentState: to.Ptr(armcompute.PatchAssessmentStateAvailable),
	// 			},
	// 		},
	// 	},
	// }
}

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 assess patches on the VM.
 *
 * @summary assess patches on the VM.
 * x-ms-original-file: 2025-11-01/virtualMachineExamples/VirtualMachine_AssessPatches.json
 */
async function assessPatchStateOfAVirtualMachine() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "{subscription-id}";
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachines.assessPatches("myResourceGroupName", "myVMName");
  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

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using System.Xml;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Compute.Models;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/Compute/stable/2025-11-01/examples/virtualMachineExamples/VirtualMachine_AssessPatches.json
// this example is just showing the usage of "VirtualMachines_AssessPatches" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this VirtualMachineResource created on azure
// for more information of creating VirtualMachineResource, please refer to the document of VirtualMachineResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "myResourceGroupName";
string vmName = "myVMName";
ResourceIdentifier virtualMachineResourceId = VirtualMachineResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, vmName);
VirtualMachineResource virtualMachine = client.GetVirtualMachineResource(virtualMachineResourceId);

// invoke the operation
ArmOperation<VirtualMachineAssessPatchesResult> lro = await virtualMachine.AssessPatchesAsync(WaitUntil.Completed);
VirtualMachineAssessPatchesResult result = lro.Value;

Console.WriteLine($"Succeeded: {result}");

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

Örnek yanıt

Durum kodu:: 200

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

Durum kodu:: 202

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

Tanımlar

Name	Description
ApiError	API hatası.
ApiErrorBase	Api hata tabanı.
CloudError	İşlem hizmetinden bir hata yanıtı.
InnerError	İç hata ayrıntıları.
PatchAssessmentState	Belirli bir düzeltme ekinin kullanılabilirliğini açıklar.
PatchOperationStatus	İşlemin genel başarı veya başarısızlık durumu. İşlem tamamlanana kadar "InProgress" olarak kalır. Bu noktada "Bilinmeyen", "Başarısız", "Başarılı" veya "CompletedWithWarnings" olur.
VirtualMachineAssessPatchesResult	Bir AssessPatches sonucunun özelliklerini açıklar.
VirtualMachineSoftwarePatchProperties	Sanal Makine yazılım düzeltme ekinin özelliklerini açıklar.
VMGuestPatchRebootBehavior	Düzeltme ekinin yeniden başlatma gereksinimlerini açıklar.

ApiError

Nesne

API hatası.

Name	Tür	Description
code	string	Hata kodu.
details	ApiErrorBase[]	Api hata ayrıntıları
innererror	InnerError	Api iç hatası
message	string	Hata iletisi.
target	string	Belirli bir hatanın hedefi.

ApiErrorBase

Nesne

Api hata tabanı.

Name	Tür	Description
code	string	Hata kodu.
message	string	Hata iletisi.
target	string	Belirli bir hatanın hedefi.

CloudError

Nesne

İşlem hizmetinden bir hata yanıtı.

Name	Tür	Description
error	ApiError	API hatası.

InnerError

Nesne

İç hata ayrıntıları.

Name	Tür	Description
errordetail	string	İç hata iletisi veya özel durum dökümü.
exceptiontype	string	Özel durum türü.

PatchAssessmentState

Numaralandırma

Belirli bir düzeltme ekinin kullanılabilirliğini açıklar.

Değer	Description
Unknown
Available

PatchOperationStatus

Numaralandırma

İşlemin genel başarı veya başarısızlık durumu. İşlem tamamlanana kadar "InProgress" olarak kalır. Bu noktada "Bilinmeyen", "Başarısız", "Başarılı" veya "CompletedWithWarnings" olur.

Değer	Description
Unknown
InProgress
Failed
Succeeded
CompletedWithWarnings

VirtualMachineAssessPatchesResult

Nesne

Bir AssessPatches sonucunun özelliklerini açıklar.

Name	Tür	Description
assessmentActivityId	string	Bu sonucu üreten işlemin etkinlik kimliği. CRP ve uzantı günlükleri arasında ilişkilendirmek için kullanılır.
availablePatches	VirtualMachineSoftwarePatchProperties[]	Yükleme için kullanılabilir olarak algılanan düzeltme eklerinin listesi.
criticalAndSecurityPatchCount	integer (int32)	Kullanılabilir olarak algılanan ve henüz yüklenmemiş kritik veya güvenlik düzeltme eklerinin sayısı.
error	ApiError	İşlemin yürütülmesi sırasında karşılaşılan hatalar. Details dizisi bunların listesini içerir.
otherPatchCount	integer (int32)	Kritik ve güvenlik hariç tüm kullanılabilir düzeltme eklerinin sayısı.
rebootPending	boolean	VM'nin genel yeniden başlatma durumu. Kısmen yüklenen yamalar, yüklemeyi tamamlamak için yeniden başlatma gerektirdiğinde ancak yeniden başlatma henüz gerçekleşmediğinde doğru olacaktır.
startDateTime	string (date-time)	İşlemin başladığı UTC zaman damgası.
status	PatchOperationStatus	İşlemin genel başarı veya başarısızlık durumu. İşlem tamamlanana kadar "InProgress" olarak kalır. Bu noktada "Bilinmeyen", "Başarısız", "Başarılı" veya "CompletedWithWarnings" olur.

VirtualMachineSoftwarePatchProperties

Nesne

Sanal Makine yazılım düzeltme ekinin özelliklerini açıklar.

Name	Tür	Description
activityId	string	Bu sonucu üreten işlemin etkinlik kimliği. CRP ve uzantı günlükleri arasında ilişkilendirmek için kullanılır.
assessmentState	PatchAssessmentState	Belirli bir düzeltme ekinin kullanılabilirliğini açıklar.
classifications	string[]	Yama yayımcısı tarafından sağlanan yamanın sınıflandırmaları.
kbId	string	Düzeltme ekinin KBID'si. Yalnızca Windows yamaları için geçerlidir.
lastModifiedDateTime	string (date-time)	Bu yama kaydına yapılan son güncellemenin UTC zaman damgası.
name	string	Yamanın kolay adı.
patchId	string	Düzeltme eki için benzersiz bir tanımlayıcı.
publishedDate	string (date-time)	Deponun bu düzeltme ekini yayımladığı UTC zaman damgası.
rebootBehavior	VMGuestPatchRebootBehavior	Düzeltme ekinin yeniden başlatma gereksinimlerini açıklar.
version	string	Düzeltme ekinin sürüm numarası. Bu özellik yalnızca Linux yamaları için geçerlidir.

VMGuestPatchRebootBehavior

Numaralandırma

Düzeltme ekinin yeniden başlatma gereksinimlerini açıklar.

Değer	Description
Unknown
NeverReboots
AlwaysRequiresReboot
CanRequestReboot