Compreender nomes e IDs de instância para VMs do Conjunto de Escala de Máquina Virtual do Azure

Artigo
08/24/2024

Cada VM em um conjunto de escala recebe um nome e um ID de instância que a identifica exclusivamente. Eles são usados nas APIs do conjunto de escala para fazer operações em uma VM específica no conjunto de escala. Este artigo descreve IDs de instância para conjuntos de escala e as várias maneiras como eles aparecem.

Dimensionar nomes de VM do conjunto

Os Conjuntos de Escala de Máquina Virtual gerarão um nome exclusivo para cada VM no conjunto de escala. Esse nome é usado como parte do identificador de recurso exclusivo para recursos ARM do Azure. O comprimento máximo do nome do recurso de instância é de 64 caracteres. A convenção de nomenclatura difere de acordo com o modo de orquestração:

Nome flexível da instância do modo de orquestração: {scale-set-name}_{8-char-guid}
Nome da instância do modo de orquestração uniforme: {scale-set-name}_{instance-id}

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

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

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

Para conjuntos de escala 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 depois que as instâncias antigas forem excluídas.

Nota

Não há garantia sobre a forma como os IDs de instância são atribuídos às VMs no conjunto de escala. Por vezes, podem parecer sequencialmente crescentes, mas nem sempre é esse o caso. Não dependa da maneira específica como os IDs de instância são atribuídos às VMs.

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

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}

Você também pode especificar um ID de instância específico para recriar a imagem ao usar a API de reimagem. 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 um ID de instância específico para recriar a imagem ao usar a API de reimagem. 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 um ID de instância específico para recriar a imagem ao usar a API de reimagem. 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 de dentro de uma VM de conjunto de escala, verá um "nome" na saída:

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

Nome do computador VM do conjunto de escala

Cada VM em um conjunto de escala também recebe um nome de computador atribuído a ela. Esse nome de computador é o nome de host da VM na resolução de nomes DNS fornecida pelo Azure na rede virtual. A convenção de nomenclatura do nome do computador difere de acordo com o 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 escala que você pode definir, portanto, pode ser diferente do próprio nome do conjunto de escalas. O nome do computador da VM do conjunto de escala também pode ser alterado de dentro do SO 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.

Partilhar via