Grundlegendes zu Instanz-IDs für Azure Virtual Machine Scale Sets-VMs

Jede VM in einer Skalierungsgruppe erhält zur eindeutigen Identifizierung einen Namen und eine Instanz-ID. Diese werden in den Skalierungsgruppen-APIs für Vorgänge auf einer bestimmten VM in der Skalierungsgruppe verwendet. In diesem Artikel werden Instanz-IDs für Skalierungsgruppen und die verschiedenen Arten beschrieben, wie sie in Erscheinung treten.

Namen von Skalierungsgruppen-VMs

Virtual Machine Scale Sets generiert einen eindeutigen Namen für jede VM in der Skalierungsgruppe. Dieser Name wird als Teil des eindeutigen Ressourcenbezeichners für Azure ARM-Ressourcen verwendet. Die maximale Länge des Namens der Instanzressource beträgt 64 Zeichen. Die Benennungskonvention unterscheidet sich je nach Orchestrierungsmodus:

  • Instanzname des Modus „Flexible Orchestrierung“: {scale-set-name}_{8-char-guid}
  • Instanzname des Modus „Einheitliche Orchestrierung“: {scale-set-name}_{instance-id}

Instanz-ID der Skalierungsgruppe für den Modus „Flexible Orchestrierung“

Bei Virtual Machine Scale Sets im Modus „Flexible Orchestrierung“ ist die Instanz-ID einfach der Name der VM.

Instanz-ID der Skalierungsgruppe für den Modus „Einheitliche Orchestrierung“

Bei Skalierungsgruppen im Modus „Einheitliche Orchestrierung“ ist die Instanz-ID eine Dezimalzahl. Die Instanz-ID kann für neue Instanzen wiederverwendet werden, nachdem alte Instanzen gelöscht wurden.

Hinweis

Es gibt keine Garantie darüber, wie die Instanz-IDs den virtuellen Computern in der Skalierungsgruppe zugewiesen werden. Bisweilen scheinen sie fortlaufend anzusteigen, dies ist jedoch nicht immer der Fall. Übernehmen Sie eine Abhängigkeit nicht auf bestimmte Art und Weise, die in der Instanz-IDs an die virtuellen Computer zugewiesen sind.

Sie können die Liste der Instanz-IDs abrufen, indem Sie alle Instanzen in einer Skalierungsgruppe auflisten.

REST-API

Weitere Informationen finden Sie in der REST-API-Dokumentation.

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

Sie können auch eine bestimmte Instanz-ID zum Durchführen eines Reimagings angeben, wenn die Reimaging-API verwendet wird. Weitere Informationen finden Sie in der Dokumentation zur REST-API.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/virtualmachines/{instanceId}/reimage?api-version={apiVersion}

PowerShell

Weitere Informationen finden Sie in der PowerShell-Dokumentation.

Get-AzVmssVM -ResourceGroupName {resourceGroupName} -VMScaleSetName {vmScaleSetName}

Sie können auch eine bestimmte Instanz-ID zum Durchführen eines Reimagings angeben, wenn die Reimaging-API verwendet wird. Weitere Informationen finden Sie in der Dokumentation zu PowerShell.

Set-AzVmssVM -ResourceGroupName {resourceGroupName} -VMScaleSetName {vmScaleSetName} -InstanceId {instanceId} -Reimage

Befehlszeilenschnittstelle (CLI)

Weitere Informationen finden Sie in der Dokumentation zur CLI.

az vmss list-instances -g {resourceGroupName} -n {vmScaleSetName}

Sie können auch eine bestimmte Instanz-ID zum Durchführen eines Reimagings angeben, wenn die Reimaging-API verwendet wird. Weitere Informationen finden Sie in der Dokumentation zur CLI.

az vmss reimage -g {resourceGroupName} -n {vmScaleSetName} --instance-id {instanceId}

Name der Instanzmetadaten eines virtuellen Computers

Wenn Sie Instanzmetadaten direkt auf einem virtuellen Computer in einer Skalierungsgruppe abfragen, wird in der Ausgabe ein „Name“ angezeigt:

{
  "compute": {
    "location": "westus",
    "name": "nsgvmss_85",

Computername der Skalierungsgruppen-VM

Jedem virtuellen Computer in einer Skalierungsgruppe wird außerdem ein Computername zugewiesen. Dieser Computername ist der Hostname des virtuellen Computers in der von Azure bereitgestellten DNS-Namensauflösung innerhalb des virtuellen Netzwerks. Die Benennungskonvention für Computernamen unterscheidet sich je nach Orchestrierungsmodus:

  • Modus „Flexible Orchestrierung“: {Computernamenpräfix}{GUID-mit-6-Zeichen}
  • Modus „Einheitliche Orchestrierung“: {Computernamenpräfix}{Instanz-ID-mit-Basis-36}

Das Computernamenpräfix ist eine Eigenschaft des Skalierungsgruppenmodells, die Sie festlegen können, sodass sie sich vom Skalierungsgruppennamen selbst unterscheidet. Der VM-Computername der Skalierungsgruppe kann auch innerhalb des Gastbetriebssystems geändert werden, nachdem die VM erstellt wurde. Die maximale Länge des Computernamens ist betriebssystemabhängig. Weitere Informationen finden Sie unter Benennungsregeln und Einschränkungen.