Virtual Machines - Instance View

Извлекает сведения о состоянии виртуальной машины во время выполнения.

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

Параметры URI

Имя В Обязательно Тип Описание
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Имя группы ресурсов. Имя нечувствительно к регистру.

subscriptionId
path True

string

minLength: 1

Идентификатор целевой подписки.

vmName
path True

string

Имя виртуальной машины.

api-version
query True

string

minLength: 1

Версия API, используемая для данной операции.

Ответы

Имя Тип Описание
200 OK

VirtualMachineInstanceView

Операция Azure успешно завершена.

Other Status Codes

CloudError

Непредвиденное сообщение об ошибке.

Безопасность

azure_auth

Поток OAuth2 в Azure Active Directory.

Тип: oauth2
Flow: implicit
URL-адрес авторизации: https://login.microsoftonline.com/common/oauth2/authorize

Области

Имя Описание
user_impersonation выдать себя за учетную запись пользователя

Примеры

Get instance view of a virtual machine associated with an Interconnect Block.
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 associated with an Interconnect Block.

Образец запроса

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/instanceView?api-version=2026-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": "2026-03-01T23:11:22+00:00"
      }
    ]
  },
  "disks": [
    {
      "name": "myOsDisk",
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "time": "2026-03-01T21:29:47.477089+00:00"
        }
      ]
    }
  ],
  "hyperVGeneration": "V1",
  "interconnectInstanceView": {
    "interconnectSubgroupId": "{GUID}"
  },
  "statuses": [
    {
      "code": "ProvisioningState/succeeded",
      "level": "Info",
      "displayStatus": "Provisioning succeeded",
      "time": "2026-03-01T21:30:12.8051917+00:00"
    },
    {
      "code": "PowerState/running",
      "level": "Info",
      "displayStatus": "VM running"
    }
  ]
}

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-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": "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.

Образец запроса

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVM/instanceView?api-version=2026-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

Представление экземпляра диагностики загрузки виртуальной машины.

CloudError

Ответ на ошибку из службы вычислений.

DiskEncryptionSettings

Описание параметров шифрования диска

DiskInstanceView

Представление экземпляра диска.

HyperVGenerationType

Указывает тип HyperVGeneration, связанный с ресурсом

InnerError

Сведения о внутренней ошибке.

InstanceViewStatus

Состояние представления экземпляра.

InterconnectInstanceView

Детали просмотра инстанса Interconnect Block для виртуальной машины или экземпляра VM с набором масштабирования.

KeyVaultKeyReference

Описание ссылки на ключ Key Vault

KeyVaultSecretReference

Описание ссылки на секрет Key Vault

LastPatchInstallationSummary

Описывает свойства последней установленной сводки исправлений.

MaintenanceOperationResultCodeTypes

Код результата последней операции обслуживания.

MaintenanceRedeployStatus

Состояние операции обслуживания.

PatchOperationStatus

Общее состояние успешного или неудачного выполнения операции. Он остается "InProgress" до тех пор, пока операция не завершится. В этот момент он станет "Unknown", "Failed", "Succeeded" или "CompletedWithWarnings".

StatusLevelTypes

Код уровня.

StorageAlignmentStatus

Задаёт статус выравнивания памяти для диска.

SubResource
VirtualMachineAgentInstanceView

Представление экземпляра агента виртуальной машины, работающего на виртуальной машине.

VirtualMachineExtensionHandlerInstanceView

Представление экземпляра обработчика расширений виртуальной машины.

VirtualMachineExtensionInstanceView

Представление экземпляра расширения виртуальной машины.

VirtualMachineHealthStatus

Состояние работоспособности виртуальной машины.

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

Идентификатор действия операции, которая привела к получению этого результата. Он используется для корреляции между журналами БЕЗОПАСНОСТИ и расширений.

criticalAndSecurityPatchCount

integer (int32)

Количество критически важных или исправлений безопасности, обнаруженных как доступные и еще не установленные.

error

ApiError

Ошибки, возникшие во время выполнения операции. Массив details содержит их список.

lastModifiedTime

string (date-time)

Временная метка UTC в момент начала операции.

otherPatchCount

integer (int32)

Количество всех доступных исправлений, за исключением критически важных и безопасности.

rebootPending

boolean

Общее состояние перезагрузки виртуальной машины. Это будет верно, когда частично установленные патчи требуют перезагрузки для завершения установки, но перезагрузка еще не произошла.

startTime

string (date-time)

Временная метка UTC в момент начала операции.

status

PatchOperationStatus

Общее состояние успешного или неудачного выполнения операции. Он остается "InProgress" до тех пор, пока операция не завершится. В этот момент он станет "Unknown", "Failed", "Succeeded" или "CompletedWithWarnings".

BootDiagnosticsInstanceView

Представление экземпляра диагностики загрузки виртуальной машины.

Имя Тип Описание
consoleScreenshotBlobUri

string

URI большого двоичного объекта консоли. Примечание. это не задаваться, если диагностика загрузки в настоящее время включена с управляемым хранилищем.

serialConsoleLogBlobUri

string

Универсальный код ресурса (URI) URI для последовательной консоли консоли. Примечание. это не задаваться, если диагностика загрузки в настоящее время включена с управляемым хранилищем.

status

InstanceViewStatus

Сведения о состоянии диагностики загрузки для виртуальной машины. Примечание. Он будет задан только в том случае, если возникают ошибки при включении диагностики загрузки.

CloudError

Ответ на ошибку из службы вычислений.

Имя Тип Описание
error

ApiError

Ошибка API.

DiskEncryptionSettings

Описание параметров шифрования диска

Имя Тип Описание
diskEncryptionKey

KeyVaultSecretReference

Указывает расположение ключа шифрования диска, являющегося секретом Key Vault.

enabled

boolean

Указывает, следует ли включить шифрование дисков на виртуальной машине.

keyEncryptionKey

KeyVaultKeyReference

Указывает расположение ключа шифрования ключей в Key Vault.

DiskInstanceView

Представление экземпляра диска.

Имя Тип Описание
encryptionSettings

DiskEncryptionSettings[]

Задает параметры шифрования для диска ОС.

Минимальная версия API: 2015-06-15

name

string

Имя диска.

statuses

InstanceViewStatus[]

Сведения о состоянии ресурса.

storageAlignmentStatus

StorageAlignmentStatus

Задаёт статус выравнивания памяти для диска.

HyperVGenerationType

Указывает тип HyperVGeneration, связанный с ресурсом

Значение Описание
V1
V2

InnerError

Сведения о внутренней ошибке.

Имя Тип Описание
errordetail

string

Внутреннее сообщение об ошибке или дамп исключений.

exceptiontype

string

Тип исключения.

InstanceViewStatus

Состояние представления экземпляра.

Имя Тип Описание
code

string

Код состояния.

displayStatus

string

Короткая локализуемая метка для состояния.

level

StatusLevelTypes

Код уровня.

message

string

Подробное сообщение о состоянии, в том числе для оповещений и сообщений об ошибках.

time

string (date-time)

Время состояния.

InterconnectInstanceView

Детали просмотра инстанса Interconnect Block для виртуальной машины или экземпляра VM с набором масштабирования.

Имя Тип Описание
interconnectSubgroupId

string

ID (GUID) подгруппы Interconnect, в которую была размещена Виртуальная машина.

KeyVaultKeyReference

Описание ссылки на ключ Key Vault

Имя Тип Описание
keyUrl

string

URL-адрес, ссылающийся на ключ шифрования ключей в Key Vault.

sourceVault

SubResource

Относительный URL-адрес Хранилища ключей, содержащий ключ.

KeyVaultSecretReference

Описание ссылки на секрет Key Vault

Имя Тип Описание
secretUrl

string

URL-адрес, ссылающийся на секрет в Key Vault.

sourceVault

SubResource

Относительный URL-адрес Хранилища ключей, содержащий секрет.

LastPatchInstallationSummary

Описывает свойства последней установленной сводки исправлений.

Имя Тип Описание
error

ApiError

Ошибки, возникшие во время выполнения операции. Массив details содержит их список.

excludedPatchCount

integer (int32)

Количество всех доступных исправлений, кроме явно исключенных списком исключений, заданным клиентом.

failedPatchCount

integer (int32)

Количество исправлений, которые не удалось установить.

installationActivityId

string

Идентификатор действия операции, которая привела к получению этого результата. Он используется для корреляции между журналами БЕЗОПАСНОСТИ и расширений.

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

Состояние операции обслуживания.

Имя Тип Описание
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

Диск не имеет домен неисправности хранения для вычисления отображения доменов ошибок. Один сбой в домене сбоя памяти может затронуть все виртуальные машины, ссылающиеся на этот профиль диска.

Aligned

Диск имеет домен неисправностей хранения для вычисления отображения доменов отказа. Сбой в домене неисправности хранения ограничен виртуальными машинами в одном домене вычислительной неисправности.

SubResource

Имя Тип Описание
id

string

Идентификатор ресурса

VirtualMachineAgentInstanceView

Представление экземпляра агента виртуальной машины, работающего на виртуальной машине.

Имя Тип Описание
extensionHandlers

VirtualMachineExtensionHandlerInstanceView[]

Представление экземпляра обработчика расширений виртуальной машины.

statuses

InstanceViewStatus[]

Сведения о состоянии ресурса.

vmAgentVersion

string

Полная версия агента виртуальной машины.

VirtualMachineExtensionHandlerInstanceView

Представление экземпляра обработчика расширений виртуальной машины.

Имя Тип Описание
status

InstanceViewStatus

Состояние обработчика расширения.

type

string

Указывает тип расширения; примером является CustomScriptExtension.

typeHandlerVersion

string

Указывает версию обработчика скрипта.

VirtualMachineExtensionInstanceView

Представление экземпляра расширения виртуальной машины.

Имя Тип Описание
name

string

Имя расширения виртуальной машины.

statuses

InstanceViewStatus[]

Сведения о состоянии ресурса.

substatuses

InstanceViewStatus[]

Сведения о состоянии ресурса.

type

string

Указывает тип расширения; примером является CustomScriptExtension.

typeHandlerVersion

string

Указывает версию обработчика скрипта.

VirtualMachineHealthStatus

Состояние работоспособности виртуальной машины.

Имя Тип Описание
status

InstanceViewStatus

Сведения о состоянии работоспособности виртуальной машины.

VirtualMachineInstanceView

Представление экземпляра виртуальной машины.

Имя Тип Описание
assignedHost

string

Идентификатор ресурса выделенного узла, на котором виртуальная машина выделяется с помощью автоматического размещения, когда виртуальная машина связана с выделенной группой узлов с включенным автоматическим размещением. Минимальная версия API: 2020-06-01.

bootDiagnostics

BootDiagnosticsInstanceView

Диагностика загрузки — это функция отладки, которая позволяет просматривать выходные данные консоли и снимок экрана для диагностики состояния виртуальной машины. Вы можете легко просмотреть выходные данные журнала консоли. Azure также позволяет просмотреть снимок экрана виртуальной машины из гипервизора.

computerName

string

Имя компьютера, назначенное виртуальной машине.

disks

DiskInstanceView[]

Сведения о диске виртуальной машины.

extensions

VirtualMachineExtensionInstanceView[]

Сведения о расширениях.

hyperVGeneration

HyperVGenerationType

Указывает тип HyperVGeneration, связанный с ресурсом

interconnectInstanceView

InterconnectInstanceView

Межконнективный вид виртуальной машины во время выполнения. Минимальная версия api: 2026-03-01.

isVMInStandbyPool

boolean

[Предварительная версия компонента] Указывает, находится ли виртуальная машина в резервном пуле или вне нее.

maintenanceRedeployStatus

MaintenanceRedeployStatus

Состояние операции обслуживания на виртуальной машине.

osName

string

Операционная система, запущенная на виртуальной машине.

osVersion

string

Версия операционной системы, запущенной на виртуальной машине.

patchStatus

VirtualMachinePatchStatus

[Предварительная версия компонента] Состояние операций исправления виртуальной машины.

platformFaultDomain

integer (int32)

Указывает домен сбоя виртуальной машины.

platformUpdateDomain

integer (int32)

Указывает домен обновления виртуальной машины.

rdpThumbPrint

string

Отпечаток сертификата удаленного рабочего стола.

statuses

InstanceViewStatus[]

Сведения о состоянии ресурса.

vmAgent

VirtualMachineAgentInstanceView

Агент виртуальной машины, работающий на виртуальной машине.

vmHealth

VirtualMachineHealthStatus

Состояние работоспособности виртуальной машины.

VirtualMachinePatchStatus

Состояние операций исправления виртуальной машины.

Имя Тип Описание
availablePatchSummary

AvailablePatchSummary

Доступная сводка по исправлению последней операции оценки для виртуальной машины.

configurationStatuses

InstanceViewStatus[]

Состояние включения указанного patchMode

lastPatchInstallationSummary

LastPatchInstallationSummary

Сводка по установке последней операции установки для виртуальной машины.