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

  • Artigo

Cada VM em um conjunto de dimensionamento obtém um nome e uma ID de instância que a identifica com exclusividade. Eles são usados nas APIs do conjunto de dimensionamento para realizar operações em uma determinada VM no conjunto de dimensionamento. Este artigo descreve as IDs de instância para conjuntos de dimensionamento e as suas várias formas de exibição.

Nomes de VMs do conjunto de dimensionamento

Os Conjuntos de Dimensionamento de Máquinas Virtuais irão 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, a ID da instância é 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, a ID da instância é um número decimal. As IDs de instância poderão ser reutilizadas para novas instâncias quando instâncias antigas forem excluídas.

Observação

Não há nenhuma garantia na forma como as IDs de instância são atribuídas às VMs no conjunto de dimensionamento. Às vezes, pode parecer que elas aumentam sequencialmente, mas esse não é sempre o caso. Não utilize uma dependência de uma forma específica em que as IDs de instância sejam atribuídas às VMs.

Você pode obter a lista de IDs de instância listando todas as instâncias em um conjunto de dimensionamento.

API REST

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

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

Você também pode especificar uma ID de instância específica para refazer a imagem ao usar a API de recriação de imagem. Para obter mais informações, consulte 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, consulte a Documentação do PowerShell.

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

Você também pode especificar uma ID de instância específica para refazer a imagem ao usar a API de recriação de imagem. Para obter mais informações, consulte a Documentação do PowerShell

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

CLI

Para obter mais informações, consulte a Documentação da CLI.

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

Você também pode especificar uma ID de instância específica para refazer a imagem ao usar a API de recriação de imagem. Para obter mais informações, consulte a Documentação da CLI.

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

Nome da VM de Metadados da Instância

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

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

Nome do computador da VM de conjunto de dimensionamento

Cada VM em um conjunto de dimensionamento também tem um nome de computador atribuído a ela. Esse nome de computador é o nome do host da VM na resolução de nome 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 do nome do computador é uma propriedade do modelo do conjunto de dimensionamento que você definir, para que ele possa 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 de dentro do sistema operacional convidado após a criação da VM.