Virtual Machines - Instance View

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

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

URI パラメーター

名前 / 必須 説明
resourceGroupName
path True

string

リソース グループの名前。

subscriptionId
path True

string

Microsoft Azure サブスクリプションを一意に識別するサブスクリプション資格情報。 サブスクリプション ID は、すべてのサービス呼び出しの URI の一部を形成します。

vmName
path True

string

仮想マシンの名前。

api-version
query True

string

クライアント API のバージョン。

応答

名前 説明
200 OK

VirtualMachineInstanceView

わかりました

Other Status Codes

CloudError

操作が失敗した理由を説明するエラー応答。

セキュリティ

azure_auth

Azure Active Directory OAuth2 フロー

型: 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=2024-03-01

応答のサンプル

{
  "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": "2024-03-01T23:11:22+00:00"
      }
    ]
  },
  "disks": [
    {
      "name": "myOsDisk",
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "time": "2024-03-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": "2024-03-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=2024-03-01

応答のサンプル

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

ブート診断は、コンソール出力とスクリーンショットを表示して VM の状態を診断できるデバッグ機能です。 コンソール ログの出力を簡単に表示できます。 Azure では、ハイパーバイザーから VM のスクリーンショットを表示することもできます。

CloudError

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

DiskEncryptionSettings

OS ディスクの暗号化設定を指定します。

最小 API バージョン: 2015-06-15

DiskInstanceView

仮想マシンのディスク情報。

HyperVGenerationType

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

InnerError

内部エラーの詳細。

InstanceViewStatus

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

KeyVaultKeyReference

Key Vault 内のキー暗号化キーの場所を指定します。

KeyVaultSecretReference

ディスク暗号化キー (Key Vault シークレット) の場所を指定します。

LastPatchInstallationSummary

仮想マシンの最新のインストール操作のインストールの概要。

MaintenanceOperationResultCodeTypes

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

MaintenanceRedeployStatus

仮想マシンのメンテナンス操作の状態。

PatchOperationStatus

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

StatusLevelTypes

レベル コード。

SubResource

シークレットを含む Key Vault の相対 URL。

VirtualMachineAgentInstanceView

仮想マシンで実行されている VM エージェント。

VirtualMachineExtensionHandlerInstanceView

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

VirtualMachineExtensionInstanceView

拡張機能の情報。

VirtualMachineHealthStatus

VM の正常性状態。

VirtualMachineInstanceView

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

VirtualMachinePatchStatus

[プレビュー機能]仮想マシンのパッチ操作の状態。

ApiError

API エラー。

名前 説明
code

string

エラー コード。

details

ApiErrorBase[]

Api エラーの詳細

innererror

InnerError

Api 内部エラー

message

string

エラー メッセージ。

target

string

特定のエラーのターゲット。

ApiErrorBase

API エラーベース。

名前 説明
code

string

エラー コード。

message

string

エラー メッセージ。

target

string

特定のエラーのターゲット。

AvailablePatchSummary

仮想マシンの最新の評価操作の利用可能なパッチの概要。

名前 説明
assessmentActivityId

string

この結果を生成した操作のアクティビティ ID。 これは、CRP と拡張機能のログ間で相互に関連付けるために使用されます。

criticalAndSecurityPatchCount

integer

使用可能として検出され、まだインストールされていないクリティカルパッチまたはセキュリティパッチの数。

error

ApiError

操作の実行中に発生したエラー。 詳細配列には、それらのリストが含まれています。

lastModifiedTime

string

操作が開始されたときの UTC タイムスタンプ。

otherPatchCount

integer

クリティカルおよびセキュリティを除く使用可能なすべてのパッチの数。

rebootPending

boolean

VM の全体的な再起動状態。 これは、部分的にインストールされたパッチがインストールを完了するために再起動を必要とするが、再起動がまだ発生していない場合に当てはまります。

startTime

string

操作が開始されたときの UTC タイムスタンプ。

status

PatchOperationStatus

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

BootDiagnosticsInstanceView

ブート診断は、コンソール出力とスクリーンショットを表示して VM の状態を診断できるデバッグ機能です。 コンソール ログの出力を簡単に表示できます。 Azure では、ハイパーバイザーから VM のスクリーンショットを表示することもできます。

名前 説明
consoleScreenshotBlobUri

string

コンソールのスクリーンショット BLOB URI。 注: ブート診断がマネージド ストレージで現在有効になっている場合、これは設定

serialConsoleLogBlobUri

string

シリアル コンソール ログ BLOB URI。 注: ブート診断がマネージド ストレージで現在有効になっている場合、これは設定

status

InstanceViewStatus

VM のブート診断の状態情報。 注: ブート診断の有効化でエラーが発生した場合にのみ設定されます。

CloudError

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

名前 説明
error

ApiError

API エラー。

DiskEncryptionSettings

OS ディスクの暗号化設定を指定します。

最小 API バージョン: 2015-06-15

名前 説明
diskEncryptionKey

KeyVaultSecretReference

ディスク暗号化キー (Key Vault シークレット) の場所を指定します。

enabled

boolean

仮想マシンでディスク暗号化を有効にするかどうかを指定します。

keyEncryptionKey

KeyVaultKeyReference

Key Vault 内のキー暗号化キーの場所を指定します。

DiskInstanceView

仮想マシンのディスク情報。

名前 説明
encryptionSettings

DiskEncryptionSettings[]

OS ディスクの暗号化設定を指定します。

最小 API バージョン: 2015-06-15

name

string

ディスク名。

statuses

InstanceViewStatus[]

リソースの状態情報。

HyperVGenerationType

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

名前 説明
V1

string

V2

string

InnerError

内部エラーの詳細。

名前 説明
errordetail

string

内部エラー メッセージまたは例外ダンプ。

exceptiontype

string

例外の種類。

InstanceViewStatus

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

名前 説明
code

string

状態コード。

displayStatus

string

状態の短いローカライズ可能なラベル。

level

StatusLevelTypes

レベル コード。

message

string

アラートやエラー メッセージを含む詳細なステータス メッセージ。

time

string

状態の時刻。

KeyVaultKeyReference

Key Vault 内のキー暗号化キーの場所を指定します。

名前 説明
keyUrl

string

Key Vault のキー暗号化キーを参照する URL。

sourceVault

SubResource

キーを含む Key Vault の相対 URL。

KeyVaultSecretReference

ディスク暗号化キー (Key Vault シークレット) の場所を指定します。

名前 説明
secretUrl

string

Key Vault 内のシークレットを参照する URL。

sourceVault

SubResource

シークレットを含む Key Vault の相対 URL。

LastPatchInstallationSummary

仮想マシンの最新のインストール操作のインストールの概要。

名前 説明
error

ApiError

操作の実行中に発生したエラー。 詳細配列には、それらのリストが含まれています。

excludedPatchCount

integer

お客様が指定した除外リストによって明示的に除外されたすべての利用可能なパッチの数が一致します。

failedPatchCount

integer

インストールに失敗した修正プログラムの数。

installationActivityId

string

この結果を生成した操作のアクティビティ ID。 これは、CRP と拡張機能のログ間で相互に関連付けるために使用されます。

installedPatchCount

integer

正常にインストールされたパッチの数。

lastModifiedTime

string

操作が開始されたときの UTC タイムスタンプ。

maintenanceWindowExceeded

boolean

操作が目的のすべてのアクションを完了する前に時間がなくなったかどうかを説明します

notSelectedPatchCount

integer

使用可能なすべてのパッチの数。分類または包含リストのエントリと一致しなかったため、インストールされません。

pendingPatchCount

integer

修正プログラムのインストール操作の過程で、使用可能なすべてのパッチの数がインストールされる予定です。

startTime

string

操作が開始されたときの UTC タイムスタンプ。

status

PatchOperationStatus

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

MaintenanceOperationResultCodeTypes

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

名前 説明
MaintenanceAborted

string

MaintenanceCompleted

string

None

string

RetryLater

string

MaintenanceRedeployStatus

仮想マシンのメンテナンス操作の状態。

名前 説明
isCustomerInitiatedMaintenanceAllowed

boolean

True の 場合は、お客様がメンテナンスを実行できます。

lastOperationMessage

string

最後のメンテナンス操作に関して返されたメッセージ。

lastOperationResultCode

MaintenanceOperationResultCodeTypes

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

maintenanceWindowEndTime

string

メンテナンス期間の終了時刻。

maintenanceWindowStartTime

string

メンテナンス期間の開始時刻。

preMaintenanceWindowEndTime

string

メンテナンス前期間の終了時刻。

preMaintenanceWindowStartTime

string

メンテナンス前期間の開始時刻。

PatchOperationStatus

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

名前 説明
CompletedWithWarnings

string

Failed

string

InProgress

string

Succeeded

string

Unknown

string

StatusLevelTypes

レベル コード。

名前 説明
Error

string

Info

string

Warning

string

SubResource

シークレットを含む Key Vault の相対 URL。

名前 説明
id

string

リソース ID

VirtualMachineAgentInstanceView

仮想マシンで実行されている VM エージェント。

名前 説明
extensionHandlers

VirtualMachineExtensionHandlerInstanceView[]

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

statuses

InstanceViewStatus[]

リソースの状態情報。

vmAgentVersion

string

VM エージェントの完全なバージョン。

VirtualMachineExtensionHandlerInstanceView

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

名前 説明
status

InstanceViewStatus

拡張機能ハンドラーの状態。

type

string

拡張機能の型を指定します。たとえば、"CustomScriptExtension" です。

typeHandlerVersion

string

スクリプト ハンドラーのバージョンを指定します。

VirtualMachineExtensionInstanceView

拡張機能の情報。

名前 説明
name

string

仮想マシン拡張機能の名前。

statuses

InstanceViewStatus[]

リソースの状態情報。

substatuses

InstanceViewStatus[]

リソースの状態情報。

type

string

拡張機能の型を指定します。たとえば、"CustomScriptExtension" です。

typeHandlerVersion

string

スクリプト ハンドラーのバージョンを指定します。

VirtualMachineHealthStatus

VM の正常性状態。

名前 説明
status

InstanceViewStatus

VM の正常性状態情報。

VirtualMachineInstanceView

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

名前 説明
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

仮想マシンの障害ドメインを指定します。

platformUpdateDomain

integer

仮想マシンの更新ドメインを指定します。

rdpThumbPrint

string

リモート デスクトップ証明書の拇印。

statuses

InstanceViewStatus[]

リソースの状態情報。

vmAgent

VirtualMachineAgentInstanceView

仮想マシンで実行されている VM エージェント。

vmHealth

VirtualMachineHealthStatus

VM の正常性状態。

VirtualMachinePatchStatus

[プレビュー機能]仮想マシンのパッチ操作の状態。

名前 説明
availablePatchSummary

AvailablePatchSummary

仮想マシンの最新の評価操作の利用可能なパッチの概要。

configurationStatuses

InstanceViewStatus[]

指定した patchMode の有効化状態

lastPatchInstallationSummary

LastPatchInstallationSummary

仮想マシンの最新のインストール操作のインストールの概要。