Virtual Machine Scale Set VMs - Get Instance View

Mendapatkan status komputer virtual dari set skala VM.

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

Parameter URI

Nama Dalam Diperlukan Jenis Deskripsi
instanceId
path True

string

ID instans komputer virtual.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil.

subscriptionId
path True

string

minLength: 1

ID langganan target.

vmScaleSetName
path True

string

Nama set skala VM.

api-version
query True

string

minLength: 1

Versi API yang akan digunakan untuk operasi ini.

Respons

Nama Jenis Deskripsi
200 OK

VirtualMachineScaleSetVMInstanceView

Operasi Azure berhasil diselesaikan.

Other Status Codes

CloudError

Respons kesalahan yang tidak terduga.

Keamanan

azure_auth

Alur OAuth2 Azure Active Directory.

Jenis: oauth2
Alur: implicit
URL Otorisasi: https://login.microsoftonline.com/common/oauth2/authorize

Cakupan

Nama Deskripsi
user_impersonation meniru akun pengguna Anda

Contoh

Get instance view of a virtual machine from a VM scale set placed on a dedicated host group through automatic placement.
Get instance view of a virtual machine from a VM scale set that is eligible for and consuming an open capacity reservation.

Get instance view of a virtual machine from a VM scale set placed on a dedicated host group through automatic placement.

Permintaan sampel

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

Respon sampel

{
  "platformUpdateDomain": 0,
  "platformFaultDomain": 0,
  "rdpThumbPrint": null,
  "vmAgent": {
    "vmAgentVersion": "Unknown",
    "statuses": [
      {
        "code": "ProvisioningState/Unavailable",
        "level": "Warning",
        "displayStatus": "Not Ready",
        "message": "VM status blob is found but not yet populated.",
        "time": "2026-04-01T05:00:32+00:00"
      }
    ],
    "extensionHandlers": null
  },
  "disks": [
    {
      "name": "myOSDisk",
      "encryptionSettings": null,
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "message": null,
          "time": "2026-04-01T04:58:58.0882815+00:00"
        }
      ]
    }
  ],
  "extensions": null,
  "assignedHost": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/hostGroups/myHostGroup/hosts/myHost",
  "bootDiagnostics": null,
  "statuses": [
    {
      "code": "ProvisioningState/succeeded",
      "level": "Info",
      "displayStatus": "Provisioning succeeded",
      "message": null,
      "time": "2020-06-05T04:59:58.1852966+00:00"
    },
    {
      "code": "PowerState/running",
      "level": "Info",
      "displayStatus": "VM running",
      "message": null,
      "time": null
    }
  ]
}

Get instance view of a virtual machine from a VM scale set that is eligible for and consuming an open capacity reservation.

Permintaan sampel

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

Respon sampel

{
  "platformUpdateDomain": 0,
  "platformFaultDomain": 0,
  "rdpThumbPrint": null,
  "vmAgent": {
    "vmAgentVersion": "2.7.41491.1010",
    "statuses": [
      {
        "code": "ProvisioningState/succeeded",
        "level": "Info",
        "displayStatus": "Ready",
        "message": "GuestAgent is running and processing the extensions.",
        "time": "2026-04-01T05:00:32+00:00"
      }
    ],
    "extensionHandlers": null
  },
  "disks": [
    {
      "name": "myOSDisk",
      "encryptionSettings": null,
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "message": null,
          "time": "2026-04-01T04:58:58.0882815+00:00"
        }
      ]
    }
  ],
  "extensions": null,
  "bootDiagnostics": null,
  "capacityReservationType": "Open",
  "statuses": [
    {
      "code": "ProvisioningState/succeeded",
      "level": "Info",
      "displayStatus": "Provisioning succeeded",
      "message": null,
      "time": "2026-04-01T04:59:58.1852966+00:00"
    },
    {
      "code": "PowerState/running",
      "level": "Info",
      "displayStatus": "VM running",
      "message": null,
      "time": null
    }
  ]
}

Definisi

Nama Deskripsi
ApiError

Kesalahan api.

ApiErrorBase

Basis kesalahan api.

BootDiagnosticsInstanceView

Tampilan instans diagnostik boot komputer virtual.

CapacityReservationType

Menentukan jenis reservasi kapasitas mana yang akan digunakan mesin virtual jika memenuhi syarat atau apakah secara eksplisit dikeluarkan dari asosiasi dan mengonsumsi kapasitas dari kapasitas cadangan yang tersedia dalam langganan. Versi API minimum: 2026-04-01.

CloudError

Respons kesalahan dari layanan Komputasi.

DiskEncryptionSettings

Menjelaskan Pengaturan Enkripsi untuk Disk

DiskInstanceView

Tampilan instans disk.

HyperVGeneration

Generasi hypervisor komputer virtual [V1, V2]

InnerError

Detail kesalahan dalam.

InstanceViewStatus

Status tampilan instans.

InterconnectInstanceView

Detail tampilan instans Blok Interkoneksi untuk instans VM Komputer Virtual atau Set Skala.

KeyVaultKeyReference

Menjelaskan referensi ke Kunci Key Vault

KeyVaultSecretReference

Menjelaskan referensi ke Rahasia Key Vault

MaintenanceOperationResultCodeTypes

Kode hasil operasi pemeliharaan terakhir.

MaintenanceRedeployStatus

Status Operasi Pemeliharaan.

StatusLevelTypes

Kode tingkat.

StorageAlignmentStatus

Menentukan status penyelarasan penyimpanan untuk disk.

SubResource
VirtualMachineAgentInstanceView

Tampilan instans Agen VM yang berjalan di komputer virtual.

VirtualMachineExtensionHandlerInstanceView

Tampilan instans handler ekstensi komputer virtual.

VirtualMachineExtensionInstanceView

Tampilan instans ekstensi komputer virtual.

VirtualMachineHealthStatus

Status kesehatan VM.

VirtualMachineScaleSetVMInstanceView

Tampilan instans VM set skala komputer virtual.

ApiError

Kesalahan api.

Nama Jenis Deskripsi
code

string

Kode kesalahan.

details

ApiErrorBase[]

Detail kesalahan Api

innererror

InnerError

Kesalahan dalam Api

message

string

Pesan kesalahan.

target

string

Target kesalahan tertentu.

ApiErrorBase

Basis kesalahan api.

Nama Jenis Deskripsi
code

string

Kode kesalahan.

message

string

Pesan kesalahan.

target

string

Target kesalahan tertentu.

BootDiagnosticsInstanceView

Tampilan instans diagnostik boot komputer virtual.

Nama Jenis Deskripsi
consoleScreenshotBlobUri

string

URI blob cuplikan layar konsol. Catatan: Ini akan tidak diatur jika diagnostik boot saat ini diaktifkan dengan penyimpanan terkelola.

serialConsoleLogBlobUri

string

Uri blob log konsol serial. Catatan: Ini akan tidak diatur jika diagnostik boot saat ini diaktifkan dengan penyimpanan terkelola.

status

InstanceViewStatus

Informasi status diagnostik boot untuk VM. Catatan: Ini hanya akan diatur jika ada kesalahan yang terjadi dalam mengaktifkan diagnostik boot.

CapacityReservationType

Menentukan jenis reservasi kapasitas mana yang akan digunakan mesin virtual jika memenuhi syarat atau apakah secara eksplisit dikeluarkan dari asosiasi dan mengonsumsi kapasitas dari kapasitas cadangan yang tersedia dalam langganan. Versi API minimum: 2026-04-01.

Nilai Deskripsi
NotEligible

Mesin virtual tidak memenuhi syarat untuk secara implisit diasosiasikan dengan reservasi kapasitas terbuka dan tidak secara eksplisit terkait dengan grup reservasi kapasitas manapun, sehingga akan mengonsumsi kapasitas dari kapasitas yang tersedia untuk umum.

Targeted

Mesin virtual akan mengonsumsi kapasitas dari reservasi kapasitas yang sesuai tertentu ketika dikaitkan dengan sumber daya grup reservasi kapasitas yang ditargetkan, tetapi dapat kembali menggunakan kapasitas dari kapasitas yang tersedia untuk umum jika tidak ada kapasitas yang tersedia dalam reservasi yang ditargetkan.

Open

Mesin virtual, jika memenuhi syarat, akan secara implisit mengaitkan dan mengonsumsi kapasitas yang tersedia dari reservasi kapasitas terbuka yang cocok yang dibuat atau dibagikan dalam langganan. Catatan: VM tidak boleh secara eksplisit dikaitkan dengan sumber daya grup reservasi kapasitas terbuka yang berisi reservasi yang sesuai.

Disabled

Mesin virtual telah menonaktifkan penugasan reservasi kapasitas dan tidak akan diizinkan untuk secara implisit atau eksplisit mengaitkan dengan jenis reservasi kapasitas apapun.

Block

Mesin virtual mengonsumsi kapasitas dari reservasi kapasitas yang sesuai tertentu ketika dikaitkan dengan sumber daya grup reservasi kapasitas bertipe blok, dan akan mengalami kegagalan kapasitas jika tidak ada kapasitas yang tersedia dalam reservasi blok tersebut.

CloudError

Respons kesalahan dari layanan Komputasi.

Nama Jenis Deskripsi
error

ApiError

Kesalahan api.

DiskEncryptionSettings

Menjelaskan Pengaturan Enkripsi untuk Disk

Nama Jenis Deskripsi
diskEncryptionKey

KeyVaultSecretReference

Menentukan lokasi kunci enkripsi disk, yang merupakan Rahasia Key Vault.

enabled

boolean

Menentukan apakah enkripsi disk harus diaktifkan pada komputer virtual.

keyEncryptionKey

KeyVaultKeyReference

Menentukan lokasi kunci enkripsi kunci di Key Vault.

DiskInstanceView

Tampilan instans disk.

Nama Jenis Deskripsi
encryptionSettings

DiskEncryptionSettings[]

Menentukan pengaturan enkripsi untuk Disk OS.

Versi api minimum: 2015-06-15

name

string

Nama disk.

statuses

InstanceViewStatus[]

Informasi status sumber daya.

storageAlignmentStatus

StorageAlignmentStatus

Menentukan status penyelarasan penyimpanan untuk disk.

HyperVGeneration

Generasi hypervisor komputer virtual [V1, V2]

Nilai Deskripsi
V1
V2

InnerError

Detail kesalahan dalam.

Nama Jenis Deskripsi
errordetail

string

Pesan kesalahan internal atau cadangan pengecualian.

exceptiontype

string

Jenis pengecualian.

InstanceViewStatus

Status tampilan instans.

Nama Jenis Deskripsi
code

string

Kode status.

displayStatus

string

Label pendek yang dapat dilokalkan untuk status tersebut.

level

StatusLevelTypes

Kode tingkat.

message

string

Pesan status terperinci, termasuk untuk pemberitahuan dan pesan kesalahan.

time

string (date-time)

Waktu status.

InterconnectInstanceView

Detail tampilan instans Blok Interkoneksi untuk instans VM Komputer Virtual atau Set Skala.

Nama Jenis Deskripsi
interconnectSubgroupId

string

ID (GUID) subgrup Interkoneksi tempat Komputer Virtual ditempatkan.

KeyVaultKeyReference

Menjelaskan referensi ke Kunci Key Vault

Nama Jenis Deskripsi
keyUrl

string

URL yang mereferensikan kunci enkripsi kunci di Key Vault.

sourceVault

SubResource

URL relatif Key Vault yang berisi kunci.

KeyVaultSecretReference

Menjelaskan referensi ke Rahasia Key Vault

Nama Jenis Deskripsi
secretUrl

string

URL yang mereferensikan rahasia di Key Vault.

sourceVault

SubResource

URL relatif Key Vault yang berisi rahasia.

MaintenanceOperationResultCodeTypes

Kode hasil operasi pemeliharaan terakhir.

Nilai Deskripsi
None
RetryLater
MaintenanceAborted
MaintenanceCompleted

MaintenanceRedeployStatus

Status Operasi Pemeliharaan.

Nama Jenis Deskripsi
isCustomerInitiatedMaintenanceAllowed

boolean

Benar, jika pelanggan diizinkan untuk melakukan Pemeliharaan.

lastOperationMessage

string

Pesan dikembalikan untuk Operasi Pemeliharaan terakhir.

lastOperationResultCode

MaintenanceOperationResultCodeTypes

Kode hasil operasi pemeliharaan terakhir.

maintenanceWindowEndTime

string (date-time)

Waktu berakhir untuk jendela pemeliharaan.

maintenanceWindowStartTime

string (date-time)

Waktu mulai untuk jendela pemeliharaan.

preMaintenanceWindowEndTime

string (date-time)

Waktu akhir untuk jendela pra pemeliharaan.

preMaintenanceWindowStartTime

string (date-time)

Waktu mulai untuk jendela pra pemeliharaan.

StatusLevelTypes

Kode tingkat.

Nilai Deskripsi
Info
Warning
Error

StorageAlignmentStatus

Menentukan status penyelarasan penyimpanan untuk disk.

Nilai Deskripsi
Unaligned

Disk tidak memiliki pemetaan Domain Kesalahan Penyimpanan untuk Menghitung Domain Kesalahan. Kegagalan Domain Kesalahan Penyimpanan tunggal dapat memengaruhi semua VM yang mereferensikan profil disk ini.

Aligned

Disk memiliki Domain Kesalahan Penyimpanan untuk Menghitung Pemetaan Domain Kesalahan. Kegagalan Domain Kesalahan Penyimpanan terkandung dalam VM dalam satu Domain Kesalahan Komputasi.

SubResource

Nama Jenis Deskripsi
id

string

Id Sumber Daya

VirtualMachineAgentInstanceView

Tampilan instans Agen VM yang berjalan di komputer virtual.

Nama Jenis Deskripsi
extensionHandlers

VirtualMachineExtensionHandlerInstanceView[]

Tampilan instans penanganan ekstensi komputer virtual.

statuses

InstanceViewStatus[]

Informasi status sumber daya.

vmAgentVersion

string

Versi lengkap Agen VM.

VirtualMachineExtensionHandlerInstanceView

Tampilan instans handler ekstensi komputer virtual.

Nama Jenis Deskripsi
status

InstanceViewStatus

Status penangan ekstensi.

type

string

Menentukan jenis ekstensi; contohnya adalah "CustomScriptExtension".

typeHandlerVersion

string

Menentukan versi Hotfix Mayor.Minor.Patch.Hotfix dari handler skrip. Platform Azure akan menghadirkan versi Patch.Hotfix terbaru dalam seri Major.Minor.

VirtualMachineExtensionInstanceView

Tampilan instans ekstensi komputer virtual.

Nama Jenis Deskripsi
name

string

Nama ekstensi komputer virtual.

statuses

InstanceViewStatus[]

Informasi status sumber daya.

substatuses

InstanceViewStatus[]

Informasi status sumber daya.

type

string

Menentukan jenis ekstensi; contohnya adalah "CustomScriptExtension".

typeHandlerVersion

string

Menentukan versi Hotfix Mayor.Minor.Patch.Hotfix dari handler skrip. Platform Azure akan menghadirkan versi Patch.Hotfix terbaru dalam seri Major.Minor.

VirtualMachineHealthStatus

Status kesehatan VM.

Nama Jenis Deskripsi
status

InstanceViewStatus

Informasi status kesehatan untuk VM.

VirtualMachineScaleSetVMInstanceView

Tampilan instans VM set skala komputer virtual.

Nama Jenis Deskripsi
assignedHost

string

Id sumber daya host khusus, tempat komputer virtual dialokasikan melalui penempatan otomatis, ketika komputer virtual dikaitkan dengan grup host khusus yang mengaktifkan penempatan otomatis. Versi api minimum: 2020-06-01.

bootDiagnostics

BootDiagnosticsInstanceView

Diagnostik Boot adalah fitur penelusuran kesalahan yang memungkinkan Anda melihat Output Konsol dan Cuplikan Layar untuk mendiagnosis status VM. Anda dapat dengan mudah melihat output log konsol Anda. Azure juga memungkinkan Anda melihat cuplikan layar VM dari hypervisor.

capacityReservationType

CapacityReservationType

Menentukan jenis reservasi kapasitas yang akan digunakan oleh instance VM set skala mesin virtual jika memenuhi syarat atau apakah secara eksplisit di-opt out untuk tidak diasosiasikan dan mengonsumsi kapasitas dari kapasitas cadangan yang tersedia dalam langganan. Versi API minimum: 2026-04-01.

computerName

string

Menentukan nama OS host komputer virtual.

Nama ini tidak dapat diperbarui setelah VM dibuat.

Panjang maksimum (Windows): 15 karakter

Panjang maksimum (Linux): 64 karakter.

Untuk konvensi penamaan dan pembatasan, lihat panduan implementasi layanan infrastruktur Azure .

disks

DiskInstanceView[]

Informasi disk.

extensions

VirtualMachineExtensionInstanceView[]

Informasi ekstensi.

hyperVGeneration

HyperVGeneration

Generasi hypervisor komputer virtual [V1, V2]

interconnectInstanceView

InterconnectInstanceView

Tampilan runtime Interkoneksi dari instans VM Set Skala. Versi api minimum: 2026-03-01.

maintenanceRedeployStatus

MaintenanceRedeployStatus

Status Operasi Pemeliharaan pada komputer virtual.

osName

string

Sistem Operasi yang berjalan pada komputer hibrid.

osVersion

string

Versi Sistem Operasi yang berjalan pada komputer hibrid.

placementGroupId

string

Grup penempatan tempat VM berjalan. Jika VM dibatalkan alokasinya, VM tidak akan memiliki placementGroupId.

platformFaultDomain

integer (int32)

Jumlah Domain Kesalahan.

platformUpdateDomain

integer (int32)

Jumlah Perbarui Domain.

rdpThumbPrint

string

Thumbprint sertifikat desktop jarak jauh.

statuses

InstanceViewStatus[]

Informasi status sumber daya.

vmAgent

VirtualMachineAgentInstanceView

Agen VM yang berjalan pada komputer virtual.

vmHealth

VirtualMachineHealthStatus

Status kesehatan untuk VM.