Comprendre les noms et les ID d’instance des machines virtuelles des groupes identiques de machines virtuelles Azure

Chaque machine virtuelle d’un groupe identique obtient un nom et un ID d’instance qui l’identifient de façon unique. Ils sont utilisés dans les API de groupes identiques pour effectuer des opérations sur une machine virtuelle particulière du groupe identique. Cet article décrit les identifiants d’instance des groupes identiques de machines virtuelles et les différentes façons dont ils apparaissent.

Noms des machines virtuelles d’un groupe identique

Virtual Machine Scale Sets génère un nom unique pour chaque machine virtuelle du groupe identique. Ce nom fait partie de l’identificateur de ressource unique pour les ressources Azure ARM. La longueur maximale du nom de la ressource d’instance est de 64  caractères (orchestration uniforme) ou de 44 caractères (orchestration flexible). Les conventions d’affectation de noms diffèrent selon le mode d’orchestration :

  • Nom d’instance du mode d’orchestration flexible : {scale-set-name}_{8-char-guid}
  • Nom d’instance du mode d’orchestration uniforme : {scale-set-name}_{instance-id}

ID d’instance du groupe de machines virtuelles identiques pour le mode d’orchestration flexible

Pour Virtual Machine Scale Sets en mode Orchestration flexible, l’ID d’instance est le nom de la machine virtuelle.

ID d’instance du groupe de machines virtuelles identiques pour le mode d’orchestration uniforme

Dans le cas des groupes identiques en mode d’orchestration uniforme, l’ID d’instance est un nombre décimal. Les ID d’instance peuvent être réutilisés pour de nouvelles instances une fois que les anciennes instances sont supprimées.

Note

Il n’existe aucune garantie sur la façon dont les ID d’instance sont attribués aux machines virtuelles du groupe identique. De temps en temps, ils peuvent sembler augmenter séquentiellement, mais ce n’est pas toujours le cas. N’établissez pas de dépendance sur la façon spécifique dont les ID d’instance sont attribués aux machines virtuelles.

Vous pouvez obtenir la liste des identifiants d’instance en listant toutes les instances d’un groupe identique de machines virtuelles.

API REST

Pour plus d’informations, consultez la documentation de l’API REST.

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

Vous avez également la possibilité de spécifier un ID d’instance spécifique pour procéder à une réinitialisation lorsque vous utilisez l’API de réinitialisation. Pour plus d’informations, consultez la documentation de l’API REST.

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

PowerShell

Pour plus d’informations, consultez la documentation PowerShell.

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

Vous avez également la possibilité de spécifier un ID d’instance spécifique pour procéder à une réinitialisation lorsque vous utilisez l’API de réinitialisation. Pour plus d’informations, consultez la documentation de PowerShell.

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

CLI

Pour plus d’informations, consultez la documentation de l’interface CLI.

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

Vous avez également la possibilité de spécifier un ID d’instance spécifique pour procéder à une réinitialisation lorsque vous utilisez l’API de réinitialisation. Pour plus d’informations, consultez la documentation de l’interface CLI.

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

Nom de la machine virtuelle dans les métadonnées de l’instance

Si vous interrogez les métadonnées de l’instance dans une machine virtuelle de groupe identique, vous pouvez observer la propriété « name » dans la sortie :

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

Nom de l’ordinateur de machine virtuelle d’un groupe identique

Chaque VM d’un groupe identique de machines virtuelles se voit également attribuer un nom d’ordinateur. Ce nom d’ordinateur est le nom d’hôte de la machine virtuelle dans la résolution de noms DNS fournie par Azure dans le réseau virtuel. La convention de dénomination de l’ordinateur diffère selon le mode d’orchestration :

  • Mode d’orchestration flexible : {computer-name-prefix}{6-char-guid}
  • Mode d’orchestration uniforme : {computer-name-prefix}{base-36-instance-id}

Le préfixe du nom d’ordinateur est une propriété du modèle de groupe identique que vous pouvez définir. Il peut donc être différent du nom du groupe identique proprement dit. Le nom de l’ordinateur de la machine virtuelle d’un groupe de machines virtuelles identiques peut également être modifié depuis le système d’exploitation invité une fois la machine virtuelle créée. La longueur maximale du nom de l’ordinateur dépend du système d’exploitation. Pour plus d’informations, voir Règles et restrictions de dénomination.

  • Last updated on