Présentation des noms et des ID d’instance des machines virtuelles de groupes de machines virtuelles identiques Azure

  • Article

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 ID d’instance des groupes identiques ainsi que les différents modes de surface.

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. La convention d’affectation de noms diffère selon le mode d’orchestration :

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

ID d’instance de groupe identique pour le mode d’orchestration flexible

Dans le cas des groupes de machines virtuelles identiques en mode d’orchestration flexible, l’ID d’instance correspond simplement au nom de la machine virtuelle.

ID d’instance de groupe identique 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.

Notes

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.

Pour obtenir la liste des ID d’instance, vous pouvez lister toutes les instances d’un groupe identique.

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

Interface de ligne de commande

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 machine virtuelle 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 machine virtuelle d’un groupe identique obtient également un nom d’ordinateur qui lui est attribué. 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 d’affectation de noms 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 la machine virtuelle du groupe identique est également modifiable à l’intérieur du système d’exploitation invité une fois la machine virtuelle créée.