Virtual Machines - Instance View

サービス:: Compute

API バージョン:: 2025-11-01

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

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

URI パラメーター

名前	/	必須	型	説明
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 バージョン。

応答

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

セキュリティ

azure_auth

Azure Active Directory OAuth2 Flow.

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

スコープ

名前	説明
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=2025-11-01

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

応答のサンプル

状態コード:: 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.

要求のサンプル

HTTP
dotnet

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

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

応答のサンプル

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

定義

名前	説明
ApiError	API エラー。
ApiErrorBase	API エラーベース。
AvailablePatchSummary	使用可能なパッチの概要の仮想マシンインスタンスビューのプロパティについて説明します。
BootDiagnosticsInstanceView	仮想マシンのブート診断のインスタンスビュー。
CloudError	コンピューティングサービスからのエラー応答。
DiskEncryptionSettings	ディスクの暗号化設定について説明します
DiskInstanceView	ディスクのインスタンスビュー。
HyperVGenerationType	リソースに関連付けられている HyperVGeneration の種類を指定します。
InnerError	内部エラーの詳細。
InstanceViewStatus	インスタンスビューの状態。
KeyVaultKeyReference	Key Vault Keyへの言及を説明します
KeyVaultSecretReference	Key Vault Secretへの言及を説明しています
LastPatchInstallationSummary	最後にインストールされたパッチの概要のプロパティについて説明します。
MaintenanceOperationResultCodeTypes	最後のメンテナンス操作の結果コード。
MaintenanceRedeployStatus	メンテナンス操作の状態。
PatchOperationStatus	操作の全体的な成功または失敗の状態。操作が完了するまで、"InProgress" のままです。その時点で、"不明"、"失敗"、"成功"、または "CompletedWithWarnings" になります。
StatusLevelTypes	レベルコード。
StorageAlignmentStatus	ディスクのストレージアライメント状態を指定します。
SubResource
VirtualMachineAgentInstanceView	仮想マシンで実行されている VM エージェントのインスタンスビュー。
VirtualMachineExtensionHandlerInstanceView	仮想マシン拡張機能ハンドラーのインスタンスビュー。
VirtualMachineExtensionInstanceView	仮想マシン拡張機能のインスタンスビュー。
VirtualMachineHealthStatus	VM の正常性状態。
VirtualMachineInstanceView	仮想マシンのインスタンスビュー。
VirtualMachinePatchStatus	仮想マシンのパッチ操作の状態。

ApiError

Object

API エラー。

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

ApiErrorBase

Object

API エラーベース。

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

AvailablePatchSummary

Object

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

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

BootDiagnosticsInstanceView

Object

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

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

CloudError

Object

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

名前	型	説明
error	ApiError	API エラー。

DiskEncryptionSettings

Object

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

名前	型	説明
diskEncryptionKey	KeyVaultSecretReference	ディスク暗号化鍵の場所を指定することであり、それはKey Vault Secretです。
enabled	boolean	仮想マシンでディスク暗号化を有効にするかどうかを指定します。
keyEncryptionKey	KeyVaultKeyReference	Key Vault内の鍵暗号鍵の場所を指定します。

DiskInstanceView

Object

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

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

HyperVGenerationType

列挙

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

値	説明
V1
V2

InnerError

Object

内部エラーの詳細。

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

InstanceViewStatus

Object

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

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

KeyVaultKeyReference

Object

Key Vault Keyへの言及を説明します

名前	型	説明
keyUrl	string	Key Vaultの鍵暗号鍵を参照するURLです。
sourceVault	SubResource	鍵を含むKey Vaultの相対URLです。

KeyVaultSecretReference

Object

Key Vault Secretへの言及を説明しています

名前	型	説明
secretUrl	string	Key Vault内の秘密を参照するURLです。
sourceVault	SubResource	秘密を含むKey Vaultの相関URLです。

LastPatchInstallationSummary

Object

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

名前	型	説明
error	ApiError	操作の実行中に発生したエラー。詳細配列には、それらのリストが含まれています。
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" のままです。その時点で、"不明"、"失敗"、"成功"、または "CompletedWithWarnings" になります。

MaintenanceOperationResultCodeTypes

列挙

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

値	説明
None
RetryLater
MaintenanceAborted
MaintenanceCompleted

MaintenanceRedeployStatus

Object

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

名前	型	説明
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" のままです。その時点で、"不明"、"失敗"、"成功"、または "CompletedWithWarnings" になります。

値	説明
Unknown
InProgress
Failed
Succeeded
CompletedWithWarnings

StatusLevelTypes

列挙

レベルコード。

値	説明
Info
Warning
Error

StorageAlignmentStatus

列挙

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

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

SubResource

Object

名前	型	説明
id	string	リソース ID

VirtualMachineAgentInstanceView

Object

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

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

VirtualMachineExtensionHandlerInstanceView

Object

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

名前	型	説明
status	InstanceViewStatus	拡張機能ハンドラーの状態。
type	string	拡張機能の型を指定します。たとえば、"CustomScriptExtension" です。
typeHandlerVersion	string	スクリプトハンドラーのバージョンを指定します。

VirtualMachineExtensionInstanceView

Object

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

名前	型	説明
name	string	仮想マシン拡張機能の名前。
statuses	InstanceViewStatus[]	リソースの状態情報。
substatuses	InstanceViewStatus[]	リソースの状態情報。
type	string	拡張機能の型を指定します。たとえば、"CustomScriptExtension" です。
typeHandlerVersion	string	スクリプトハンドラーのバージョンを指定します。

VirtualMachineHealthStatus

Object

VM の正常性状態。

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

VirtualMachineInstanceView

Object

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

名前	型	説明
assignedHost	string	自動配置が有効になっている専用ホストグループに仮想マシンが関連付けられている場合に、仮想マシンが自動配置によって割り当てられる専用ホストのリソース ID。最小 API バージョン: 2020-06-01。
bootDiagnostics	BootDiagnosticsInstanceView	ブート診断は、コンソール出力とスクリーンショットを表示して VM の状態を診断できるデバッグ機能です。コンソールログの出力を簡単に表示できます。 Azureでは、ハイパーバイザーからVMのスクリーンショットも確認できます。
computerName	string	仮想マシンに割り当てられたコンピューター名。
disks	DiskInstanceView[]	仮想マシンのディスク情報。
extensions	VirtualMachineExtensionInstanceView[]	拡張機能の情報。
hyperVGeneration	HyperVGenerationType	リソースに関連付けられている HyperVGeneration の種類を指定します。
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

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

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