Virtual Machine Scale Set VMs - Get Instance View

Pobiera stan maszyny wirtualnej z zestawu skalowania maszyn wirtualnych.

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

Parametry identyfikatora URI

Name In Required Type Description
instanceId
path True
  • string

Identyfikator wystąpienia maszyny wirtualnej.

resourceGroupName
path True
  • string

Nazwa grupy zasobów.

subscriptionId
path True
  • string

Poświadczenia subskrypcji, które jednoznacznie identyfikują Microsoft Azure subskrypcji. Identyfikator subskrypcji stanowi część identyfikatora URI dla każdego wywołania usługi.

vmScaleSetName
path True
  • string

Nazwa zestawu skalowania maszyn wirtualnych.

api-version
query True
  • string

Wersja interfejsu API klienta.

Odpowiedzi

Name Type Description
200 OK

OK

Other Status Codes

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation personifikacja konta użytkownika

Przykłady

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

Sample Request

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

Sample Response

{
  "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": "2022-08-01T05:00:32+00:00"
      }
    ],
    "extensionHandlers": null
  },
  "disks": [
    {
      "name": "myOSDisk",
      "encryptionSettings": null,
      "statuses": [
        {
          "code": "ProvisioningState/succeeded",
          "level": "Info",
          "displayStatus": "Provisioning succeeded",
          "message": null,
          "time": "2022-08-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
    }
  ]
}

Definicje

ApiError

Błąd interfejsu API.

ApiErrorBase

Baza błędów interfejsu API.

BootDiagnosticsInstanceView

Widok wystąpienia diagnostyki rozruchu maszyny wirtualnej.

CloudError

Odpowiedź o błędzie z usługi Compute.

DiskEncryptionSettings

Opisuje Ustawienia szyfrowania dla dysku

DiskInstanceView

Widok wystąpienia dysku.

InnerError

Szczegóły błędu wewnętrznego.

InstanceViewStatus

Stan widoku wystąpienia.

KeyVaultKeyReference

Opisuje odwołanie do klucza Key Vault

KeyVaultSecretReference

Opisuje odwołanie do wpisu tajnego Key Vault

MaintenanceOperationResultCodeTypes

Kod wyniku ostatniej operacji konserwacji.

MaintenanceRedeployStatus

Stan operacji konserwacji.

StatusLevelTypes

Kod poziomu.

SubResource
VirtualMachineAgentInstanceView

Widok wystąpienia agenta maszyny wirtualnej uruchomionego na maszynie wirtualnej.

VirtualMachineExtensionHandlerInstanceView

Widok wystąpienia programu obsługi rozszerzenia maszyny wirtualnej.

VirtualMachineExtensionInstanceView

Widok wystąpienia rozszerzenia maszyny wirtualnej.

VirtualMachineHealthStatus

Stan kondycji maszyny wirtualnej.

VirtualMachineScaleSetVMInstanceView

Widok wystąpienia maszyny wirtualnej zestawu skalowania maszyn wirtualnych.

ApiError

Błąd interfejsu API.

Name Type Description
code
  • string

Kod błędu.

details

Szczegóły błędu interfejsu API

innererror

Wewnętrzny błąd interfejsu API

message
  • string

Komunikat o błędzie.

target
  • string

Element docelowy określonego błędu.

ApiErrorBase

Baza błędów interfejsu API.

Name Type Description
code
  • string

Kod błędu.

message
  • string

Komunikat o błędzie.

target
  • string

Element docelowy określonego błędu.

BootDiagnosticsInstanceView

Widok wystąpienia diagnostyki rozruchu maszyny wirtualnej.

Name Type Description
consoleScreenshotBlobUri
  • string

Identyfikator URI zrzutu ekranu konsoli obiektu blob.

UWAGA: Nie zostanie ona ustawiona, jeśli diagnostyka rozruchu jest obecnie włączona z magazynem zarządzanym.

serialConsoleLogBlobUri
  • string

Identyfikator URI dziennika konsoli szeregowej obiektu blob.

UWAGA: Nie zostanie ona ustawiona, jeśli diagnostyka rozruchu jest obecnie włączona z magazynem zarządzanym.

status

Informacje o stanie diagnostyki rozruchu maszyny wirtualnej.

UWAGA: Zostanie ona ustawiona tylko wtedy, gdy wystąpią błędy podczas włączania diagnostyki rozruchu.

CloudError

Odpowiedź o błędzie z usługi Compute.

Name Type Description
error

Błąd interfejsu API.

DiskEncryptionSettings

Opisuje Ustawienia szyfrowania dla dysku

Name Type Description
diskEncryptionKey

Określa lokalizację klucza szyfrowania dysku, który jest kluczem tajnym Key Vault.

enabled
  • boolean

Określa, czy szyfrowanie dysków powinno być włączone na maszynie wirtualnej.

keyEncryptionKey

Określa lokalizację klucza szyfrowania klucza w Key Vault.

DiskInstanceView

Widok wystąpienia dysku.

Name Type Description
encryptionSettings

Określa ustawienia szyfrowania dysku systemu operacyjnego.

Minimalna wersja interfejsu API: 2015-06-15

name
  • string

Nazwa dysku.

statuses

Informacje o stanie zasobu.

InnerError

Szczegóły błędu wewnętrznego.

Name Type Description
errordetail
  • string

Wewnętrzny komunikat o błędzie lub zrzut wyjątku.

exceptiontype
  • string

Typ wyjątku.

InstanceViewStatus

Stan widoku wystąpienia.

Name Type Description
code
  • string

Kod stanu.

displayStatus
  • string

Krótka etykieta lokalizowalna dla stanu.

level

Kod poziomu.

message
  • string

Szczegółowy komunikat o stanie, w tym alerty i komunikaty o błędach.

time
  • string

Czas stanu.

KeyVaultKeyReference

Opisuje odwołanie do klucza Key Vault

Name Type Description
keyUrl
  • string

Adres URL odwołującego się do klucza szyfrowania kluczy w Key Vault.

sourceVault

Względny adres URL Key Vault zawierający klucz.

KeyVaultSecretReference

Opisuje odwołanie do wpisu tajnego Key Vault

Name Type Description
secretUrl
  • string

Adres URL odwołujące się do wpisu tajnego w Key Vault.

sourceVault

Względny adres URL Key Vault zawierający wpis tajny.

MaintenanceOperationResultCodeTypes

Kod wyniku ostatniej operacji konserwacji.

Name Type Description
MaintenanceAborted
  • string
MaintenanceCompleted
  • string
None
  • string
RetryLater
  • string

MaintenanceRedeployStatus

Stan operacji konserwacji.

Name Type Description
isCustomerInitiatedMaintenanceAllowed
  • boolean

Prawda, jeśli klient może wykonać konserwację.

lastOperationMessage
  • string

Komunikat zwrócony dla ostatniej operacji konserwacji.

lastOperationResultCode

Kod wyniku ostatniej operacji konserwacji.

maintenanceWindowEndTime
  • string

Godzina zakończenia okna obsługi.

maintenanceWindowStartTime
  • string

Godzina rozpoczęcia okna obsługi.

preMaintenanceWindowEndTime
  • string

Godzina zakończenia okna przed konserwacją.

preMaintenanceWindowStartTime
  • string

Godzina rozpoczęcia okna przed konserwacją.

StatusLevelTypes

Kod poziomu.

Name Type Description
Error
  • string
Info
  • string
Warning
  • string

SubResource

Name Type Description
id
  • string

Identyfikator zasobu

VirtualMachineAgentInstanceView

Widok wystąpienia agenta maszyny wirtualnej uruchomionego na maszynie wirtualnej.

Name Type Description
extensionHandlers

Widok wystąpienia programu obsługi rozszerzenia maszyny wirtualnej.

statuses

Informacje o stanie zasobu.

vmAgentVersion
  • string

Pełna wersja agenta maszyny wirtualnej.

VirtualMachineExtensionHandlerInstanceView

Widok wystąpienia programu obsługi rozszerzenia maszyny wirtualnej.

Name Type Description
status

Stan procedury obsługi rozszerzeń.

type
  • string

Określa typ rozszerzenia; przykładem jest "CustomScriptExtension".

typeHandlerVersion
  • string

Określa wersję programu obsługi skryptów.

VirtualMachineExtensionInstanceView

Widok wystąpienia rozszerzenia maszyny wirtualnej.

Name Type Description
name
  • string

Nazwa rozszerzenia maszyny wirtualnej.

statuses

Informacje o stanie zasobu.

substatuses

Informacje o stanie zasobu.

type
  • string

Określa typ rozszerzenia; przykładem jest "CustomScriptExtension".

typeHandlerVersion
  • string

Określa wersję programu obsługi skryptów.

VirtualMachineHealthStatus

Stan kondycji maszyny wirtualnej.

Name Type Description
status

Informacje o stanie kondycji maszyny wirtualnej.

VirtualMachineScaleSetVMInstanceView

Widok wystąpienia maszyny wirtualnej zestawu skalowania maszyn wirtualnych.

Name Type Description
assignedHost
  • string

Identyfikator zasobu dedykowanego hosta, na którym maszyna wirtualna jest przydzielana przez automatyczne umieszczanie, gdy maszyna wirtualna jest skojarzona z dedykowaną grupą hostów z włączoną automatyczną umieszczaniem.

Minimalna wersja interfejsu API: 2020-06-01.

bootDiagnostics

Diagnostyka rozruchu to funkcja debugowania, która umożliwia wyświetlenie danych wyjściowych konsoli i zrzutu ekranu w celu zdiagnozowania stanu maszyny wirtualnej.

Możesz łatwo wyświetlić dane wyjściowe dziennika konsoli.

Platforma Azure umożliwia również wyświetlanie zrzutu ekranu maszyny wirtualnej z funkcji hypervisor.

disks

Informacje o dyskach.

extensions

Informacje o rozszerzeniach.

maintenanceRedeployStatus

Stan operacja konserwacji na maszynie wirtualnej.

placementGroupId
  • string

Grupa umieszczania, w której jest uruchomiona maszyna wirtualna. Jeśli maszyna wirtualna zostanie cofnięto przydział, nie będzie miała identyfikatora placementGroupId.

platformFaultDomain
  • integer

Liczba domen błędów.

platformUpdateDomain
  • integer

Liczba aktualizacji domeny.

rdpThumbPrint
  • string

Odcisk palca certyfikatu pulpitu zdalnego.

statuses

Informacje o stanie zasobu.

vmAgent

Agent maszyny wirtualnej uruchomiony na maszynie wirtualnej.

vmHealth

Stan kondycji maszyny wirtualnej.