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 |
|---|---|---|---|---|
|
instance
|
path | True |
string |
O ID da instância da máquina virtual. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas. |
|
subscription
|
path | True |
string minLength: 1 |
A ID da assinatura de destino. |
|
vm
|
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 |
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
|
|
| Other Status Codes |
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
|
Virtual |
|
Virtual |
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
Resposta de exemplo
location: https://foo.com/operationstatus
Definições
| Nome | Descrição |
|---|---|
|
Api |
Erro de api. |
|
Api |
Base de erro da api. |
|
Cloud |
Uma resposta de erro do serviço de computação. |
|
Inner |
Detalhes do erro interno. |
|
OSProfile |
Parâmetros adicionais para recriação de imagens de máquinas virtuais não efêmeras. |
|
Virtual |
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 |
Os detalhes do erro Api |
|
| 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 |
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. |
| 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 |
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. |