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

Cada VM em um conjunto de dimensionamento recebe um nome e uma ID da instância que a identifica de forma exclusiva. 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 das instâncias em conjuntos de dimensionamento e as várias formas como elas são apresentadas.

Nomes das VMs do conjunto de escala

Os Conjuntos de Dimensionamento de Máquinas Virtuais irão gerar um nome exclusivo para cada VM no conjunto de dimensionamento. Esse nome é usado como parte do identificador de recurso exclusivo para recursos do ARM do Azure. O comprimento máximo do nome do recurso da instância é de 64 caracteres (Orquestração Uniforme) ou 44 caracteres (Orquestração Flexível). As convenções de nomenclatura diferem de acordo com o modo de orquestração:

  • Nome da instância do modo de orquestração flexível: {scale-set-name}_{8-char-guid}
  • Nome da instância do 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 de instância do conjunto de dimensionamento para o modo de orquestração uniforme

Para conjuntos de dimensionamento no modo de orquestração uniforme, o identificador 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 crie uma dependência da maneira específica como os identificadores de instância são atribuídos às VMs.

Você pode obter a lista de IDs das instâncias ao listar 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ê pode definir, portanto 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 de dentro do sistema operacional convidado depois que a VM for criada. O comprimento máximo do nome do computador depende do sistema operacional. Para obter mais informações, consulte Regras e restrições de nomenclatura..

  • Last updated on