Virtual Machine Scale Sets - Reimage
Återskapar (uppgraderar operativsystemet) en eller flera virtuella datorer i en VM-skalningsuppsättning som inte har en tillfällig OS-disk, för virtuella datorer som har en tillfällig OS-disk återställs den virtuella datorn till det ursprungliga tillståndet.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/reimage?api-version=2026-03-01
URI-parametrar
| Name | I | Obligatorisk | Typ | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Namnet på resursgruppen. Namnet är skiftlägesokänsligt. |
|
subscription
|
path | True |
string minLength: 1 |
ID för målprenumerationen. |
|
vm
|
path | True |
string |
Namnet på VM-skalningsuppsättningen. |
|
api-version
|
query | True |
string minLength: 1 |
Den API-version som ska användas för den här åtgärden. |
Begärandetext
| Name | Typ | Description |
|---|---|---|
| exactVersion |
string |
Anger i decimaltal den version som OS-disken ska omskapas till. Om den exakta versionen inte tillhandahålls återskapas OS-disken till den befintliga versionen av OS Disk. |
| forceUpdateOSDiskForEphemeral |
boolean |
Parameter för att framtvinga uppdatering av tillfälliga OS-diskar för en virtuell dator med skalningsuppsättningsuppsättning för en virtuell dator |
| instanceIds |
string[] |
Instans-ID:erna för vm-skalningsuppsättningen. Om du utelämnar instans-ID:erna för vm-skalningsuppsättningar kommer åtgärden att utföras på alla virtuella datorer i vm-skalningsuppsättningen. |
| osProfile |
Anger den information som krävs för att återskapa den icke-tillfälliga OS-disken. |
|
| tempDisk |
boolean |
Anger om temporär disk ska återskapas. Standardvärde: false. Obs! Den här parametern för temporär diskåterimering stöds endast för VM/VMSS med tillfällig OS-disk. |
Svar
| Name | Typ | Description |
|---|---|---|
| 200 OK |
Begäran har lyckats. |
|
| 202 Accepted |
Resursåtgärden har godkänts. Sidhuvuden
|
|
| Other Status Codes |
Ett oväntat felsvar. |
Säkerhet
azure_auth
Azure Active Directory OAuth2-flöde.
Typ:
oauth2
Flow:
implicit
Auktoriseringswebbadress:
https://login.microsoftonline.com/common/oauth2/authorize
Omfattningar
| Name | Description |
|---|---|
| user_impersonation | personifiera ditt användarkonto |
Exempel
|
Virtual |
|
Virtual |
VirtualMachineScaleSet_Reimage_MaximumSet_Gen
Exempelbegäran
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2026-03-01
{
"instanceIds": [
"aaaaaaaaaa"
],
"forceUpdateOSDiskForEphemeral": true,
"tempDisk": true
}
Exempelsvar
location: https://foo.com/operationstatus
VirtualMachineScaleSet_Reimage_MinimumSet_Gen
Exempelbegäran
Exempelsvar
location: https://foo.com/operationstatus
Definitioner
| Name | Description |
|---|---|
|
Api |
Api-fel. |
|
Api |
Api-felbas. |
|
Cloud |
Ett felsvar från Compute-tjänsten. |
|
Inner |
Inre felinformation. |
|
OSProfile |
Ytterligare parametrar för att återskapa icke-tillfälliga virtuella datorer. |
|
Virtual |
Beskriver en VM-skalningsuppsättning för vm-omimageparametrar. |
ApiError
Api-fel.
| Name | Typ | Description |
|---|---|---|
| code |
string |
Felkoden. |
| details |
Api-felinformationen |
|
| innererror |
Api:ets inre fel |
|
| message |
string |
Felmeddelandet. |
| target |
string |
Målet för det specifika felet. |
ApiErrorBase
Api-felbas.
| Name | Typ | Description |
|---|---|---|
| code |
string |
Felkoden. |
| message |
string |
Felmeddelandet. |
| target |
string |
Målet för det specifika felet. |
CloudError
Ett felsvar från Compute-tjänsten.
| Name | Typ | Description |
|---|---|---|
| error |
Api-fel. |
InnerError
Inre felinformation.
| Name | Typ | Description |
|---|---|---|
| errordetail |
string |
Det interna felmeddelandet eller undantagsdumpen. |
| exceptiontype |
string |
Typen av undantag. |
OSProfileProvisioningData
Ytterligare parametrar för att återskapa icke-tillfälliga virtuella datorer.
| Name | Typ | Description |
|---|---|---|
| adminPassword |
string (password) |
Anger lösenordet för administratörskontot. |
| customData |
string |
Anger en base-64-kodad sträng med anpassade data. Den base-64-kodade strängen avkodas till en binär matris som sparas som en fil på den virtuella datorn. Den maximala längden på den binära matrisen är 65535 byte. Obs! Skicka inga hemligheter eller lösenord i customData-egenskapen. Det går inte att uppdatera den här egenskapen när den virtuella datorn har skapats. Egenskapen customData skickas till den virtuella datorn för att sparas som en fil. Mer information finns i Anpassade data på virtuella Azure-datorer. Om du använder cloud-init för din virtuella Linux-dator kan du läsa Använda cloud-init för att anpassa en virtuell Linux-dator när du skapar. |
VirtualMachineScaleSetReimageParameters
Beskriver en VM-skalningsuppsättning för vm-omimageparametrar.
| Name | Typ | Description |
|---|---|---|
| exactVersion |
string |
Anger i decimaltal den version som OS-disken ska omskapas till. Om den exakta versionen inte tillhandahålls återskapas OS-disken till den befintliga versionen av OS Disk. |
| forceUpdateOSDiskForEphemeral |
boolean |
Parameter för att framtvinga uppdatering av tillfälliga OS-diskar för en virtuell dator med skalningsuppsättningsuppsättning för en virtuell dator |
| instanceIds |
string[] |
Instans-ID:erna för vm-skalningsuppsättningen. Om du utelämnar instans-ID:erna för vm-skalningsuppsättningar kommer åtgärden att utföras på alla virtuella datorer i vm-skalningsuppsättningen. |
| osProfile |
Anger den information som krävs för att återskapa den icke-tillfälliga OS-disken. |
|
| tempDisk |
boolean |
Anger om temporär disk ska återskapas. Standardvärde: false. Obs! Den här parametern för temporär diskåterimering stöds endast för VM/VMSS med tillfällig OS-disk. |