Compreender nomes e IDs de instância para VMs do Conjunto de Dimensionamento de Máquinas Virtuais do Azure

Cada VM num conjunto de dimensionamento obtém um nome e um ID de instância que o identificam exclusivamente. Estas são utilizadas nas APIs do conjunto de dimensionamento para realizar operações numa VM específica no conjunto de dimensionamento. Este artigo descreve os IDs de instância para conjuntos de dimensionamento e as várias formas de superação.

Nomes de VMs do conjunto de dimensionamento

Conjuntos de Dimensionamento de Máquinas Virtuais irá gerar um nome exclusivo para cada VM no conjunto de dimensionamento. A convenção de nomenclatura difere pelo modo de orquestração:

• Modo de orquestração flexível: {scale-set-name}_{8-char-guid}
• Modo de orquestração uniforme: {scale-set-name}_{instance-id}

ID da instância do conjunto de dimensionamento para o Modo de Orquestração Flexível

Para Conjuntos de Dimensionamento de Máquinas Virtuais no modo Orquestração Flexível, o ID da instância é simplesmente o nome da máquina virtual.

ID da instância do conjunto de dimensionamento para o Modo de Orquestração Uniforme

Para conjuntos de dimensionamento no modo de orquestração uniforme, o ID da instância é um número decimal. Os IDs de instância podem ser reutilizados para novas instâncias assim que as instâncias antigas forem eliminadas.

Nota

Não há garantias sobre a forma como os IDs de instância são atribuídos às VMs no conjunto de dimensionamento. Podem parecer sequencialmente aumentando às vezes, mas nem sempre é o caso. Não assuma uma dependência da forma específica como os IDs de instância são atribuídos às VMs.

Pode obter a lista de IDs de instância ao listar todas as instâncias num conjunto de dimensionamento.

API REST

Para obter mais informações, veja a Documentação da API REST.

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

Também pode especificar um ID de instância específico para reimagear ao utilizar a API de reimagem. Para obter mais informações, veja a documentação da API REST

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

PowerShell

Para obter mais informações, veja a documentação do PowerShell.

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

Também pode especificar um ID de instância específico para reimagear ao utilizar a API de reimagem. Para obter mais informações, veja a documentação do PowerShell

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

CLI

Para obter mais informações, veja a documentação da CLI.

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

Também pode especificar um ID de instância específico para reimagear ao utilizar a API de reimagem. Para obter mais informações, veja a documentação da CLI.

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

Nome da VM de Metadados de Instância

Se consultar os metadados da instância a partir de uma VM de conjunto de dimensionamento, verá um "nome" na saída:

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

Nome do computador da VM do conjunto de dimensionamento

Cada VM num conjunto de dimensionamento também recebe um nome de computador atribuído ao mesmo. Este nome de computador é o nome do anfitrião da VM na resolução de nomes DNS fornecida pelo Azure na rede virtual. A convenção de nomenclatura do nome do computador difere pelo modo de orquestração:

• Modo de orquestração flexível: {computer-name-prefix}{6-char-guid}
• Modo de orquestração uniforme: {computer-name-prefix}{base-36-instance-id}

O prefixo de nome do computador é uma propriedade do modelo de conjunto de dimensionamento que pode definir, pelo que pode ser diferente do próprio nome do conjunto de dimensionamento. O nome do computador da VM do conjunto de dimensionamento também pode ser alterado a partir do SO convidado assim que a VM tiver sido criada.