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 |
---|---|---|---|---|
resource
|
path | True |
string |
O nome do grupo de recursos. |
subscription
|
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. |
vm
|
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 |
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 |
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
Virtual |
Virtual |
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
Resposta de exemplo
location: https://foo.com/operationstatus
Definições
Nome | Description |
---|---|
Api |
Erro de API. |
Api |
Base de erros de API. |
Cloud |
Uma resposta de erro do serviço de computação. |
Inner |
Detalhes do erro interno. |
OSProfile |
Parâmetros adicionais para a Máquina Virtual Não Efêmera Reimaging. |
Virtual |
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 |
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 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 |
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. |
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 |
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. |