Partilhar via


Virtual Machine Scale Set VMs - Reimage

Recria imagens (atualiza o sistema operacional) de uma máquina virtual específica em um conjunto de escala de VM.

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

Parâmetros URI

Nome Em Necessário Tipo Descrição
instanceId
path True

string

O ID da instância da máquina virtual.

resourceGroupName
path True

string

minLength: 1
maxLength: 90

O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.

subscriptionId
path True

string

minLength: 1

A ID da assinatura de destino.

vmScaleSetName
path True

string

O nome do conjunto de escala de VM.

api-version
query True

string

minLength: 1

A versão da API a utilizar para esta operação.

Órgão do Pedido

Nome Tipo Descrição
exactVersion

string

Especifica em número decimal, a versão para a qual o disco do sistema operacional deve ser recriado. Se a versão exata não for fornecida, o disco do sistema operacional será recriado para a versão existente do disco do sistema operacional.

forceUpdateOSDiskForEphemeral

boolean

Parâmetro para forçar a atualização do disco efêmero do sistema operacional para uma VM de conjunto de escala de máquina virtual

osProfile

OSProfileProvisioningData

Especifica as informações necessárias para a criação de imagens do disco do sistema operacional não efêmero.

tempDisk

boolean

Especifica se o disco temporário deve ser recriado. Valor Predefinido: falso. Nota: Este parâmetro de reimagem de disco temporário só é suportado para VM/VMSS com disco de SO efémero.

Respostas

Nome Tipo Descrição
200 OK

O pedido foi bem-sucedido.

202 Accepted

Operação de recurso aceita.

Cabeçalhos

  • Location: string
  • Retry-After: integer
Other Status Codes

CloudError

Uma resposta de erro inesperada.

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

Tipo: oauth2
Flow: implicit
URL de autorização: https://login.microsoftonline.com/common/oauth2/authorize

Alcances

Nome Descrição
user_impersonation personificar a sua conta de utilizador

Exemplos

VirtualMachineScaleSetVM_Reimage_MaximumSet_Gen
VirtualMachineScaleSetVM_Reimage_MinimumSet_Gen

VirtualMachineScaleSetVM_Reimage_MaximumSet_Gen

Pedido de exemplo

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaa/virtualMachines/aaaaaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2025-04-01

{
  "forceUpdateOSDiskForEphemeral": true,
  "tempDisk": true
}

Resposta de exemplo

location: https://foo.com/operationstatus

VirtualMachineScaleSetVM_Reimage_MinimumSet_Gen

Pedido de exemplo

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaa/virtualMachines/aaaaaaaaaaaaa/reimage?api-version=2025-04-01

Resposta de exemplo

location: https://foo.com/operationstatus

Definições

Nome Descrição
ApiError

Erro de api.

ApiErrorBase

Base de erro da api.

CloudError

Uma resposta de erro do serviço de computação.

InnerError

Detalhes do erro interno.

OSProfileProvisioningData

Parâmetros adicionais para recriação de imagens de máquinas virtuais não efêmeras.

VirtualMachineScaleSetVMReimageParameters

Descreve os parâmetros de reimagem da VM de um conjunto de dimensionamento de máquina virtual.

ApiError

Erro de api.

Nome Tipo Descrição
code

string

O código de erro.

details

ApiErrorBase[]

Os detalhes do erro Api

innererror

InnerError

O erro interno da Api

message

string

A mensagem de erro.

target

string

O alvo do erro específico.

ApiErrorBase

Base de erro da api.

Nome Tipo Descrição
code

string

O código de erro.

message

string

A mensagem de erro.

target

string

O alvo do erro específico.

CloudError

Uma resposta de erro do serviço de computação.

Nome Tipo Descrição
error

ApiError

Erro de api.

InnerError

Detalhes do erro interno.

Nome Tipo Descrição
errordetail

string

A mensagem de erro interna ou despejo de exceção.

exceptiontype

string

O tipo de exceção.

OSProfileProvisioningData

Parâmetros adicionais para recriação de imagens de máquinas virtuais não efêmeras.

Nome Tipo Descrição
adminPassword

string (password)

Especifica a senha da conta de administrador.

Comprimento mínimo (Windows): 8 caracteres

Comprimento mínimo (Linux): 6 caracteres

Max-length (Windows): 123 caracteres

Max-length (Linux): 72 caracteres

Requisitos de complexidade: 3 das 4 condições abaixo precisam ser cumpridas
Tem caracteres mais baixos
Tem caracteres superiores
Tem um dígito
Tem um caractere especial (Regex match [\W_])

Valores não permitidos: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Password!", "Password1", "Password22", "iloveyou!"

Para redefinir a senha, consulte Como redefinir o serviço de Área de Trabalho Remota ou sua senha de login em uma VM do Windows

Para redefinir a senha de root, consulte Gerenciar usuários, SSH e verificar ou reparar discos em VMs Linux do Azure usando a Extensão VMAccess

customData

string

Especifica uma cadeia de caracteres codificada em base 64 de dados personalizados. A cadeia de caracteres codificada em base 64 é decodificada para uma matriz binária que é salva como um arquivo na máquina virtual. O comprimento máximo da matriz binária é de 65535 bytes. Nota: Não passe segredos ou senhas na propriedade customData. Essa propriedade não pode ser atualizada depois que a VM é criada. A propriedade customData é passada para a VM para ser salva como um arquivo, para obter mais informações, consulte Dados personalizados em VMs do Azure. Se estiver usando cloud-init para sua VM Linux, consulte Usando cloud-init para personalizar uma VM Linux durante a criação.

VirtualMachineScaleSetVMReimageParameters

Descreve os parâmetros de reimagem da VM de um conjunto de dimensionamento de máquina virtual.

Nome Tipo Descrição
exactVersion

string

Especifica em número decimal, a versão para a qual o disco do sistema operacional deve ser recriado. Se a versão exata não for fornecida, o disco do sistema operacional será recriado para a versão existente do disco do sistema operacional.

forceUpdateOSDiskForEphemeral

boolean

Parâmetro para forçar a atualização do disco efêmero do sistema operacional para uma VM de conjunto de escala de máquina virtual

osProfile

OSProfileProvisioningData

Especifica as informações necessárias para a criação de imagens do disco do sistema operacional não efêmero.

tempDisk

boolean

Especifica se o disco temporário deve ser recriado. Valor Predefinido: falso. Nota: Este parâmetro de reimagem de disco temporário só é suportado para VM/VMSS com disco de SO efémero.