Virtual Machines - Instance View

Service:: Compute

API バージョン:: 2026-04-01

仮想マシンの実行時の状態に関する情報を取得します。

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/instanceView?api-version=2026-04-01

URI パラメーター

Name	/	必須	型	説明
resourceGroupName	path	True	string minLength: 1 maxLength: 90	リソースグループの名前。名前は大文字と小文字を区別しません。
subscriptionId	path	True	string minLength: 1	ターゲットサブスクリプションの ID。
vmName	path	True	string	仮想マシンの名前。
api-version	query	True	string minLength: 1	この操作に使用する API バージョン。

応答

Name	型	説明
200 OK	VirtualMachineInstanceView	Azureの運用は無事に完了しました。
Other Status Codes	CloudError	予期しないエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー。

型: oauth2
フロー: implicit
Authorization URL (承認 URL): https://login.microsoftonline.com/common/oauth2/authorize

スコープ

Name	説明
user_impersonation	あなたのユーザーアカウントになりすます

例

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.

要求のサンプル

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


/**
 * Samples for VirtualMachines InstanceView.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * 2026-04-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

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: 2026-04-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

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/v9"
)

// Generated from example definition: 2026-04-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(time.Date(2026, time.April, 1, 23, 11, 22, 0, time.UTC)),
	// 				},
	// 			},
	// 		},
	// 		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(time.Date(2026, time.April, 1, 21, 29, 47, 477089000, time.UTC)),
	// 					},
	// 				},
	// 			},
	// 		},
	// 		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(time.Date(2026, time.April, 1, 21, 30, 12, 805191700, time.UTC)),
	// 			},
	// 			{
	// 				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

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: 2026-04-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

応答のサンプル

状態コード:: 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": "2026-04-01T23:11:22+00:00"
      }
    ]
  },
  "disks": [
    {
      "name": "myOsDisk",
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "time": "2026-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": "2026-04-01T21:30:12.8051917+00:00"
    },
    {
      "code": "PowerState/running",
      "level": "Info",
      "displayStatus": "VM running"
    }
  ]
}

Get Virtual Machine Instance View.

要求のサンプル

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


/**
 * Samples for VirtualMachines InstanceView.
 */
public final class Main {
    /*
     * x-ms-original-file: 2026-04-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

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: 2026-04-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

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/v9"
)

// Generated from example definition: 2026-04-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(time.Date(2019, time.October, 14, 23, 11, 22, 0, time.UTC)),
	// 				},
	// 			},
	// 			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(time.Date(2019, time.October, 14, 21, 29, 47, 477089000, time.UTC)),
	// 					},
	// 				},
	// 			},
	// 			{
	// 				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(time.Date(2019, time.October, 14, 21, 29, 47, 461517000, time.UTC)),
	// 					},
	// 				},
	// 			},
	// 		},
	// 		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(time.Date(2020, time.April, 24, 21, 2, 4, 255615400, time.UTC)),
	// 				LastModifiedTime: to.Ptr(time.Date(2020, time.April, 24, 21, 2, 4, 255615400, time.UTC)),
	// 			},
	// 			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(time.Date(2020, time.April, 24, 21, 2, 4, 255615400, time.UTC)),
	// 				LastModifiedTime: to.Ptr(time.Date(2020, time.April, 24, 21, 2, 4, 255615400, time.UTC)),
	// 			},
	// 			ConfigurationStatuses: []*armcompute.InstanceViewStatus{
	// 				{
	// 					Code: to.Ptr("PatchModeConfigurationState/Ready"),
	// 					Level: to.Ptr(armcompute.StatusLevelTypesInfo),
	// 					DisplayStatus: to.Ptr("Status_PatchModeConfigurationState_Ready"),
	// 					Time: to.Ptr(time.Date(2020, time.April, 24, 21, 2, 4, 255615400, time.UTC)),
	// 				},
	// 				{
	// 					Code: to.Ptr("AssessmentModeConfigurationState/Pending"),
	// 					Level: to.Ptr(armcompute.StatusLevelTypesInfo),
	// 					DisplayStatus: to.Ptr("Status_AssessmentModeConfigurationState_Pending"),
	// 					Time: to.Ptr(time.Date(2020, time.April, 24, 21, 2, 4, 255615400, time.UTC)),
	// 				},
	// 			},
	// 		},
	// 		IsVMInStandbyPool: to.Ptr(false),
	// 		CapacityReservationType: to.Ptr(armcompute.CapacityReservationTypeOpen),
	// 		Statuses: []*armcompute.InstanceViewStatus{
	// 			{
	// 				Code: to.Ptr("ProvisioningState/succeeded"),
	// 				Level: to.Ptr(armcompute.StatusLevelTypesInfo),
	// 				DisplayStatus: to.Ptr("Provisioning succeeded"),
	// 				Time: to.Ptr(time.Date(2019, time.October, 14, 21, 30, 12, 805191700, time.UTC)),
	// 			},
	// 			{
	// 				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

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: 2026-04-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

応答のサンプル

状態コード:: 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,
  "capacityReservationType": "Open",
  "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"
    }
  ]
}

定義

Name	説明
ApiError	API エラー。
ApiErrorBase	API エラーベース。
AvailablePatchSummary	使用可能なパッチの概要の仮想マシンインスタンスビューのプロパティについて説明します。
BootDiagnosticsInstanceView	仮想マシンのブート診断のインスタンスビュー。
CapacityReservationType	仮想マシンが適格であればどの種類の容量予約から容量を使用するか、またはサブスクリプション内の予約容量から明示的にオプトアウトされるかを指定します。最低APIバージョン:2026-04-01。
CloudError	コンピューティングサービスからのエラー応答。
DiskEncryptionSettings	ディスクの暗号化設定について説明します
DiskInstanceView	ディスクのインスタンスビュー。
HyperVGenerationType	リソースに関連付けられている HyperVGeneration の種類を指定します。
InnerError	内部エラーの詳細。
InstanceViewStatus	インスタンスビューの状態。
InterconnectInstanceView	Interconnect Blockインスタンスは仮想マシンまたはScale Set VMインスタンスの詳細を閲覧できます。
KeyVaultKeyReference	Key Vault キーへの参照について説明します
KeyVaultSecretReference	Key Vault シークレットへの参照について説明します
LastPatchInstallationSummary	最後にインストールされたパッチの概要のプロパティについて説明します。
MaintenanceOperationResultCodeTypes	最後のメンテナンス操作の結果コード。
MaintenanceRedeployStatus	メンテナンス操作の状態。
PatchOperationStatus	操作の全体的な成功または失敗の状態。操作が完了するまで「InProgress」のままです。その時点で、"Unknown"、"Failed"、"Succeeded"、または "CompletedWithWarnings" になります。
StatusLevelTypes	レベルコード。
StorageAlignmentStatus	ディスクのストレージアライメント状態を指定します。
SubResource
VirtualMachineAgentInstanceView	仮想マシンで実行されている VM エージェントのインスタンスビュー。
VirtualMachineExtensionHandlerInstanceView	仮想マシン拡張機能ハンドラーのインスタンスビュー。
VirtualMachineExtensionInstanceView	仮想マシン拡張機能のインスタンスビュー。
VirtualMachineHealthStatus	VM の正常性状態。
VirtualMachineInstanceView	仮想マシンのインスタンスビュー。
VirtualMachinePatchStatus	仮想マシンのパッチ操作の状態。

ApiError

Object

API エラー。

Name	型	説明
code	string	エラーコード。
details	ApiErrorBase[]	Api エラーの詳細
innererror	InnerError	Api 内部エラー
message	string	エラーメッセージ。
target	string	特定のエラーのターゲット。

ApiErrorBase

Object

API エラーベース。

Name	型	説明
code	string	エラーコード。
message	string	エラーメッセージ。
target	string	特定のエラーのターゲット。

AvailablePatchSummary

Object

使用可能なパッチの概要の仮想マシンインスタンスビューのプロパティについて説明します。

Name	型	説明
assessmentActivityId	string	この結果を生成した操作のアクティビティ ID。これは、CRP と拡張機能のログ間で相互に関連付けるために使用されます。
criticalAndSecurityPatchCount	integer (int32)	使用可能として検出され、まだインストールされていないクリティカルパッチまたはセキュリティパッチの数。
error	ApiError	操作の実行中に発生したエラー。 details 配列には、それらのリストが含まれています。
lastModifiedTime	string (date-time)	操作が開始されたときの UTC タイムスタンプ。
otherPatchCount	integer (int32)	クリティカルおよびセキュリティを除く使用可能なすべてのパッチの数。
rebootPending	boolean	VM の全体的な再起動状態。これは、部分的にインストールされたパッチがインストールを完了するために再起動する必要があるが、再起動がまだ行われていない場合に当てはまります。
startTime	string (date-time)	操作が開始されたときの UTC タイムスタンプ。
status	PatchOperationStatus	操作の全体的な成功または失敗の状態。操作が完了するまで「InProgress」のままです。その時点で、"Unknown"、"Failed"、"Succeeded"、または "CompletedWithWarnings" になります。

BootDiagnosticsInstanceView

Object

仮想マシンのブート診断のインスタンスビュー。

Name	型	説明
consoleScreenshotBlobUri	string	コンソールのスクリーンショット BLOB URI。注: ブート診断がマネージドストレージで現在有効になっている場合、これは設定。
serialConsoleLogBlobUri	string	シリアルコンソールログ BLOB URI。注: ブート診断がマネージドストレージで現在有効になっている場合、これは設定。
status	InstanceViewStatus	VM のブート診断の状態情報。注: ブート診断の有効化でエラーが発生した場合にのみ設定されます。

CapacityReservationType

列挙

仮想マシンが適格であればどの種類の容量予約から容量を使用するか、またはサブスクリプション内の予約容量から明示的にオプトアウトされるかを指定します。最低APIバージョン:2026-04-01。

値	説明
NotEligible	仮想マシンはオープン容量予約に暗黙的に関連付ける資格がなく、いかなる容量予約グループにも明示的に紐付けられていないため、公開容量から容量を消費します。
Targeted	仮想マシンは、ターゲットとなるキャパシティ予約グループリソースに関連付けられている場合、特定のマッチング容量予約容量から容量を消費しますが、対象予約に利用可能な容量がない場合は、公開可能な容量から容量を消費する形にフォールバックできます。
Open	対象となる仮想マシンは、サブスクリプションで作成または共有された対応可能な空き容量の予約容量を暗に関連付け、消費します。注: VMは、マッチング予約を含むオープンキャパシティ予約グループリソースと明示的に関連付けてはいけません。
Disabled	仮想マシンは容量予約割り当てが無効化されており、いかなる種類の容量予約にも暗黙的または明示的に関連付けることは許されません。
Block	仮想マシンは、タイプブロックのキャパシティ予約グループリソースに関連付けられた特定のマッチング容量予約容量から容量を消費し、ブロック予約に利用可能な容量がなければ容量障害に遭います。

CloudError

Object

コンピューティングサービスからのエラー応答。

Name	型	説明
error	ApiError	API エラー。

DiskEncryptionSettings

Object

ディスクの暗号化設定について説明します

Name	型	説明
diskEncryptionKey	KeyVaultSecretReference	ディスク暗号化キー (Key Vault シークレット) の場所を指定します。
enabled	boolean	仮想マシンでディスク暗号化を有効にするかどうかを指定します。
keyEncryptionKey	KeyVaultKeyReference	Key Vault 内のキー暗号化キーの場所を指定します。

DiskInstanceView

Object

ディスクのインスタンスビュー。

Name	型	説明
encryptionSettings	DiskEncryptionSettings[]	OS ディスクの暗号化設定を指定します。最小 API バージョン: 2015-06-15
name	string	ディスク名。
statuses	InstanceViewStatus[]	リソースの状態情報。
storageAlignmentStatus	StorageAlignmentStatus	ディスクのストレージアライメント状態を指定します。

HyperVGenerationType

列挙

リソースに関連付けられている HyperVGeneration の種類を指定します。

値	説明
V1
V2

InnerError

Object

内部エラーの詳細。

Name	型	説明
errordetail	string	内部エラーメッセージまたは例外ダンプ。
exceptiontype	string	例外の種類。

InstanceViewStatus

Object

インスタンスビューの状態。

Name	型	説明
code	string	状態コード。
displayStatus	string	状態の短いローカライズ可能なラベル。
level	StatusLevelTypes	レベルコード。
message	string	アラートやエラーメッセージを含む詳細なステータスメッセージ。
time	string (date-time)	状態の時刻。

InterconnectInstanceView

Object

Interconnect Blockインスタンスは仮想マシンまたはScale Set VMインスタンスの詳細を閲覧できます。

Name	型	説明
interconnectSubgroupId	string	仮想マシンが配置されたインターコネクトサブグループのID(GUID)。

KeyVaultKeyReference

Object

Key Vault キーへの参照について説明します

Name	型	説明
keyUrl	string	Key Vault のキー暗号化キーを参照する URL。
sourceVault	SubResource	キーを含む Key Vault の相対 URL。

KeyVaultSecretReference

Object

Key Vault シークレットへの参照について説明します

Name	型	説明
secretUrl	string	Key Vault 内のシークレットを参照する URL。
sourceVault	SubResource	シークレットを含む Key Vault の相対 URL。

LastPatchInstallationSummary

Object

最後にインストールされたパッチの概要のプロパティについて説明します。

Name	型	説明
error	ApiError	操作の実行中に発生したエラー。 details 配列には、それらのリストが含まれています。
excludedPatchCount	integer (int32)	お客様が指定した除外リストによって明示的に除外されたすべての利用可能なパッチの数が一致します。
failedPatchCount	integer (int32)	インストールに失敗した修正プログラムの数。
installationActivityId	string	この結果を生成した操作のアクティビティ ID。これは、CRP と拡張機能のログ間で相互に関連付けるために使用されます。
installedPatchCount	integer (int32)	正常にインストールされたパッチの数。
lastModifiedTime	string (date-time)	操作が開始されたときの UTC タイムスタンプ。
maintenanceWindowExceeded	boolean	操作が目的のすべてのアクションを完了する前に時間がなくなったかどうかを説明します
notSelectedPatchCount	integer (int32)	使用可能なすべてのパッチの数。分類または包含リストのエントリと一致しなかったため、インストールされません。
pendingPatchCount	integer (int32)	修正プログラムのインストール操作の過程で、使用可能なすべてのパッチの数がインストールされる予定です。
startTime	string (date-time)	操作が開始されたときの UTC タイムスタンプ。
status	PatchOperationStatus	操作の全体的な成功または失敗の状態。操作が完了するまで「InProgress」のままです。その時点で、"Unknown"、"Failed"、"Succeeded"、または "CompletedWithWarnings" になります。

MaintenanceOperationResultCodeTypes

列挙

最後のメンテナンス操作の結果コード。

値	説明
None
RetryLater
MaintenanceAborted
MaintenanceCompleted

MaintenanceRedeployStatus

Object

メンテナンス操作の状態。

Name	型	説明
isCustomerInitiatedMaintenanceAllowed	boolean	True の場合は、お客様がメンテナンスを実行できます。
lastOperationMessage	string	最後のメンテナンス操作に関して返されたメッセージ。
lastOperationResultCode	MaintenanceOperationResultCodeTypes	最後のメンテナンス操作の結果コード。
maintenanceWindowEndTime	string (date-time)	メンテナンス期間の終了時刻。
maintenanceWindowStartTime	string (date-time)	メンテナンス期間の開始時刻。
preMaintenanceWindowEndTime	string (date-time)	メンテナンス前期間の終了時刻。
preMaintenanceWindowStartTime	string (date-time)	メンテナンス前期間の開始時刻。

PatchOperationStatus

列挙

操作の全体的な成功または失敗の状態。操作が完了するまで「InProgress」のままです。その時点で、"Unknown"、"Failed"、"Succeeded"、または "CompletedWithWarnings" になります。

値	説明
Unknown
InProgress
Failed
Succeeded
CompletedWithWarnings

StatusLevelTypes

列挙

レベルコード。

値	説明
Info
Warning
Error

StorageAlignmentStatus

列挙

ディスクのストレージアライメント状態を指定します。

値	説明
Unaligned	ディスクには故障ドメインのマッピングを計算するためのストレージ障害ドメイン(Storage Fault Domain)はありません。単一のストレージフォールトドメイン障害が、このディスクプロファイルを参照するすべてのVMに影響を及ぼす可能性があります。
Aligned	ディスクにはストレージフォールトドメインがあり、フォールトドメインのマッピングを計算します。ストレージフォールトドメインの障害は、単一のコンピュートフォールトドメイン内のVMに限定されます。

SubResource

Object

Name	型	説明
id	string	リソース ID

VirtualMachineAgentInstanceView

Object

仮想マシンで実行されている VM エージェントのインスタンスビュー。

Name	型	説明
extensionHandlers	VirtualMachineExtensionHandlerInstanceView[]	仮想マシン拡張機能ハンドラーインスタンスビュー。
statuses	InstanceViewStatus[]	リソースの状態情報。
vmAgentVersion	string	VM エージェントの完全なバージョン。

VirtualMachineExtensionHandlerInstanceView

Object

仮想マシン拡張機能ハンドラーのインスタンスビュー。

Name	型	説明
status	InstanceViewStatus	拡張機能ハンドラーの状態。
type	string	拡張機能の型を指定します。たとえば、"CustomScriptExtension" です。
typeHandlerVersion	string	スクリプトハンドラのMajor.Minor.Patch.Hotfixバージョンを指定します。 Azureプラットフォームは、最新のPatch.HotfixバージョンをMajor.Minorシリーズで提供します。

VirtualMachineExtensionInstanceView

Object

仮想マシン拡張機能のインスタンスビュー。

Name	型	説明
name	string	仮想マシン拡張機能の名前。
statuses	InstanceViewStatus[]	リソースの状態情報。
substatuses	InstanceViewStatus[]	リソースの状態情報。
type	string	拡張機能の型を指定します。たとえば、"CustomScriptExtension" です。
typeHandlerVersion	string	スクリプトハンドラのMajor.Minor.Patch.Hotfixバージョンを指定します。 Azureプラットフォームは、最新のPatch.HotfixバージョンをMajor.Minorシリーズで提供します。

VirtualMachineHealthStatus

Object

VM の正常性状態。

Name	型	説明
status	InstanceViewStatus	VM の正常性状態情報。

VirtualMachineInstanceView

Object

仮想マシンのインスタンスビュー。

Name	型	説明
assignedHost	string	自動配置が有効になっている専用ホストグループに仮想マシンが関連付けられている場合に、仮想マシンが自動配置によって割り当てられる専用ホストのリソース ID。最小 API バージョン: 2020-06-01。
bootDiagnostics	BootDiagnosticsInstanceView	ブート診断は、コンソール出力とスクリーンショットを表示して VM の状態を診断できるデバッグ機能です。コンソールログの出力を簡単に表示できます。 Azure では、ハイパーバイザーから VM のスクリーンショットを表示することもできます。
capacityReservationType	CapacityReservationType	仮想マシンが適格であればどの種類の容量予約から容量を使用するか、またはサブスクリプション内の予約容量から明示的にオプトアウトされるかを指定します。最低APIバージョン:2026-04-01。
computerName	string	仮想マシンに割り当てられたコンピューター名。
disks	DiskInstanceView[]	仮想マシンのディスク情報。
extensions	VirtualMachineExtensionInstanceView[]	拡張機能の情報。
hyperVGeneration	HyperVGenerationType	リソースに関連付けられている HyperVGeneration の種類を指定します。
interconnectInstanceView	InterconnectInstanceView	仮想マシンのインターコネクトランタイムビュー。最低APIバージョン:2026-03-01。
isVMInStandbyPool	boolean	[プレビュー機能]VM が現在スタンバイプール内にあるか、スタンバイプール外にあるかを指定します。
maintenanceRedeployStatus	MaintenanceRedeployStatus	仮想マシンのメンテナンス操作の状態。
osName	string	仮想マシンで実行されているオペレーティングシステム。
osVersion	string	仮想マシンで実行されているオペレーティングシステムのバージョン。
patchStatus	VirtualMachinePatchStatus	[プレビュー機能]仮想マシンのパッチ操作の状態。
platformFaultDomain	integer (int32)	仮想マシンの障害ドメインを指定します。
platformUpdateDomain	integer (int32)	仮想マシンの更新ドメインを指定します。
rdpThumbPrint	string	リモートデスクトップ証明書の拇印。
statuses	InstanceViewStatus[]	リソースの状態情報。
vmAgent	VirtualMachineAgentInstanceView	仮想マシンで実行されている VM エージェント。
vmHealth	VirtualMachineHealthStatus	VM の正常性状態。

VirtualMachinePatchStatus

Object

仮想マシンのパッチ操作の状態。

Name	型	説明
availablePatchSummary	AvailablePatchSummary	仮想マシンの最新の評価操作の利用可能なパッチの概要。
configurationStatuses	InstanceViewStatus[]	指定した patchMode の有効化状態
lastPatchInstallationSummary	LastPatchInstallationSummary	仮想マシンの最新のインストール操作のインストールの概要。