Virtual Machines - Instance View

Hizmet:

Compute

API Sürümü:

2025-11-01

Bir sanal makinenin çalışma zamanı durumu hakkında bilgi alır.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/instanceView?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	VirtualMachineInstanceView	Azure işlemi başarıyla tamamlandı.
Other Status Codes	CloudError	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

Get instance view of a virtual machine placed on a dedicated host group through automatic placement.

Get Virtual Machine Instance View.

Get instance view of a virtual machine placed on a dedicated host group through automatic placement.

Örnek isteği

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/instanceView?api-version=2025-11-01

Java

/**
 * Samples for VirtualMachines InstanceView.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * 2025-11-01/virtualMachineExamples/VirtualMachine_Get_InstanceViewAutoPlacedOnDedicatedHostGroup.json
     */
    /**
     * Sample code: Get instance view of a virtual machine placed on a dedicated host group through automatic placement.
     * 
     * @param manager Entry point to ComputeManager.
     */
    public static void getInstanceViewOfAVirtualMachinePlacedOnADedicatedHostGroupThroughAutomaticPlacement(
        com.azure.resourcemanager.compute.ComputeManager manager) {
        manager.serviceClient().getVirtualMachines().instanceViewWithResponse("myResourceGroup", "myVM",
            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

Python

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_get_instance_view_auto_placed_on_dedicated_host_group.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.instance_view(
        resource_group_name="myResourceGroup",
        vm_name="myVM",
    )
    print(response)


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

Go

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_Get_InstanceViewAutoPlacedOnDedicatedHostGroup.json
func ExampleVirtualMachinesClient_InstanceView_getInstanceViewOfAVirtualMachinePlacedOnADedicatedHostGroupThroughAutomaticPlacement() {
	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)
	}
	res, err := clientFactory.NewVirtualMachinesClient().InstanceView(ctx, "myResourceGroup", "myVM", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %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.VirtualMachinesClientInstanceViewResponse{
	// 	VirtualMachineInstanceView: &armcompute.VirtualMachineInstanceView{
	// 		ComputerName: to.Ptr("myVM"),
	// 		OSName: to.Ptr("Windows Server 2016 Datacenter"),
	// 		OSVersion: to.Ptr("Microsoft Windows NT 10.0.14393.0"),
	// 		VMAgent: &armcompute.VirtualMachineAgentInstanceView{
	// 			VMAgentVersion: to.Ptr("2.7.41491.949"),
	// 			Statuses: []*armcompute.InstanceViewStatus{
	// 				{
	// 					Code: to.Ptr("ProvisioningState/succeeded"),
	// 					Level: to.Ptr(armcompute.StatusLevelTypesInfo),
	// 					DisplayStatus: to.Ptr("Ready"),
	// 					Message: to.Ptr("GuestAgent is running and accepting new configurations."),
	// 					Time: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2025-04-01T23:11:22+00:00"); return t}()),
	// 				},
	// 			},
	// 		},
	// 		Disks: []*armcompute.DiskInstanceView{
	// 			{
	// 				Name: to.Ptr("myOsDisk"),
	// 				Statuses: []*armcompute.InstanceViewStatus{
	// 					{
	// 						Code: to.Ptr("ProvisioningState/succeeded"),
	// 						Level: to.Ptr(armcompute.StatusLevelTypesInfo),
	// 						DisplayStatus: to.Ptr("Provisioning succeeded"),
	// 						Time: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2025-04-01T21:29:47.477089+00:00"); return t}()),
	// 					},
	// 				},
	// 			},
	// 		},
	// 		HyperVGeneration: to.Ptr(armcompute.HyperVGenerationTypeV1),
	// 		AssignedHost: to.Ptr("/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myHostGroup/hosts/myHost"),
	// 		Statuses: []*armcompute.InstanceViewStatus{
	// 			{
	// 				Code: to.Ptr("ProvisioningState/succeeded"),
	// 				Level: to.Ptr(armcompute.StatusLevelTypesInfo),
	// 				DisplayStatus: to.Ptr("Provisioning succeeded"),
	// 				Time: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2025-04-01T21:30:12.8051917+00:00"); return t}()),
	// 			},
	// 			{
	// 				Code: to.Ptr("PowerState/running"),
	// 				Level: to.Ptr(armcompute.StatusLevelTypesInfo),
	// 				DisplayStatus: to.Ptr("VM running"),
	// 			},
	// 		},
	// 	},
	// }
}

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

JavaScript

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

/**
 * This sample demonstrates how to retrieves information about the run-time state of a virtual machine.
 *
 * @summary retrieves information about the run-time state of a virtual machine.
 * x-ms-original-file: 2025-11-01/virtualMachineExamples/VirtualMachine_Get_InstanceViewAutoPlacedOnDedicatedHostGroup.json
 */
async function getInstanceViewOfAVirtualMachinePlacedOnADedicatedHostGroupThroughAutomaticPlacement() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "{subscription-id}";
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachines.instanceView("myResourceGroup", "myVM");
  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

dotnet

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_Get_InstanceViewAutoPlacedOnDedicatedHostGroup.json
// this example is just showing the usage of "VirtualMachines_InstanceView" 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 = "myResourceGroup";
string vmName = "myVM";
ResourceIdentifier virtualMachineResourceId = VirtualMachineResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, vmName);
VirtualMachineResource virtualMachine = client.GetVirtualMachineResource(virtualMachineResourceId);

// invoke the operation
VirtualMachineInstanceView result = await virtualMachine.InstanceViewAsync();

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

{
  "computerName": "myVM",
  "osName": "Windows Server 2016 Datacenter",
  "osVersion": "Microsoft Windows NT 10.0.14393.0",
  "vmAgent": {
    "vmAgentVersion": "2.7.41491.949",
    "statuses": [
      {
        "code": "ProvisioningState/succeeded",
        "level": "Info",
        "displayStatus": "Ready",
        "message": "GuestAgent is running and accepting new configurations.",
        "time": "2025-04-01T23:11:22+00:00"
      }
    ]
  },
  "disks": [
    {
      "name": "myOsDisk",
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "time": "2025-04-01T21:29:47.477089+00:00"
        }
      ]
    }
  ],
  "hyperVGeneration": "V1",
  "assignedHost": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myHostGroup/hosts/myHost",
  "statuses": [
    {
      "code": "ProvisioningState/succeeded",
      "level": "Info",
      "displayStatus": "Provisioning succeeded",
      "time": "2025-04-01T21:30:12.8051917+00:00"
    },
    {
      "code": "PowerState/running",
      "level": "Info",
      "displayStatus": "VM running"
    }
  ]
}

Get Virtual Machine Instance View.

Örnek isteği

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/instanceView?api-version=2025-11-01

Java

/**
 * Samples for VirtualMachines InstanceView.
 */
public final class Main {
    /*
     * x-ms-original-file: 2025-11-01/virtualMachineExamples/VirtualMachine_Get_InstanceView.json
     */
    /**
     * Sample code: Get Virtual Machine Instance View.
     * 
     * @param manager Entry point to ComputeManager.
     */
    public static void getVirtualMachineInstanceView(com.azure.resourcemanager.compute.ComputeManager manager) {
        manager.serviceClient().getVirtualMachines().instanceViewWithResponse("myResourceGroup", "myVM",
            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

Python

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_get_instance_view.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.instance_view(
        resource_group_name="myResourceGroup",
        vm_name="myVM",
    )
    print(response)


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

Go

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_Get_InstanceView.json
func ExampleVirtualMachinesClient_InstanceView_getVirtualMachineInstanceView() {
	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)
	}
	res, err := clientFactory.NewVirtualMachinesClient().InstanceView(ctx, "myResourceGroup", "myVM", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %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.VirtualMachinesClientInstanceViewResponse{
	// 	VirtualMachineInstanceView: &armcompute.VirtualMachineInstanceView{
	// 		PlatformUpdateDomain: to.Ptr[int32](1),
	// 		PlatformFaultDomain: to.Ptr[int32](1),
	// 		ComputerName: to.Ptr("myVM"),
	// 		OSName: to.Ptr("Windows Server 2016 Datacenter"),
	// 		OSVersion: to.Ptr("Microsoft Windows NT 10.0.14393.0"),
	// 		VMAgent: &armcompute.VirtualMachineAgentInstanceView{
	// 			VMAgentVersion: to.Ptr("2.7.41491.949"),
	// 			Statuses: []*armcompute.InstanceViewStatus{
	// 				{
	// 					Code: to.Ptr("ProvisioningState/succeeded"),
	// 					Level: to.Ptr(armcompute.StatusLevelTypesInfo),
	// 					DisplayStatus: to.Ptr("Ready"),
	// 					Message: to.Ptr("GuestAgent is running and accepting new configurations."),
	// 					Time: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2019-10-14T23:11:22+00:00"); return t}()),
	// 				},
	// 			},
	// 			ExtensionHandlers: []*armcompute.VirtualMachineExtensionHandlerInstanceView{
	// 				{
	// 					Type: to.Ptr("Microsoft.Azure.Security.IaaSAntimalware"),
	// 					TypeHandlerVersion: to.Ptr("1.5.5.9"),
	// 					Status: &armcompute.InstanceViewStatus{
	// 						Code: to.Ptr("ProvisioningState/succeeded"),
	// 						Level: to.Ptr(armcompute.StatusLevelTypesInfo),
	// 						DisplayStatus: to.Ptr("Ready"),
	// 					},
	// 				},
	// 			},
	// 		},
	// 		Disks: []*armcompute.DiskInstanceView{
	// 			{
	// 				Name: to.Ptr("myOsDisk"),
	// 				Statuses: []*armcompute.InstanceViewStatus{
	// 					{
	// 						Code: to.Ptr("ProvisioningState/succeeded"),
	// 						Level: to.Ptr(armcompute.StatusLevelTypesInfo),
	// 						DisplayStatus: to.Ptr("Provisioning succeeded"),
	// 						Time: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2019-10-14T21:29:47.477089+00:00"); return t}()),
	// 					},
	// 				},
	// 			},
	// 			{
	// 				Name: to.Ptr("myDataDisk0"),
	// 				Statuses: []*armcompute.InstanceViewStatus{
	// 					{
	// 						Code: to.Ptr("ProvisioningState/succeeded"),
	// 						Level: to.Ptr(armcompute.StatusLevelTypesInfo),
	// 						DisplayStatus: to.Ptr("Provisioning succeeded"),
	// 						Time: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2019-10-14T21:29:47.461517+00:00"); return t}()),
	// 					},
	// 				},
	// 			},
	// 		},
	// 		BootDiagnostics: &armcompute.BootDiagnosticsInstanceView{
	// 			ConsoleScreenshotBlobURI: to.Ptr("https://{myStorageAccount}.blob.core.windows.net/bootdiagnostics-myOsDisk/myOsDisk.screenshot.bmp"),
	// 			SerialConsoleLogBlobURI: to.Ptr("https://{myStorageAccount}.blob.core.windows.net/bootdiagnostics-myOsDisk/myOsDisk.serialconsole.log"),
	// 		},
	// 		Extensions: []*armcompute.VirtualMachineExtensionInstanceView{
	// 			{
	// 				Name: to.Ptr("IaaSAntiMalware-ext0"),
	// 				Type: to.Ptr("Microsoft.Azure.Security.IaaSAntimalware"),
	// 				TypeHandlerVersion: to.Ptr("1.5.5.9"),
	// 				Statuses: []*armcompute.InstanceViewStatus{
	// 					{
	// 						Code: to.Ptr("ProvisioningState/succeeded"),
	// 						Level: to.Ptr(armcompute.StatusLevelTypesInfo),
	// 						DisplayStatus: to.Ptr("Provisioning succeeded"),
	// 						Message: to.Ptr("Microsoft Antimalware enabled"),
	// 					},
	// 				},
	// 			},
	// 		},
	// 		HyperVGeneration: to.Ptr(armcompute.HyperVGenerationTypeV1),
	// 		PatchStatus: &armcompute.VirtualMachinePatchStatus{
	// 			AvailablePatchSummary: &armcompute.AvailablePatchSummary{
	// 				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),
	// 				StartTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-04-24T21:02:04.2556154Z"); return t}()),
	// 				LastModifiedTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-04-24T21:02:04.2556154Z"); return t}()),
	// 			},
	// 			LastPatchInstallationSummary: &armcompute.LastPatchInstallationSummary{
	// 				Status: to.Ptr(armcompute.PatchOperationStatusSucceeded),
	// 				InstallationActivityID: to.Ptr("68f8b292-dfc2-4646-9981-33cc88631968"),
	// 				MaintenanceWindowExceeded: to.Ptr(false),
	// 				NotSelectedPatchCount: to.Ptr[int32](1),
	// 				ExcludedPatchCount: to.Ptr[int32](1),
	// 				PendingPatchCount: to.Ptr[int32](1),
	// 				InstalledPatchCount: to.Ptr[int32](1),
	// 				FailedPatchCount: to.Ptr[int32](1),
	// 				StartTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-04-24T21:02:04.2556154Z"); return t}()),
	// 				LastModifiedTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-04-24T21:02:04.2556154Z"); return t}()),
	// 			},
	// 			ConfigurationStatuses: []*armcompute.InstanceViewStatus{
	// 				{
	// 					Code: to.Ptr("PatchModeConfigurationState/Ready"),
	// 					Level: to.Ptr(armcompute.StatusLevelTypesInfo),
	// 					DisplayStatus: to.Ptr("Status_PatchModeConfigurationState_Ready"),
	// 					Time: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-04-24T21:02:04.2556154Z"); return t}()),
	// 				},
	// 				{
	// 					Code: to.Ptr("AssessmentModeConfigurationState/Pending"),
	// 					Level: to.Ptr(armcompute.StatusLevelTypesInfo),
	// 					DisplayStatus: to.Ptr("Status_AssessmentModeConfigurationState_Pending"),
	// 					Time: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2020-04-24T21:02:04.2556154Z"); return t}()),
	// 				},
	// 			},
	// 		},
	// 		IsVMInStandbyPool: to.Ptr(false),
	// 		Statuses: []*armcompute.InstanceViewStatus{
	// 			{
	// 				Code: to.Ptr("ProvisioningState/succeeded"),
	// 				Level: to.Ptr(armcompute.StatusLevelTypesInfo),
	// 				DisplayStatus: to.Ptr("Provisioning succeeded"),
	// 				Time: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2019-10-14T21:30:12.8051917+00:00"); return t}()),
	// 			},
	// 			{
	// 				Code: to.Ptr("PowerState/running"),
	// 				Level: to.Ptr(armcompute.StatusLevelTypesInfo),
	// 				DisplayStatus: to.Ptr("VM running"),
	// 			},
	// 		},
	// 	},
	// }
}

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

JavaScript

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

/**
 * This sample demonstrates how to retrieves information about the run-time state of a virtual machine.
 *
 * @summary retrieves information about the run-time state of a virtual machine.
 * x-ms-original-file: 2025-11-01/virtualMachineExamples/VirtualMachine_Get_InstanceView.json
 */
async function getVirtualMachineInstanceView() {
  const credential = new DefaultAzureCredential();
  const subscriptionId = "{subscription-id}";
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.virtualMachines.instanceView("myResourceGroup", "myVM");
  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

dotnet

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_Get_InstanceView.json
// this example is just showing the usage of "VirtualMachines_InstanceView" 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 = "myResourceGroup";
string vmName = "myVM";
ResourceIdentifier virtualMachineResourceId = VirtualMachineResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, vmName);
VirtualMachineResource virtualMachine = client.GetVirtualMachineResource(virtualMachineResourceId);

// invoke the operation
VirtualMachineInstanceView result = await virtualMachine.InstanceViewAsync();

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

{
  "platformUpdateDomain": 1,
  "platformFaultDomain": 1,
  "computerName": "myVM",
  "osName": "Windows Server 2016 Datacenter",
  "osVersion": "Microsoft Windows NT 10.0.14393.0",
  "vmAgent": {
    "vmAgentVersion": "2.7.41491.949",
    "statuses": [
      {
        "code": "ProvisioningState/succeeded",
        "level": "Info",
        "displayStatus": "Ready",
        "message": "GuestAgent is running and accepting new configurations.",
        "time": "2019-10-14T23:11:22+00:00"
      }
    ],
    "extensionHandlers": [
      {
        "type": "Microsoft.Azure.Security.IaaSAntimalware",
        "typeHandlerVersion": "1.5.5.9",
        "status": {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Ready"
        }
      }
    ]
  },
  "disks": [
    {
      "name": "myOsDisk",
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "time": "2019-10-14T21:29:47.477089+00:00"
        }
      ]
    },
    {
      "name": "myDataDisk0",
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "time": "2019-10-14T21:29:47.461517+00:00"
        }
      ]
    }
  ],
  "bootDiagnostics": {
    "consoleScreenshotBlobUri": "https://{myStorageAccount}.blob.core.windows.net/bootdiagnostics-myOsDisk/myOsDisk.screenshot.bmp",
    "serialConsoleLogBlobUri": "https://{myStorageAccount}.blob.core.windows.net/bootdiagnostics-myOsDisk/myOsDisk.serialconsole.log"
  },
  "extensions": [
    {
      "name": "IaaSAntiMalware-ext0",
      "type": "Microsoft.Azure.Security.IaaSAntimalware",
      "typeHandlerVersion": "1.5.5.9",
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "message": "Microsoft Antimalware enabled"
        }
      ]
    }
  ],
  "hyperVGeneration": "V1",
  "patchStatus": {
    "availablePatchSummary": {
      "status": "Succeeded",
      "assessmentActivityId": "68f8b292-dfc2-4646-9781-33cc88631968",
      "rebootPending": true,
      "criticalAndSecurityPatchCount": 1,
      "otherPatchCount": 2,
      "startTime": "2020-04-24T21:02:04.2556154Z",
      "lastModifiedTime": "2020-04-24T21:02:04.2556154Z",
      "error": null
    },
    "lastPatchInstallationSummary": {
      "status": "Succeeded",
      "installationActivityId": "68f8b292-dfc2-4646-9981-33cc88631968",
      "maintenanceWindowExceeded": false,
      "notSelectedPatchCount": 1,
      "excludedPatchCount": 1,
      "pendingPatchCount": 1,
      "installedPatchCount": 1,
      "failedPatchCount": 1,
      "startTime": "2020-04-24T21:02:04.2556154Z",
      "lastModifiedTime": "2020-04-24T21:02:04.2556154Z",
      "error": null
    },
    "configurationStatuses": [
      {
        "code": "PatchModeConfigurationState/Ready",
        "level": "Info",
        "displayStatus": "Status_PatchModeConfigurationState_Ready",
        "time": "2020-04-24T21:02:04.2556154Z"
      },
      {
        "code": "AssessmentModeConfigurationState/Pending",
        "level": "Info",
        "displayStatus": "Status_AssessmentModeConfigurationState_Pending",
        "time": "2020-04-24T21:02:04.2556154Z"
      }
    ]
  },
  "isVMInStandbyPool": false,
  "statuses": [
    {
      "code": "ProvisioningState/succeeded",
      "level": "Info",
      "displayStatus": "Provisioning succeeded",
      "time": "2019-10-14T21:30:12.8051917+00:00"
    },
    {
      "code": "PowerState/running",
      "level": "Info",
      "displayStatus": "VM running"
    }
  ]
}

Tanımlar

Name	Description
ApiError	API hatası.
ApiErrorBase	Api hata tabanı.
AvailablePatchSummary	Kullanılabilir düzeltme eki özeti için bir sanal makine örneği görünümünün özelliklerini açıklar.
BootDiagnosticsInstanceView	Sanal makine önyükleme tanılamasının örnek görünümü.
CloudError	İşlem hizmetinden bir hata yanıtı.
DiskEncryptionSettings	Bir disk için şifreleme ayarlarını açıklar
DiskInstanceView	Diskin örnek görünümü.
HyperVGenerationType	Bir kaynakla ilişkili HyperVGeneration Türünü belirtir
InnerError	İç hata ayrıntıları.
InstanceViewStatus	Örnek görünümü durumu.
KeyVaultKeyReference	Key Vault Key'e bir referans tanımlar
KeyVaultSecretReference	Key Vault Secret'a bir göndermeyi tanımlar
LastPatchInstallationSummary	Son yüklenen düzeltme eki özetinin özelliklerini açıklar.
MaintenanceOperationResultCodeTypes	Son Bakım İşlemi Sonuç Kodu.
MaintenanceRedeployStatus	Bakım Çalışma Durumu.
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.
StatusLevelTypes	Düzey kodu.
StorageAlignmentStatus	Disk için depolama hizalama durumunu belirtir.
SubResource
VirtualMachineAgentInstanceView	Sanal makinede çalışan VM Aracısı'nın örnek görünümü.
VirtualMachineExtensionHandlerInstanceView	Bir sanal makine uzantısı işleyicisinin örnek görünümü.
VirtualMachineExtensionInstanceView	Sanal makine uzantısının örnek görünümü.
VirtualMachineHealthStatus	VM'nin sistem durumu.
VirtualMachineInstanceView	Bir sanal makinenin örnek görünümü.
VirtualMachinePatchStatus	Sanal makine düzeltme eki işlemlerinin durumu.

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.

AvailablePatchSummary

Nesne

Kullanılabilir düzeltme eki özeti için bir sanal makine örneği görünümünün ö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.
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.
lastModifiedTime	string (date-time)	İşlemin başladığı UTC zaman damgası.
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.
startTime	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.

BootDiagnosticsInstanceView

Nesne

Sanal makine önyükleme tanılamasının örnek görünümü.

Name	Tür	Description
consoleScreenshotBlobUri	string	Konsol ekran görüntüsü blobu URI'si. Not: Önyükleme tanılaması, yönetilen depolama alanında şu anda etkinse bu ayar yapılmaz .
serialConsoleLogBlobUri	string	Seri konsol günlük blobu Uri'si. Not: Önyükleme tanılaması, yönetilen depolama alanında şu anda etkinse bu ayar yapılmaz .
status	InstanceViewStatus	VM için önyükleme tanılama durumu bilgileri. Not: Yalnızca önyükleme tanılamasının etkinleştirilmesinde karşılaşılan hatalar varsa ayarlanacaktır.

CloudError

Nesne

İşlem hizmetinden bir hata yanıtı.

Name	Tür	Description
error	ApiError	API hatası.

DiskEncryptionSettings

Nesne

Bir disk için şifreleme ayarlarını açıklar

Name	Tür	Description
diskEncryptionKey	KeyVaultSecretReference	Disk şifreleme anahtarının konumunu belirtir; bu bir Key Vault Secret'tir.
enabled	boolean	Sanal makinede disk şifrelemesinin etkinleştirilip etkinleştirilmeymeyeceğini belirtir.
keyEncryptionKey	KeyVaultKeyReference	Key Vault'taki anahtar şifreleme anahtarının konumunu belirtir.

DiskInstanceView

Nesne

Diskin örnek görünümü.

Name	Tür	Description
encryptionSettings	DiskEncryptionSettings[]	İşletim sistemi diskinin şifreleme ayarlarını belirtir. En düşük api sürümü: 2015-06-15
name	string	Disk adı.
statuses	InstanceViewStatus[]	Kaynak durumu bilgileri.
storageAlignmentStatus	StorageAlignmentStatus	Disk için depolama hizalama durumunu belirtir.

HyperVGenerationType

Numaralandırma

Bir kaynakla ilişkili HyperVGeneration Türünü belirtir

Değer	Description
V1
V2

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ü.

InstanceViewStatus

Nesne

Örnek görünümü durumu.

Name	Tür	Description
code	string	Durum kodu.
displayStatus	string	Durum için kısa yerelleştirilebilir etiket.
level	StatusLevelTypes	Düzey kodu.
message	string	Uyarılar ve hata iletileri dahil olmak üzere ayrıntılı durum iletisi.
time	string (date-time)	Durum zamanı.

KeyVaultKeyReference

Nesne

Key Vault Key'e bir referans tanımlar

Name	Tür	Description
keyUrl	string	URL, Key Vault'taki bir anahtar şifreleme anahtarına atıfta bulunur.
sourceVault	SubResource	Anahtarı içeren Key Vault'un göreli URL'si.

KeyVaultSecretReference

Nesne

Key Vault Secret'a bir göndermeyi tanımlar

Name	Tür	Description
secretUrl	string	URL, Key Vault'taki bir sırra atıfta bulunuyor.
sourceVault	SubResource	Sırrı içeren Key Vault'un göreli URL'si.

LastPatchInstallationSummary

Nesne

Son yüklenen düzeltme eki özetinin özelliklerini açıklar.

Name	Tür	Description
error	ApiError	İşlemin yürütülmesi sırasında karşılaşılan hatalar. Details dizisi bunların listesini içerir.
excludedPatchCount	integer (int32)	Kullanılabilir tüm düzeltme eklerinin sayısı, ancak müşteri tarafından belirtilen bir dışlama listesi eşleşmesi tarafından açıkça dışlanır.
failedPatchCount	integer (int32)	Yükleme başarısız olan düzeltme eklerinin sayısı.
installationActivityId	string	Bu sonucu üreten işlemin etkinlik kimliği. CRP ve uzantı günlükleri arasında ilişkilendirmek için kullanılır.
installedPatchCount	integer (int32)	Başarıyla yüklenen yamaların sayısı.
lastModifiedTime	string (date-time)	İşlemin başladığı UTC zaman damgası.
maintenanceWindowExceeded	boolean	İşlemin amaçlanan tüm eylemlerini tamamlamadan önce süresinin dolup dolmadığını açıklar
notSelectedPatchCount	integer (int32)	Kullanılabilir tüm yamaların sayısı, ancak bir sınıflandırma veya ekleme listesi girişiyle eşleşmediği için yüklenmeyecek.
pendingPatchCount	integer (int32)	Düzeltme eki yükleme işlemi sırasında yüklenmesi beklenen tüm kullanılabilir düzeltme eklerinin sayısı.
startTime	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.

MaintenanceOperationResultCodeTypes

Numaralandırma

Son Bakım İşlemi Sonuç Kodu.

Değer	Description
None
RetryLater
MaintenanceAborted
MaintenanceCompleted

MaintenanceRedeployStatus

Nesne

Bakım Çalışma Durumu.

Name	Tür	Description
isCustomerInitiatedMaintenanceAllowed	boolean	Doğru, müşterinin Bakım yapmasına izin verilirse.
lastOperationMessage	string	Son Bakım İşlemi için mesaj döndürüldü.
lastOperationResultCode	MaintenanceOperationResultCodeTypes	Son Bakım İşlemi Sonuç Kodu.
maintenanceWindowEndTime	string (date-time)	Bakım penceresi için bitiş zamanı.
maintenanceWindowStartTime	string (date-time)	Bakım penceresi için başlangıç zamanı.
preMaintenanceWindowEndTime	string (date-time)	Bakım öncesi pencerenin bitiş zamanı.
preMaintenanceWindowStartTime	string (date-time)	Bakım öncesi pencerenin başlangıç zamanı.

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

StatusLevelTypes

Numaralandırma

Düzey kodu.

Değer	Description
Info
Warning
Error

StorageAlignmentStatus

Numaralandırma

Disk için depolama hizalama durumunu belirtir.

Değer	Description
Unaligned	Disk, Hata Alanı eşlemesini hesaplamak için Depolama Hata Alanı (Storage Fault Domain) özelliğine sahip değildir. Tek bir Depolama Hatası Alanı hatası hatası, bu disk profiline referans veren tüm VM'leri etkileyebilir.
Aligned	Disk, Hata Alanı eşlemesini hesaplamak için Depolama Hata Alanı (Storage Fault Domain) içerir. Depolama Hatası Alanı arızası, tek bir Hesaplama Hata Alanı içindeki VM'lere mahsustur.

SubResource

Nesne

Name	Tür	Description
id	string	Kaynak Kimliği

VirtualMachineAgentInstanceView

Nesne

Sanal makinede çalışan VM Aracısı'nın örnek görünümü.

Name	Tür	Description
extensionHandlers	VirtualMachineExtensionHandlerInstanceView[]	Sanal makine uzantısı işleyicisi örneği görünümü.
statuses	InstanceViewStatus[]	Kaynak durumu bilgileri.
vmAgentVersion	string	VM Aracısı tam sürümü.

VirtualMachineExtensionHandlerInstanceView

Nesne

Bir sanal makine uzantısı işleyicisinin örnek görünümü.

Name	Tür	Description
status	InstanceViewStatus	Uzantı işleyicisi durumu.
type	string	Uzantının türünü belirtir; "CustomScriptExtension" örnektir.
typeHandlerVersion	string	Betik işleyicisinin sürümünü belirtir.

VirtualMachineExtensionInstanceView

Nesne

Sanal makine uzantısının örnek görünümü.

Name	Tür	Description
name	string	Sanal makine uzantısı adı.
statuses	InstanceViewStatus[]	Kaynak durumu bilgileri.
substatuses	InstanceViewStatus[]	Kaynak durumu bilgileri.
type	string	Uzantının türünü belirtir; "CustomScriptExtension" örnektir.
typeHandlerVersion	string	Betik işleyicisinin sürümünü belirtir.

VirtualMachineHealthStatus

Nesne

VM'nin sistem durumu.

Name	Tür	Description
status	InstanceViewStatus	VM'nin sistem durumu bilgileri.

VirtualMachineInstanceView

Nesne

Bir sanal makinenin örnek görünümü.

Name	Tür	Description
assignedHost	string	Sanal makine otomatik yerleştirme etkinleştirilmiş bir ayrılmış konak grubuyla ilişkilendirildiğinde, sanal makinenin otomatik yerleştirme yoluyla ayrıldığı ayrılmış konağın kaynak kimliği. En düşük api sürümü: 2020-06-01.
bootDiagnostics	BootDiagnosticsInstanceView	Önyükleme Tanılama, VM durumunu tanılamak için Konsol Çıkışını ve Ekran Görüntüsünü görüntülemenizi sağlayan bir hata ayıklama özelliğidir. Konsol günlüğünüzün çıkışını kolayca görüntüleyebilirsiniz. Azure ayrıca hipervizörden VM'nin ekran görüntüsünü görmenize olanak tanır.
computerName	string	Sanal makineye atanan bilgisayar adı.
disks	DiskInstanceView[]	Sanal makine disk bilgileri.
extensions	VirtualMachineExtensionInstanceView[]	Uzantı bilgileri.
hyperVGeneration	HyperVGenerationType	Bir kaynakla ilişkili HyperVGeneration Türünü belirtir
isVMInStandbyPool	boolean	[Önizleme Özelliği] VM'nin şu anda Bekleme Havuzunun içinde mi yoksa dışında mı olduğunu belirtir.
maintenanceRedeployStatus	MaintenanceRedeployStatus	Sanal makinedeki Bakım İşlemi durumu.
osName	string	Sanal makinede çalışan İşletim Sistemi.
osVersion	string	Sanal makinede çalışan İşletim Sistemi sürümü.
patchStatus	VirtualMachinePatchStatus	[Önizleme Özelliği] Sanal makine düzeltme eki işlemlerinin durumu.
platformFaultDomain	integer (int32)	Sanal makinenin hata etki alanını belirtir.
platformUpdateDomain	integer (int32)	Sanal makinenin güncelleştirme etki alanını belirtir.
rdpThumbPrint	string	Uzak masaüstü sertifikası parmak izi.
statuses	InstanceViewStatus[]	Kaynak durumu bilgileri.
vmAgent	VirtualMachineAgentInstanceView	Sanal makinede çalışan VM Aracısı.
vmHealth	VirtualMachineHealthStatus	VM'nin sistem durumu.

VirtualMachinePatchStatus

Nesne

Sanal makine düzeltme eki işlemlerinin durumu.

Name	Tür	Description
availablePatchSummary	AvailablePatchSummary	Sanal makine için en son değerlendirme işleminin kullanılabilir düzeltme eki özeti.
configurationStatuses	InstanceViewStatus[]	Belirtilen patchMode'un etkinleştirme durumu
lastPatchInstallationSummary	LastPatchInstallationSummary	Sanal makine için en son yükleme işleminin yükleme özeti.