Virtual Machine Instances - Get

Referenz

Dienst:: Azure Arc enabled SCVMM

API-Version:: 2024-06-01

Ruft einen virtuellen Computer ab.
Ruft Informationen zu einer Instanz eines virtuellen Computers ab.

GET https://management.azure.com/{resourceUri}/providers/Microsoft.ScVmm/virtualMachineInstances/default?api-version=2024-06-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceUri	path	True	string	Der vollqualifizierte Azure Resource Manager-Bezeichner der Ressource.
api-version	query	True	string	Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	VirtualMachineInstance	Der Azure-Vorgang wurde erfolgreich abgeschlossen.
Other Status Codes	ErrorResponse	Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

VirtualMachineInstances_Get_MaximumSet

VirtualMachineInstances_Get_MinimumSet

VirtualMachineInstances_Get_MaximumSet

Beispielanforderung

HTTP

GET https://management.azure.com/gtgclehcbsyave/providers/Microsoft.ScVmm/virtualMachineInstances/default?api-version=2024-06-01

Beispiel für eine Antwort

Statuscode:: 200

{
  "properties": {
    "availabilitySets": [
      {
        "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/availabilitySets/availabilitySetResourceName",
        "name": "lwbhaseo"
      }
    ],
    "osProfile": {
      "computerName": "uuxpcxuxcufllc",
      "osType": "Windows",
      "osSku": "cxqnjxgkts",
      "osVersion": "djt",
      "domainName": "vblzsoqxzlrygdulnefexjdezo",
      "domainUsername": "sn",
      "workgroup": "bsqftibgcnnjpvmuxligk",
      "timezone": 4,
      "runOnceCommands": "byxpnluptiwxycbbybsf;qwerty"
    },
    "hardwareProfile": {
      "memoryMB": 5,
      "cpuCount": 22,
      "limitCpuForMigration": "true",
      "dynamicMemoryEnabled": "true",
      "dynamicMemoryMaxMB": 2,
      "dynamicMemoryMinMB": 30,
      "isHighlyAvailable": "true"
    },
    "networkProfile": {
      "networkInterfaces": [
        {
          "name": "kvofzqulbjlbtt",
          "displayName": "yoayfd",
          "ipv4Addresses": [
            "eeunirpkpqazzxhsqonkxcfuks"
          ],
          "ipv6Addresses": [
            "pk"
          ],
          "macAddress": "oaeqqegt",
          "virtualNetworkId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualNetworks/virtualNetworkName",
          "networkName": "lqbm",
          "ipv4AddressType": "Dynamic",
          "ipv6AddressType": "Dynamic",
          "macAddressType": "Dynamic",
          "nicId": "roxpsvlo"
        }
      ]
    },
    "storageProfile": {
      "disks": [
        {
          "name": "fgnckfymwdsqnfxkdvexuaobe",
          "displayName": "fgladknawlgjodo",
          "diskId": "ltdrwcfjklpsimhzqyh",
          "diskSizeGB": 30,
          "maxDiskSizeGB": 18,
          "bus": 8,
          "lun": 10,
          "busType": "zu",
          "vhdType": "cnbeeeylrvopigdynvgpkfp",
          "volumeType": "ckkymkuekzzqhexyjueruzlfemoeln",
          "vhdFormatType": "vbcrrmhgahznifudvhxfagwoplcb",
          "templateDiskId": "lcdwrokpyvekqccclf",
          "storageQoSPolicy": {
            "name": "ceiyfrflu",
            "id": "o"
          },
          "createDiffDisk": "true"
        }
      ]
    },
    "infrastructureProfile": {
      "inventoryItemId": "ihkkqmg",
      "vmmServerId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/vmmServers/vmmServerName",
      "cloudId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/clouds/cloudResourceName",
      "templateId": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualMachineTemplates/virtualMachineTemplateName",
      "vmName": "qovpayfydhcvfrhe",
      "uuid": "hrpw",
      "lastRestoredVMCheckpoint": {
        "parentCheckpointID": "hqhhzikoxunuqguouw",
        "checkpointID": "wsqmrje",
        "name": "keqn",
        "description": "qurzfrgyflrh"
      },
      "checkpoints": [
        {
          "parentCheckpointID": "hqhhzikoxunuqguouw",
          "checkpointID": "wsqmrje",
          "name": "keqn",
          "description": "qurzfrgyflrh"
        }
      ],
      "checkpointType": "jkbpzjxpeegackhsvikrnlnwqz",
      "generation": 28,
      "biosGuid": "xixivxifyql"
    },
    "powerState": "dbqyxewvrbqcifpwfvxyllwyaffmvm",
    "provisioningState": "Succeeded"
  },
  "extendedLocation": {
    "type": "customLocation",
    "name": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ExtendedLocation/customLocations/customLocationName"
  },
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualMachineInstances/default",
  "name": "uuqpsdoiyvedvqtrwop",
  "type": "zculorteltpvthtzgnpgdpoe",
  "systemData": {
    "createdBy": "p",
    "createdByType": "User",
    "createdAt": "2024-01-29T22:28:00.094Z",
    "lastModifiedBy": "goxcwpyyqlxndquly",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2024-01-29T22:28:00.095Z"
  }
}

VirtualMachineInstances_Get_MinimumSet

Beispielanforderung

HTTP

GET https://management.azure.com/gtgclehcbsyave/providers/Microsoft.ScVmm/virtualMachineInstances/default?api-version=2024-06-01

Beispiel für eine Antwort

Statuscode:: 200

{
  "id": "/subscriptions/12345678-1234-1234-1234-12345678abc/resourceGroups/exampleResourceGroup/providers/Microsoft.ScVmm/virtualMachineInstances/default",
  "extendedLocation": {}
}

Definitionen

Name	Beschreibung
AllocationMethod	Methode für die Netzwerkadressenzuweisung.
AvailabilitySetListItem	Verfügbarkeitssatzmodell
Checkpoint	Definiert die Ressourceneigenschaften.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
CreateDiffDisk	Erstellen Sie diff disk.
DynamicMemoryEnabled	Dynamischer Speicher aktiviert.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
ExtendedLocation	Der erweiterte Speicherort.
HardwareProfile	Definiert die Ressourceneigenschaften.
InfrastructureProfile	Gibt die spezifischen vmmServer-Infrastruktureinstellungen für die Instanz des virtuellen Computers an.
IsHighlyAvailable	Hoch verfügbar.
LimitCpuForMigration	Beschränken Sie die CPU für die Migration.
NetworkInterface	Netzwerkschnittstellenmodell
NetworkProfile	Definiert die Ressourceneigenschaften.
OsProfileForVmInstance	Definiert die Ressourceneigenschaften.
OsType	Betriebssystemtyp des virtuellen Computers.
ProvisioningState	Der Bereitstellungsstatus der Ressource.
StorageProfile	Definiert die Ressourceneigenschaften.
StorageQosPolicyDetails	Die StorageQoSPolicyDetails-Definition.
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
VirtualDisk	Modell für virtuelle Datenträger
VirtualMachineInstance	Definieren Sie die virtualMachineInstance.

AllocationMethod

Methode für die Netzwerkadressenzuweisung.

Name	Typ	Beschreibung
Dynamic	string	Dynamisch zugewiesene Adresse.
Static	string	Statisch zugewiesene Adresse.

AvailabilitySetListItem

Verfügbarkeitssatzmodell

Name	Typ	Beschreibung
id	string	Ruft die ARM-ID der Ressource "microsoft.scvmm/availabilitySets" ab.
name	string	Dient zum Abrufen oder Festlegen des Namens des Verfügbarkeitssatzes.

Checkpoint

Definiert die Ressourceneigenschaften.

Name	Typ	Beschreibung
checkpointID	string	Ruft die ID des Prüfpunkts ab.
description	string	Ruft eine Beschreibung des Prüfpunkts ab.
name	string	Ruft den Namen des Prüfpunkts ab.
parentCheckpointID	string	Ruft die ID des übergeordneten Elements des Prüfpunkts ab.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name	Typ	Beschreibung
Application	string
Key	string
ManagedIdentity	string
User	string

CreateDiffDisk

Erstellen Sie diff disk.

Name	Typ	Beschreibung
false	string	Deaktivieren Sie den Diff-Datenträger erstellen.
true	string	Aktivieren Sie "Diff Disk erstellen".

DynamicMemoryEnabled

Dynamischer Speicher aktiviert.

Name	Typ	Beschreibung
false	string	Deaktivieren Sie den dynamischen Speicher.
true	string	Aktivieren Sie dynamischen Arbeitsspeicher.

ErrorAdditionalInfo

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

ErrorDetail

Das Fehlerdetails.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	ErrorDetail[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorResponse

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

ExtendedLocation

Der erweiterte Speicherort.

Name	Typ	Beschreibung
name	string	Der Name des erweiterten Speicherorts.
type	string	Der erweiterte Standorttyp.

HardwareProfile

Definiert die Ressourceneigenschaften.

Name	Typ	Beschreibung
cpuCount	integer	Ruft die Anzahl der vCPUs für den virtuellen Computer ab oder legt sie fest.
dynamicMemoryEnabled	DynamicMemoryEnabled	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob dynamischer Speicher aktiviert werden soll oder nicht.
dynamicMemoryMaxMB	integer	Dient zum Abrufen oder Festlegen des maximalen dynamischen Speichers für den virtuellen Computer.
dynamicMemoryMinMB	integer	Ruft den min. dynamischen Arbeitsspeicher für den virtuellen Computer ab oder legt sie fest.
isHighlyAvailable	IsHighlyAvailable	Ruft hoch verfügbare Eigenschaft ab.
limitCpuForMigration	LimitCpuForMigration	Dient zum Abrufen oder Festlegen eines Werts, der angibt, ob der Prozessorkompatibilitätsmodus für die Livemigration von VMs aktiviert werden soll.
memoryMB	integer	MemoryMB ist die Größe des Arbeitsspeichers eines virtuellen Computers in MB.

InfrastructureProfile

Gibt die spezifischen vmmServer-Infrastruktureinstellungen für die Instanz des virtuellen Computers an.

Name	Typ	Beschreibung
biosGuid	string	Ruft die BIOS-GUID für den virtuellen Computer ab oder legt sie fest.
checkpointType	string	Typ des Prüfpunkts, der für den virtuellen Computer unterstützt wird.
checkpoints	Checkpoint[]	Prüfpunkte auf dem virtuellen Computer.
cloudId	string	ARM-ID der Cloudressource, die für die Bereitstellung des virtuellen Computers verwendet werden soll.
generation	integer	Ruft die Generierung für den virtuellen Computer ab oder legt sie fest.
inventoryItemId	string	Dient zum Abrufen oder Festlegen der Bestandselement-ID für die Ressource.
lastRestoredVMCheckpoint	Checkpoint	Zuletzt wiederhergestellter Prüfpunkt auf dem virtuellen Computer.
templateId	string	ARM-ID der Vorlagenressource, die für die Bereitstellung des virtuellen Computers verwendet werden soll.
uuid	string	Eindeutige ID des virtuellen Computers.
vmName	string	VMName ist der Name des virtuellen Computers auf dem SCVmm-Server.
vmmServerId	string	ARM-ID der vmmServer-Ressource, in der sich diese Ressource befindet.

IsHighlyAvailable

Hoch verfügbar.

Name	Typ	Beschreibung
false	string	Deaktivieren Sie hochverwendbar.
true	string	Aktivieren Sie hochverwendbar.

LimitCpuForMigration

Beschränken Sie die CPU für die Migration.

Name	Typ	Beschreibung
false	string	Deaktivieren Sie die CPU-Grenze für die Migration.
true	string	Aktivieren Sie die CPU-Grenze für die Migration.

NetworkInterface

Netzwerkschnittstellenmodell

Name	Typ	Beschreibung
displayName	string	Ruft den Anzeigenamen der Netzwerkschnittstelle ab, wie im vmmServer dargestellt. Dies ist die Fallbackbezeichnung für eine NIC, wenn der Name nicht festgelegt ist.
ipv4AddressType	AllocationMethod	Dient zum Abrufen oder Festlegen des ipv4-Adresstyps.
ipv4Addresses	string[]	Ruft die nic ipv4-Adressen ab.
ipv6AddressType	AllocationMethod	Dient zum Abrufen oder Festlegen des ipv6-Adresstyps.
ipv6Addresses	string[]	Ruft die nic ipv6-Adressen ab.
macAddress	string	Ruft die nic MAC-Adresse ab oder legt sie fest.
macAddressType	AllocationMethod	Dient zum Abrufen oder Festlegen des Mac-Adresstyps.
name	string	Dient zum Abrufen oder Festlegen des Namens der Netzwerkschnittstelle.
networkName	string	Ruft den Namen des virtuellen Netzwerks in vmmServer ab, mit dem der nic verbunden ist.
nicId	string	Ruft die nic-ID ab oder legt sie fest.
virtualNetworkId	string	Ruft die ARM-ID der Microsoft.ScVmm/virtualNetwork-Ressource ab, um die nic zu verbinden, oder legt sie fest.

NetworkProfile

Definiert die Ressourceneigenschaften.

Name	Typ	Beschreibung
networkInterfaces	NetworkInterface[]	Dient zum Abrufen oder Festlegen der Liste der Netzwerkschnittstellen, die dem virtuellen Computer zugeordnet sind.

OsProfileForVmInstance

Definiert die Ressourceneigenschaften.

Name	Typ	Beschreibung
adminPassword	string	Administratorkennwort des virtuellen Computers.
computerName	string	Ruft den Computernamen ab oder legt den Namen fest.
domainName	string	Dient zum Abrufen oder Festlegen des Domänennamens.
domainPassword	string	Kennwort der Domäne, der die VM beitreten muss.
domainUsername	string	Dient zum Abrufen oder Festlegen des Domänenbenutzernamens.
osSku	string	Ruft os sku ab.
osType	OsType	Ruft den Typ des Betriebssystems ab.
osVersion	string	Ruft die Betriebssystemversion ab.
productKey	string	Ruft den Product Key ab oder legt den Product Key fest. Eingabeformat xxxxx-xxxxx-xxxxx-xxxxx-xxxxx-xxxxx
runOnceCommands	string	Dient zum Abrufen oder Festlegen der Befehle, die zum Zeitpunkt der Erstellung durch Semikolons getrennt werden sollen.
timezone	integer	Dient zum Abrufen oder Festlegen des Indexwerts der Zeitzone.
workgroup	string	Ruft die Arbeitsgruppe ab oder legt sie fest.

OsType

Betriebssystemtyp des virtuellen Computers.

Name	Typ	Beschreibung
Linux	string	Linux-Betriebssystem.
Other	string	Anderes Betriebssystem.
Windows	string	Windows-Betriebssystem.

ProvisioningState

Der Bereitstellungsstatus der Ressource.

Name	Typ	Beschreibung
Accepted	string	Die Ressource wurde akzeptiert.
Canceled	string	Die Ressourcenerstellung wurde abgebrochen.
Created	string	Die Ressource wurde erstellt.
Deleting	string	Die Ressource wird gelöscht.
Failed	string	Fehler bei der Ressourcenerstellung.
Provisioning	string	Die Ressource wird bereitgestellt.
Succeeded	string	Ressource wurde erstellt.
Updating	string	Die Ressource wird aktualisiert.

StorageProfile

Definiert die Ressourceneigenschaften.

Name	Typ	Beschreibung
disks	VirtualDisk[]	Ruft die Liste der virtuellen Datenträger ab, die dem virtuellen Computer zugeordnet sind, oder legt diese fest.

StorageQosPolicyDetails

Die StorageQoSPolicyDetails-Definition.

Name	Typ	Beschreibung
id	string	Die ID der QoS-Richtlinie.
name	string	Der Name der Richtlinie.

systemData

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.

VirtualDisk

Modell für virtuelle Datenträger

Name	Typ	Beschreibung
bus	integer	Ruft den Datenträgerbus ab oder legt den Datenträgerbus fest.
busType	string	Dient zum Abrufen oder Festlegen des Datenträgerbustyps.
createDiffDisk	CreateDiffDisk	Dient zum Abrufen oder Festlegen eines Werts, der den Diff Disk angibt.
diskId	string	Ruft die Datenträger-ID ab oder legt sie fest.
diskSizeGB	integer	Ruft die Gesamtgröße des Datenträgers ab oder legt diese fest.
displayName	string	Ruft den Anzeigenamen des virtuellen Datenträgers ab, wie im vmmServer dargestellt. Dies ist die Fallbackbezeichnung für einen Datenträger, wenn der Name nicht festgelegt ist.
lun	integer	Ruft die Datenträger-Lun ab oder legt sie fest.
maxDiskSizeGB	integer	Ruft die maximale Datenträgergröße ab.
name	string	Ruft den Namen des Datenträgers ab oder legt den Namen fest.
storageQoSPolicy	StorageQosPolicyDetails	Die QoS-Richtlinie für den Datenträger.
templateDiskId	string	Ruft die Datenträger-ID in der Vorlage ab oder legt sie fest.
vhdFormatType	string	Ruft den Datenträger vhd-Formattyp ab.
vhdType	string	Dient zum Abrufen oder Festlegen des Datenträger-vhd-Typs.
volumeType	string	Ruft den Datenträgervolumetyp ab.

VirtualMachineInstance

Definieren Sie die virtualMachineInstance.

Name	Typ	Beschreibung
extendedLocation	ExtendedLocation	Dient zum Abrufen oder Festlegen des erweiterten Speicherorts.
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Z. B. "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Der Name der Ressource
properties.availabilitySets	AvailabilitySetListItem[]	Verfügbarkeitssätze in vm.
properties.hardwareProfile	HardwareProfile	Hardwareeigenschaften.
properties.infrastructureProfile	InfrastructureProfile	Ruft das Infrastrukturprofil ab.
properties.networkProfile	NetworkProfile	Netzwerkeigenschaften.
properties.osProfile	OsProfileForVmInstance	Betriebssystemeigenschaften.
properties.powerState	string	Ruft den Energiestatus des virtuellen Computers ab.
properties.provisioningState	ProvisioningState	Bereitstellungsstatus der Ressource.
properties.storageProfile	StorageProfile	Speichereigenschaften.
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

Freigeben über

Virtual Machine Instances - Get

URI-Parameter

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

VirtualMachineInstances_Get_MaximumSet

Beispielanforderung

Beispiel für eine Antwort

VirtualMachineInstances_Get_MinimumSet

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AllocationMethod

AvailabilitySetListItem

Checkpoint

createdByType

CreateDiffDisk

DynamicMemoryEnabled

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ExtendedLocation

HardwareProfile

InfrastructureProfile

IsHighlyAvailable

LimitCpuForMigration

NetworkInterface

NetworkProfile

OsProfileForVmInstance

OsType

ProvisioningState

StorageProfile

StorageQosPolicyDetails

systemData

VirtualDisk

VirtualMachineInstance

Zusätzliche Ressourcen