Virtual Machines - Reimage
Återskapar (uppgraderar operativsystemet) en virtuell dator som inte har en tillfällig OS-disk för virtuella datorer som har en tillfällig OS-disk som den virtuella datorn återställs till initialt tillstånd. Obs! Kvarhållningen av den gamla OS-disken beror på värdet för deleteOption för OS-disk. Om deleteOption är frånkopplat bevaras den gamla OS-disken efter avbildningen. Om deleteOption tas bort tas den gamla OS-disken bort efter avbildningen. DeleteOption för OS-disken bör uppdateras i enlighet med detta innan avbildningen utförs.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/reimage?api-version=2024-03-01
URI-parametrar
Name | I | Obligatorisk | Typ | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Namnet på resursgruppen. |
subscription
|
path | True |
string |
Autentiseringsuppgifter för prenumeration som unikt identifierar Microsoft Azure-prenumeration. Prenumerations-ID:t utgör en del av URI:n för varje tjänstanrop. |
vm
|
path | True |
string |
Namnet på den virtuella datorn. |
api-version
|
query | True |
string |
Klient-API-version. |
Begärandetext
Name | Typ | Description |
---|---|---|
parameters |
Parametrar som angetts för åtgärden Reimage Virtual Machine. |
Svar
Name | Typ | Description |
---|---|---|
200 OK |
OK |
|
202 Accepted |
Har godkänts |
|
Other Status Codes |
Felsvar som beskriver varför åtgärden misslyckades. |
Säkerhet
azure_auth
Azure Active Directory OAuth2 Flow
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name | Description |
---|---|
user_impersonation | personifiera ditt användarkonto |
Exempel
Reimage a Non-Ephemeral Virtual Machine. |
Reimage a Virtual Machine. |
Reimage a Non-Ephemeral Virtual Machine.
Sample Request
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVMName/reimage?api-version=2024-03-01
{
"tempDisk": true,
"exactVersion": "aaaaaa",
"osProfile": {
"adminPassword": "{your-password}",
"customData": "{your-custom-data}"
}
}
Sample Response
Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2024-03-01
Reimage a Virtual Machine.
Sample Request
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVMName/reimage?api-version=2024-03-01
{
"tempDisk": true
}
Sample Response
Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2024-03-01
Definitioner
Name | Description |
---|---|
Api |
API-fel. |
Api |
Api-felbas. |
Cloud |
Ett felsvar från Beräkningstjänsten. |
Inner |
Inre felinformation. |
OSProfile |
Anger den information som krävs för att återskapa den icke-tillfälliga OS-disken. |
Virtual |
Parametrar som angetts för åtgärden Reimage Virtual Machine. |
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 Beräkningstjänsten.
Name | Typ | Description |
---|---|---|
error |
API-fel. |
InnerError
Inre felinformation.
Name | Typ | Description |
---|---|---|
errordetail |
string |
Det interna felmeddelandet eller undantagsdumpen. |
exceptiontype |
string |
Undantagstypen. |
OSProfileProvisioningData
Anger den information som krävs för att återskapa den icke-tillfälliga OS-disken.
Name | Typ | Description |
---|---|---|
adminPassword |
string |
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 för 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 läser du Använda cloud-init för att anpassa en virtuell Linux-dator när du skapar den. |
VirtualMachineReimageParameters
Parametrar som angetts för åtgärden Reimage Virtual Machine.
Name | Typ | Description |
---|---|---|
exactVersion |
string |
Anger i decimaltal den version som OS-disken ska återskapas till. Om den exakta versionen inte anges avbildningar av OS-disken till den befintliga versionen av OS-disken. |
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 avbildningas. Standardvärde: false. Obs! Den här parametern för temporär diskåterbildning stöds endast för VM/VMSS med tillfällig OS-disk. |