Virtual Machine Scale Set VMs - Reimage
Recria a imagem (atualiza o sistema operacional) de uma máquina virtual específica em um conjunto de dimensionamento 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 de URI
| Nome | Em | Obrigatório | Tipo | Description |
|---|---|---|---|---|
|
instance
|
path | True |
string |
A 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 dimensionamento da VM. |
|
api-version
|
query | True |
string minLength: 1 |
A versão da API a ser usada para esta operação. |
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 |
| osProfile |
Especifica as informações necessárias para recriar a imagem do disco do sistema operacional não efêmero. |
|
| tempDisk |
boolean |
Especifica se o disco temporário deve ser reimagem. Valor padrão: falso. Observação: esse parâmetro de reimagem de disco temporário só tem suporte para VM/VMSS com disco de sistema operacional efêmero. |
Respostas
| Nome | Tipo | Description |
|---|---|---|
| 200 OK |
A solicitação foi bem-sucedida. |
|
| 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 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
|
Virtual |
|
Virtual |
VirtualMachineScaleSetVM_Reimage_MaximumSet_Gen
Solicitação 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
Solicitação de exemplo
Resposta de exemplo
location: https://foo.com/operationstatus
Definições
| Nome | Description |
|---|---|
|
Api |
Erro de API. |
|
Api |
Base de erros da API. |
|
Cloud |
Uma resposta de erro do serviço Compute. |
|
Inner |
Detalhes do erro interno. |
|
OSProfile |
Parâmetros adicionais para recriar a imagem da máquina virtual não efêmera. |
|
Virtual |
Descreve um conjunto de dimensionamento de máquinas virtuais Parâmetros de reimagem de VM. |
ApiError
Erro de API.
| Nome | Tipo | Description |
|---|---|---|
| code |
string |
O código de erro. |
| details |
Os detalhes do erro da API |
|
| innererror |
O erro interno da API |
|
| message |
string |
A mensagem de erro. |
| target |
string |
O destino do erro específico. |
ApiErrorBase
Base de erros da 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 Compute.
| Nome | Tipo | Description |
|---|---|---|
| error |
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 recriar a imagem da máquina virtual não efêmera.
| Nome | Tipo | Description |
|---|---|---|
| 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 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 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 do Linux, consulte Usando cloud-init para personalizar uma VM do Linux durante a criação. |
VirtualMachineScaleSetVMReimageParameters
Descreve um conjunto de dimensionamento de máquinas virtuais Parâmetros de reimagem de VM.
| 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 |
| osProfile |
Especifica as informações necessárias para recriar a imagem do disco do sistema operacional não efêmero. |
|
| tempDisk |
boolean |
Especifica se o disco temporário deve ser reimagem. Valor padrão: falso. Observação: esse parâmetro de reimagem de disco temporário só tem suporte para VM/VMSS com disco de sistema operacional efêmero. |