Aracılığıyla paylaş


Virtual Machines - Instance View

Bir sanal makinenin çalışma zamanı durumu hakkındaki bilgileri alır.

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

URI Parametreleri

Name İçinde Gerekli Tür Description
resourceGroupName
path True

string

Kaynak grubunun adı.

subscriptionId
path True

string

Microsoft Azure aboneliğini benzersiz olarak tanımlayan abonelik kimlik bilgileri. Abonelik kimliği, her hizmet çağrısı için URI'nin bir parçasını oluşturur.

vmName
path True

string

Sanal makinenin adı.

api-version
query True

string

İstemci Api Sürümü.

Yanıtlar

Name Tür Description
200 OK

VirtualMachineInstanceView

Tamam

Other Status Codes

CloudError

İşlemin neden başarısız olduğunu açıklayan hata yanıtı.

Güvenlik

azure_auth

Azure Active Directory OAuth2 Flow

Tür: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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.

Sample request

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

Sample response

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

Sample request

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

Sample response

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

Sanal makine için en son değerlendirme işleminin kullanılabilir düzeltme eki özeti.

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 hiper yöneticiden vm'nin ekran görüntüsünü görmenizi sağlar.

CloudError

İşlem hizmetinden bir hata yanıtı.

DiskEncryptionSettings

İşletim Sistemi Diski için şifreleme ayarlarını belirtir.

En düşük api sürümü: 2015-06-15

DiskInstanceView

Sanal makine disk bilgileri.

HyperVGenerationType

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

InnerError

İç hata ayrıntıları.

InstanceViewStatus

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

KeyVaultKeyReference

anahtar şifreleme anahtarının Key Vault konumunu belirtir.

KeyVaultSecretReference

Key Vault Gizli Anahtarı olan disk şifreleme anahtarının konumunu belirtir.

LastPatchInstallationSummary

Sanal makine için en son yükleme işleminin yükleme özeti.

MaintenanceOperationResultCodeTypes

Son Bakım İşlemi Sonuç Kodu.

MaintenanceRedeployStatus

Sanal makinedeki Bakım İşlemi durumu.

PatchOperationStatus

İşlemin genel başarı veya başarısızlık durumu. İşlem tamamlanana kadar "InProgress" olarak kalır. Bu noktada "Bilinmiyor", "Başarısız", "Başarılı" veya "CompletedWithWarnings" olur.

StatusLevelTypes

Düzey kodu.

SubResource

Gizli diziyi içeren Key Vault göreli URL'si.

VirtualMachineAgentInstanceView

Sanal makinede çalışan VM Aracısı.

VirtualMachineExtensionHandlerInstanceView

Sanal makine uzantısı işleyici örneği görünümü.

VirtualMachineExtensionInstanceView

Uzantı bilgileri.

VirtualMachineHealthStatus

VM'nin sistem durumu.

VirtualMachineInstanceView

Sanal makinenin örnek görünümü.

VirtualMachinePatchStatus

[Önizleme Özelliği] Sanal makine düzeltme eki işlemlerinin durumu.

ApiError

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

Api hata tabanı.

Name Tür Description
code

string

Hata kodu.

message

string

Hata iletisi.

target

string

Belirli bir hatanın hedefi.

AvailablePatchSummary

Sanal makine için en son değerlendirme işleminin kullanılabilir düzeltme eki özeti.

Name Tür Description
assessmentActivityId

string

Bu sonucu oluşturan işlemin etkinlik kimliği. CRP ve uzantı günlükleri arasında bağıntı sağlamak için kullanılır.

criticalAndSecurityPatchCount

integer

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

İşlemin başladığı UTC zaman damgası.

otherPatchCount

integer

Kritik ve güvenlik hariç kullanılabilir tüm düzeltme eklerinin sayısı.

rebootPending

boolean

VM'nin genel yeniden başlatma durumu. Kısmen yüklenen düzeltme ekleri yüklemeyi tamamlamak için yeniden başlatma gerektirdiğinde ancak yeniden başlatma henüz gerçekleşmediğinde bu durum geçerli olacaktır.

startTime

string

İş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 "Bilinmiyor", "Başarısız", "Başarılı" veya "CompletedWithWarnings" olur.

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 hiper yöneticiden vm'nin ekran görüntüsünü görmenizi sağlar.

Name Tür Description
consoleScreenshotBlobUri

string

Konsol ekran görüntüsü blob URI'si. Not: Önyükleme tanılaması şu anda yönetilen depolama ile etkinleştirildiyse bu ayar yapılmaz .

serialConsoleLogBlobUri

string

Seri konsol günlük blobu Uri'si. Not: Önyükleme tanılaması şu anda yönetilen depolama ile etkinleştirildiyse bu ayar yapılmaz .

status

InstanceViewStatus

VM için önyükleme tanılama durumu bilgileri. Not: Yalnızca önyükleme tanılamasını etkinleştirmede karşılaşılan hatalar varsa ayarlanır.

CloudError

İşlem hizmetinden bir hata yanıtı.

Name Tür Description
error

ApiError

Api hatası.

DiskEncryptionSettings

İşletim Sistemi Diski için şifreleme ayarlarını belirtir.

En düşük api sürümü: 2015-06-15

Name Tür Description
diskEncryptionKey

KeyVaultSecretReference

Key Vault Gizli Anahtarı olan disk şifreleme anahtarının konumunu belirtir.

enabled

boolean

Sanal makinede disk şifrelemesinin etkinleştirilip etkinleştirilmeymeyeceğini belirtir.

keyEncryptionKey

KeyVaultKeyReference

Key Vault anahtar şifreleme anahtarının konumunu belirtir.

DiskInstanceView

Sanal makine disk bilgileri.

Name Tür Description
encryptionSettings

DiskEncryptionSettings[]

İşletim Sistemi Diski için şifreleme ayarlarını belirtir.

En düşük api sürümü: 2015-06-15

name

string

Disk adı.

statuses

InstanceViewStatus[]

Kaynak durumu bilgileri.

HyperVGenerationType

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

Name Tür Description
V1

string

V2

string

InnerError

İç 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

Ö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 de dahil olmak üzere ayrıntılı durum iletisi.

time

string

Durum zamanı.

KeyVaultKeyReference

anahtar şifreleme anahtarının Key Vault konumunu belirtir.

Name Tür Description
keyUrl

string

Key Vault'da anahtar şifreleme anahtarına başvuran URL.

sourceVault

SubResource

Anahtarı içeren Key Vault göreli URL'si.

KeyVaultSecretReference

Key Vault Gizli Anahtarı olan disk şifreleme anahtarının konumunu belirtir.

Name Tür Description
secretUrl

string

Key Vault gizli diziye başvuran URL.

sourceVault

SubResource

Gizli diziyi içeren Key Vault göreli URL'si.

LastPatchInstallationSummary

Sanal makine için en son yükleme işleminin yükleme özeti.

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

Kullanılabilir olan ancak müşteri tarafından belirtilen dışlama listesi tarafından açıkça dışlanan tüm düzeltme eklerinin sayısı eşleşir.

failedPatchCount

integer

Yüklemede başarısız olan düzeltme eklerinin sayısı.

installationActivityId

string

Bu sonucu oluşturan işlemin etkinlik kimliği. CRP ve uzantı günlükleri arasında bağıntı sağlamak için kullanılır.

installedPatchCount

integer

Başarıyla yüklenen düzeltme eklerinin sayısı.

lastModifiedTime

string

İşlemin başladığı UTC zaman damgası.

maintenanceWindowExceeded

boolean

İşlemin hedeflenen tüm eylemlerini tamamlamadan önce süresinin bitip bitmediğini açıklar

notSelectedPatchCount

integer

Kullanılabilir tüm düzeltme eklerinin sayısıdır, ancak bir sınıflandırma veya ekleme listesi girişiyle eşleşmediğinden yüklenmez.

pendingPatchCount

integer

Düzeltme eki yükleme işlemi sırasında yüklenmesi beklenen tüm kullanılabilir düzeltme eklerinin sayısı.

startTime

string

İş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 "Bilinmiyor", "Başarısız", "Başarılı" veya "CompletedWithWarnings" olur.

MaintenanceOperationResultCodeTypes

Son Bakım İşlemi Sonuç Kodu.

Name Tür Description
MaintenanceAborted

string

MaintenanceCompleted

string

None

string

RetryLater

string

MaintenanceRedeployStatus

Sanal makinedeki Bakım İşlemi durumu.

Name Tür Description
isCustomerInitiatedMaintenanceAllowed

boolean

Doğru, müşterinin Bakım gerçekleştirmesine izin veriliyorsa.

lastOperationMessage

string

Son Bakım İşlemi için döndürülen ileti.

lastOperationResultCode

MaintenanceOperationResultCodeTypes

Son Bakım İşlemi Sonuç Kodu.

maintenanceWindowEndTime

string

Bakım Penceresinin Bitiş Saati.

maintenanceWindowStartTime

string

Bakım Penceresi için Başlangıç Saati.

preMaintenanceWindowEndTime

string

Bakım Öncesi Penceresinin Bitiş Saati.

preMaintenanceWindowStartTime

string

Bakım Öncesi Penceresi için Başlangıç Saati.

PatchOperationStatus

İşlemin genel başarı veya başarısızlık durumu. İşlem tamamlanana kadar "InProgress" olarak kalır. Bu noktada "Bilinmiyor", "Başarısız", "Başarılı" veya "CompletedWithWarnings" olur.

Name Tür Description
CompletedWithWarnings

string

Failed

string

InProgress

string

Succeeded

string

Unknown

string

StatusLevelTypes

Düzey kodu.

Name Tür Description
Error

string

Info

string

Warning

string

SubResource

Gizli diziyi içeren Key Vault göreli URL'si.

Name Tür Description
id

string

Kaynak Kimliği

VirtualMachineAgentInstanceView

Sanal makinede çalışan VM Aracısı.

Name Tür Description
extensionHandlers

VirtualMachineExtensionHandlerInstanceView[]

Sanal makine uzantısı işleyici örneği görünümü.

statuses

InstanceViewStatus[]

Kaynak durumu bilgileri.

vmAgentVersion

string

VM Aracısı tam sürümü.

VirtualMachineExtensionHandlerInstanceView

Sanal makine uzantısı işleyici örneği görünümü.

Name Tür Description
status

InstanceViewStatus

Uzantı işleyici durumu.

type

string

Uzantının türünü belirtir; "CustomScriptExtension" örnek olarak verilmiştir.

typeHandlerVersion

string

Betik işleyicisinin sürümünü belirtir.

VirtualMachineExtensionInstanceView

Uzantı bilgileri.

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" örnek olarak verilmiştir.

typeHandlerVersion

string

Betik işleyicisinin sürümünü belirtir.

VirtualMachineHealthStatus

VM'nin sistem durumu.

Name Tür Description
status

InstanceViewStatus

VM'nin sistem durumu bilgileri.

VirtualMachineInstanceView

Sanal makinenin örnek görünümü.

Name Tür Description
assignedHost

string

Sanal makine, otomatik yerleştirmenin etkinleştirildiği ayrılmış bir 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 hiper yöneticiden vm'nin ekran görüntüsünü görmenizi sağlar.

computerName

string

Sanal makineye atanan bilgisayar adı.

disks

DiskInstanceView[]

Sanal makine disk bilgileri.

extensions

VirtualMachineExtensionInstanceView[]

Uzantı bilgileri.

hyperVGeneration

HyperVGenerationType

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

isVMInStandbyPool

boolean

[Önizleme Özelliği] VM'nin Bekleme Havuzu'nda mı 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

Sanal makinenin hata etki alanını belirtir.

platformUpdateDomain

integer

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

[Önizleme Özelliği] 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.