Compartilhar via


Virtual Machine Scale Sets - Reimage

Reimages (atualizar o sistema operacional) uma ou mais máquinas virtuais em um conjunto de dimensionamento de VMs que não têm um disco do sistema operacional efêmero, para máquinas virtuais que têm um disco do sistema operacional efêmero, a máquina virtual é redefinida para o estado inicial.

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

Parâmetros de URI

Nome Em Obrigatório Tipo Description
resourceGroupName
path True

string

O nome do grupo de recursos.

subscriptionId
path True

string

Credenciais de assinatura que identificam exclusivamente a assinatura do Microsoft Azure. A ID da assinatura faz parte do URI para cada chamada de serviço.

vmScaleSetName
path True

string

O nome do conjunto de dimensionamento da VM.

api-version
query True

string

Versão da API do cliente.

Corpo da solicitação

Nome Tipo Description
exactVersion

string

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

forceUpdateOSDiskForEphemeral

boolean

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

instanceIds

string[]

As IDs da instância do conjunto de dimensionamento de máquinas virtuais. Omitir as IDs da instância do conjunto de dimensionamento de máquinas virtuais resultará na execução da operação em todas as máquinas virtuais no conjunto de dimensionamento de máquinas virtuais.

osProfile

OSProfileProvisioningData

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

tempDisk

boolean

Especifica se o disco temporário deve ser reimagem. Valor padrão: false. Observação: esse parâmetro temp disk reimage só tem suporte para VM/VMSS com disco do sistema operacional efêmero.

Respostas

Nome Tipo Description
200 OK

OKEY

202 Accepted

Aceitado

Other Status Codes

CloudError

Resposta de erro que descreve por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

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

Escopos

Nome Description
user_impersonation representar sua conta de usuário

Exemplos

VirtualMachineScaleSet_Reimage_MaximumSet_Gen
VirtualMachineScaleSet_Reimage_MinimumSet_Gen

VirtualMachineScaleSet_Reimage_MaximumSet_Gen

Solicitação de exemplo

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2024-07-01

{
  "instanceIds": [
    "aaaaaaaaaa"
  ],
  "forceUpdateOSDiskForEphemeral": true,
  "tempDisk": true
}

Resposta de exemplo

location: https://foo.com/operationstatus

VirtualMachineScaleSet_Reimage_MinimumSet_Gen

Solicitação de exemplo

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2024-07-01

Resposta de exemplo

location: https://foo.com/operationstatus

Definições

Nome Description
ApiError

Erro de API.

ApiErrorBase

Base de erros de API.

CloudError

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

InnerError

Detalhes do erro interno.

OSProfileProvisioningData

Parâmetros adicionais para a Máquina Virtual Não Efêmera Reimaging.

VirtualMachineScaleSetReimageParameters

Descreve os parâmetros de nova imagem da VM do Conjunto de Dimensionamento de Máquinas Virtuais.

ApiError

Erro de API.

Nome Tipo Description
code

string

O código de erro.

details

ApiErrorBase[]

Os detalhes do erro da API

innererror

InnerError

O erro interno da API

message

string

A mensagem de erro.

target

string

O destino do erro específico.

ApiErrorBase

Base de erros de API.

Nome Tipo Description
code

string

O código de erro.

message

string

A mensagem de erro.

target

string

O destino do erro específico.

CloudError

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

Nome Tipo Description
error

ApiError

Erro de API.

InnerError

Detalhes do erro interno.

Nome Tipo Description
errordetail

string

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

exceptiontype

string

O tipo de exceção.

OSProfileProvisioningData

Parâmetros adicionais para a Máquina Virtual Não Efêmera Reimaging.

Nome Tipo Description
adminPassword

string

Especifica a senha da conta de administrador.

Comprimento mínimo (Windows): 8 caracteres

Comprimento mínimo (Linux): 6 caracteres

comprimento máximo (Windows): 123 caracteres

comprimento máximo (Linux): 72 caracteres

requisitos de complexidade: 3 de 4 condições abaixo precisam ser atendidas
Tem caracteres inferiores
Tem caracteres superiores
Tem um dígito
Tem um caractere especial (correspondência regex [\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 logon em uma VM do Windows

Para redefinir a senha raiz, 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 salva como um arquivo na Máquina Virtual. O comprimento máximo da matriz binária é de 65535 bytes. Observação: não passe segredos ou senhas na propriedade customData. Essa propriedade não pode ser atualizada após a criação da VM. A propriedade customData é passada para a VM a 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 do Linux durante a criação.

VirtualMachineScaleSetReimageParameters

Descreve os parâmetros de nova imagem da VM do Conjunto de Dimensionamento de Máquinas Virtuais.

Nome Tipo Description
exactVersion

string

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

forceUpdateOSDiskForEphemeral

boolean

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

instanceIds

string[]

As IDs da instância do conjunto de dimensionamento de máquinas virtuais. Omitir as IDs da instância do conjunto de dimensionamento de máquinas virtuais resultará na execução da operação em todas as máquinas virtuais no conjunto de dimensionamento de máquinas virtuais.

osProfile

OSProfileProvisioningData

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

tempDisk

boolean

Especifica se o disco temporário deve ser reimagem. Valor padrão: false. Observação: esse parâmetro temp disk reimage só tem suporte para VM/VMSS com disco do sistema operacional efêmero.