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 |
|---|---|---|---|---|
|
instance
|
path | True |
string |
ID instans komputer virtual. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nama grup sumber daya. Nama tidak sensitif terhadap penggunaan huruf besar atau kecil. |
|
subscription
|
path | True |
string minLength: 1 |
ID langganan target. |
|
vm
|
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 |
Operasi Azure berhasil diselesaikan. |
|
| Other Status Codes |
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.
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 |
|---|---|
|
Api |
Kesalahan api. |
|
Api |
Basis kesalahan api. |
|
Boot |
Tampilan instans diagnostik boot komputer virtual. |
|
Capacity |
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. |
|
Cloud |
Respons kesalahan dari layanan Komputasi. |
|
Disk |
Menjelaskan Pengaturan Enkripsi untuk Disk |
|
Disk |
Tampilan instans disk. |
|
Hyper |
Generasi hypervisor komputer virtual [V1, V2] |
|
Inner |
Detail kesalahan dalam. |
|
Instance |
Status tampilan instans. |
|
Interconnect |
Detail tampilan instans Blok Interkoneksi untuk instans VM Komputer Virtual atau Set Skala. |
|
Key |
Menjelaskan referensi ke Kunci Key Vault |
|
Key |
Menjelaskan referensi ke Rahasia Key Vault |
|
Maintenance |
Kode hasil operasi pemeliharaan terakhir. |
|
Maintenance |
Status Operasi Pemeliharaan. |
|
Status |
Kode tingkat. |
|
Storage |
Menentukan status penyelarasan penyimpanan untuk disk. |
|
Sub |
|
|
Virtual |
Tampilan instans Agen VM yang berjalan di komputer virtual. |
|
Virtual |
Tampilan instans handler ekstensi komputer virtual. |
|
Virtual |
Tampilan instans ekstensi komputer virtual. |
|
Virtual |
Status kesehatan VM. |
|
Virtual |
Tampilan instans VM set skala komputer virtual. |
ApiError
Kesalahan api.
| Nama | Jenis | Deskripsi |
|---|---|---|
| code |
string |
Kode kesalahan. |
| details |
Detail kesalahan Api |
|
| 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 |
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 |
Kesalahan api. |
DiskEncryptionSettings
Menjelaskan Pengaturan Enkripsi untuk Disk
| Nama | Jenis | Deskripsi |
|---|---|---|
| diskEncryptionKey |
Menentukan lokasi kunci enkripsi disk, yang merupakan Rahasia Key Vault. |
|
| enabled |
boolean |
Menentukan apakah enkripsi disk harus diaktifkan pada komputer virtual. |
| keyEncryptionKey |
Menentukan lokasi kunci enkripsi kunci di Key Vault. |
DiskInstanceView
Tampilan instans disk.
| Nama | Jenis | Deskripsi |
|---|---|---|
| encryptionSettings |
Menentukan pengaturan enkripsi untuk Disk OS. |
|
| name |
string |
Nama disk. |
| statuses |
Informasi status sumber daya. |
|
| 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 |
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 |
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 |
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 |
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 |
Tampilan instans penanganan ekstensi komputer virtual. |
|
| statuses |
Informasi status sumber daya. |
|
| vmAgentVersion |
string |
Versi lengkap Agen VM. |
VirtualMachineExtensionHandlerInstanceView
Tampilan instans handler ekstensi komputer virtual.
| Nama | Jenis | Deskripsi |
|---|---|---|
| status |
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 |
Informasi status sumber daya. |
|
| substatuses |
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 |
Informasi status kesehatan untuk VM. |
VirtualMachineScaleSetVMInstanceView
Tampilan instans VM set skala komputer virtual.