Installatiekopieën (upgrade het besturingssysteem) van een virtuele machine die geen kortstondige besturingssysteemschijf hebben. Voor virtuele machines met een kortstondige besturingssysteemschijf wordt de virtuele machine opnieuw ingesteld op de beginstatus. OPMERKING: het behouden van een oude besturingssysteemschijf is afhankelijk van de waarde van deleteOption van de besturingssysteemschijf. Als deleteOption wordt losgekoppeld, blijft de oude besturingssysteemschijf behouden na het opnieuw maken van de installatiekopie. Als deleteOption is verwijderd, wordt de oude besturingssysteemschijf verwijderd na het opnieuw maken van de installatiekopie. De deleteOption van de besturingssysteemschijf moet dienovereenkomstig worden bijgewerkt voordat de installatiekopie opnieuw wordt uitgevoerd.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/reimage?api-version=2024-03-01
URI-parameters
Name |
In |
Vereist |
Type |
Description |
resourceGroupName
|
path |
True
|
string
|
De naam van de resourcegroep.
|
subscriptionId
|
path |
True
|
string
|
Abonnementsreferenties waarmee het Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke service-aanroep.
|
vmName
|
path |
True
|
string
|
De naam van de virtuele machine.
|
api-version
|
query |
True
|
string
|
Client-API-versie.
|
Aanvraagbody
Name |
Type |
Description |
parameters
|
VirtualMachineReimageParameters
|
Parameters die zijn opgegeven voor de bewerking Installatiekopie van virtuele machine opnieuw maken.
|
Antwoorden
Name |
Type |
Description |
200 OK
|
|
OK
|
202 Accepted
|
|
Geaccepteerd
|
Other Status Codes
|
CloudError
|
Foutreactie waarin wordt beschreven waarom de bewerking is mislukt.
|
Beveiliging
azure_auth
Azure Active Directory OAuth2-stroom
Type:
oauth2
Flow:
implicit
Authorization URL:
https://login.microsoftonline.com/common/oauth2/authorize
Scopes
Name |
Description |
user_impersonation
|
uw gebruikersaccount imiteren
|
Voorbeelden
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}"
}
}
import com.azure.resourcemanager.compute.models.OSProfileProvisioningData;
import com.azure.resourcemanager.compute.models.VirtualMachineReimageParameters;
/**
* Samples for VirtualMachines Reimage.
*/
public final class Main {
/*
* x-ms-original-file:
* specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/
* virtualMachineExamples/VirtualMachine_Reimage_NonEphemeralVMs.json
*/
/**
* Sample code: Reimage a Non-Ephemeral Virtual Machine.
*
* @param azure The entry point for accessing resource management APIs in Azure.
*/
public static void reimageANonEphemeralVirtualMachine(com.azure.resourcemanager.AzureResourceManager azure) {
azure.virtualMachines().manager().serviceClient().getVirtualMachines().reimage(
"myResourceGroup", "myVMName", new VirtualMachineReimageParameters().withTempDisk(true)
.withExactVersion("aaaaaa").withOsProfile(new OSProfileProvisioningData()
.withAdminPassword("fakeTokenPlaceholder").withCustomData("{your-custom-data}")),
com.azure.core.util.Context.NONE);
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
from azure.identity import DefaultAzureCredential
from azure.mgmt.compute import ComputeManagementClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-compute
# USAGE
python virtual_machine_reimage_non_ephemeral_vms.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = ComputeManagementClient(
credential=DefaultAzureCredential(),
subscription_id="{subscription-id}",
)
client.virtual_machines.begin_reimage(
resource_group_name="myResourceGroup",
vm_name="myVMName",
).result()
# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_Reimage_NonEphemeralVMs.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armcompute_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v5"
)
// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_Reimage_NonEphemeralVMs.json
func ExampleVirtualMachinesClient_BeginReimage_reimageANonEphemeralVirtualMachine() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
poller, err := clientFactory.NewVirtualMachinesClient().BeginReimage(ctx, "myResourceGroup", "myVMName", &armcompute.VirtualMachinesClientBeginReimageOptions{Parameters: &armcompute.VirtualMachineReimageParameters{
ExactVersion: to.Ptr("aaaaaa"),
OSProfile: &armcompute.OSProfileProvisioningData{
AdminPassword: to.Ptr("{your-password}"),
CustomData: to.Ptr("{your-custom-data}"),
},
TempDisk: to.Ptr(true),
},
})
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
_, err = poller.PollUntilDone(ctx, nil)
if err != nil {
log.Fatalf("failed to pull the result: %v", err)
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to Reimages (upgrade the operating system) a virtual machine which don't have a ephemeral OS disk, for virtual machines who have a ephemeral OS disk the virtual machine is reset to initial state. NOTE: The retaining of old OS disk depends on the value of deleteOption of OS disk. If deleteOption is detach, the old OS disk will be preserved after reimage. If deleteOption is delete, the old OS disk will be deleted after reimage. The deleteOption of the OS disk should be updated accordingly before performing the reimage.
*
* @summary Reimages (upgrade the operating system) a virtual machine which don't have a ephemeral OS disk, for virtual machines who have a ephemeral OS disk the virtual machine is reset to initial state. NOTE: The retaining of old OS disk depends on the value of deleteOption of OS disk. If deleteOption is detach, the old OS disk will be preserved after reimage. If deleteOption is delete, the old OS disk will be deleted after reimage. The deleteOption of the OS disk should be updated accordingly before performing the reimage.
* x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_Reimage_NonEphemeralVMs.json
*/
async function reimageANonEphemeralVirtualMachine() {
const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
const vmName = "myVMName";
const parameters = {
exactVersion: "aaaaaa",
osProfile: {
adminPassword: "{your-password}",
customData: "{your-custom-data}",
},
tempDisk: true,
};
const options = { parameters };
const credential = new DefaultAzureCredential();
const client = new ComputeManagementClient(credential, subscriptionId);
const result = await client.virtualMachines.beginReimageAndWait(
resourceGroupName,
vmName,
options,
);
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
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
}
import com.azure.resourcemanager.compute.models.VirtualMachineReimageParameters;
/**
* Samples for VirtualMachines Reimage.
*/
public final class Main {
/*
* x-ms-original-file:
* specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/
* virtualMachineExamples/VirtualMachine_Reimage.json
*/
/**
* Sample code: Reimage a Virtual Machine.
*
* @param azure The entry point for accessing resource management APIs in Azure.
*/
public static void reimageAVirtualMachine(com.azure.resourcemanager.AzureResourceManager azure) {
azure.virtualMachines().manager().serviceClient().getVirtualMachines().reimage("myResourceGroup", "myVMName",
new VirtualMachineReimageParameters().withTempDisk(true), com.azure.core.util.Context.NONE);
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
from azure.identity import DefaultAzureCredential
from azure.mgmt.compute import ComputeManagementClient
"""
# PREREQUISITES
pip install azure-identity
pip install azure-mgmt-compute
# USAGE
python virtual_machine_reimage.py
Before run the sample, please set the values of the client ID, tenant ID and client secret
of the AAD application as environment variables: AZURE_CLIENT_ID, AZURE_TENANT_ID,
AZURE_CLIENT_SECRET. For more info about how to get the value, please see:
https://docs.microsoft.com/azure/active-directory/develop/howto-create-service-principal-portal
"""
def main():
client = ComputeManagementClient(
credential=DefaultAzureCredential(),
subscription_id="{subscription-id}",
)
client.virtual_machines.begin_reimage(
resource_group_name="myResourceGroup",
vm_name="myVMName",
).result()
# x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_Reimage.json
if __name__ == "__main__":
main()
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
package armcompute_test
import (
"context"
"log"
"github.com/Azure/azure-sdk-for-go/sdk/azcore/to"
"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v5"
)
// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/92de53a5f1e0e03c94b40475d2135d97148ed014/specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_Reimage.json
func ExampleVirtualMachinesClient_BeginReimage_reimageAVirtualMachine() {
cred, err := azidentity.NewDefaultAzureCredential(nil)
if err != nil {
log.Fatalf("failed to obtain a credential: %v", err)
}
ctx := context.Background()
clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
if err != nil {
log.Fatalf("failed to create client: %v", err)
}
poller, err := clientFactory.NewVirtualMachinesClient().BeginReimage(ctx, "myResourceGroup", "myVMName", &armcompute.VirtualMachinesClientBeginReimageOptions{Parameters: &armcompute.VirtualMachineReimageParameters{
TempDisk: to.Ptr(true),
},
})
if err != nil {
log.Fatalf("failed to finish the request: %v", err)
}
_, err = poller.PollUntilDone(ctx, nil)
if err != nil {
log.Fatalf("failed to pull the result: %v", err)
}
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");
/**
* This sample demonstrates how to Reimages (upgrade the operating system) a virtual machine which don't have a ephemeral OS disk, for virtual machines who have a ephemeral OS disk the virtual machine is reset to initial state. NOTE: The retaining of old OS disk depends on the value of deleteOption of OS disk. If deleteOption is detach, the old OS disk will be preserved after reimage. If deleteOption is delete, the old OS disk will be deleted after reimage. The deleteOption of the OS disk should be updated accordingly before performing the reimage.
*
* @summary Reimages (upgrade the operating system) a virtual machine which don't have a ephemeral OS disk, for virtual machines who have a ephemeral OS disk the virtual machine is reset to initial state. NOTE: The retaining of old OS disk depends on the value of deleteOption of OS disk. If deleteOption is detach, the old OS disk will be preserved after reimage. If deleteOption is delete, the old OS disk will be deleted after reimage. The deleteOption of the OS disk should be updated accordingly before performing the reimage.
* x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/ComputeRP/stable/2024-03-01/examples/virtualMachineExamples/VirtualMachine_Reimage.json
*/
async function reimageAVirtualMachine() {
const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
const vmName = "myVMName";
const parameters = { tempDisk: true };
const options = { parameters };
const credential = new DefaultAzureCredential();
const client = new ComputeManagementClient(credential, subscriptionId);
const result = await client.virtualMachines.beginReimageAndWait(
resourceGroupName,
vmName,
options,
);
console.log(result);
}
To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue
Sample Response
Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2024-03-01
Definities
ApiError
API-fout.
Name |
Type |
Description |
code
|
string
|
De foutcode.
|
details
|
ApiErrorBase[]
|
De API-foutdetails
|
innererror
|
InnerError
|
De interne API-fout
|
message
|
string
|
Het foutbericht.
|
target
|
string
|
Het doel van de specifieke fout.
|
ApiErrorBase
API-foutbasis.
Name |
Type |
Description |
code
|
string
|
De foutcode.
|
message
|
string
|
Het foutbericht.
|
target
|
string
|
Het doel van de specifieke fout.
|
CloudError
Een foutreactie van de Compute-service.
Name |
Type |
Description |
error
|
ApiError
|
API-fout.
|
InnerError
Details van interne fout.
Name |
Type |
Description |
errordetail
|
string
|
Het interne foutbericht of de uitzonderingsdump.
|
exceptiontype
|
string
|
Het uitzonderingstype.
|
OSProfileProvisioningData
Hiermee geeft u de informatie op die is vereist voor het opnieuw opgeven van de niet-tijdelijke besturingssysteemschijf.
Name |
Type |
Description |
adminPassword
|
string
|
Hiermee geeft u het wachtwoord van het beheerdersaccount.
Minimale lengte (Windows): 8 tekens
Minimale lengte (Linux): 6 tekens
Maximale lengte (Windows): 123 tekens
Maximale lengte (Linux): 72 tekens
Complexiteitsvereisten: aan 3 van de vier onderstaande voorwaarden moet worden voldaan Heeft lagere tekens Bevat bovenste tekens Heeft een cijfer Heeft een speciaal teken (regex-overeenkomst [\W_])
Niet-toegestane waarden: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "Wachtwoord!", "Wachtwoord1", "Wachtwoord22", "iloveyou!"
Zie De Extern bureaublad-service of het aanmeldingswachtwoord opnieuw instellen op een Windows-VM voor het opnieuw instellen van het wachtwoord
Zie Gebruikers, SSH beheren en schijven controleren of herstellen op Azure Linux-VM's met behulp van de VMAccess-extensie voor het opnieuw instellen van het hoofdwachtwoord
|
customData
|
string
|
Hiermee geeft u een base-64 gecodeerde tekenreeks van aangepaste gegevens. De met base 64 gecodeerde tekenreeks wordt gedecodeerd naar een binaire matrix die wordt opgeslagen als een bestand op de virtuele machine. De maximale lengte van de binaire matrix is 65535 bytes. Opmerking: geef geen geheimen of wachtwoorden door in de eigenschap customData. Deze eigenschap kan niet worden bijgewerkt nadat de VM is gemaakt. De eigenschap customData wordt doorgegeven aan de virtuele machine om als een bestand te worden opgeslagen. Zie Aangepaste gegevens op Azure-VM's voor meer informatie. Als u cloud-init gebruikt voor uw Linux-VM, raadpleegt u Cloud-init gebruiken om een Linux-VM aan te passen tijdens het maken.
|
VirtualMachineReimageParameters
Parameters die zijn opgegeven voor de bewerking Installatiekopie van virtuele machine opnieuw maken.
Name |
Type |
Description |
exactVersion
|
string
|
Hiermee geeft u in decimaal getal de versie van de besturingssysteemschijf opnieuw moet worden geïnstalleerd. Als er geen exacte versie is opgegeven, wordt de besturingssysteemschijf opnieuw geïnstalleerd op de bestaande versie van de besturingssysteemschijf.
|
osProfile
|
OSProfileProvisioningData
|
Hiermee geeft u de informatie op die is vereist voor het opnieuw opgeven van de niet-tijdelijke besturingssysteemschijf.
|
tempDisk
|
boolean
|
Hiermee geeft u op of de tijdelijke schijf opnieuw moet worden hersteld. Standaardwaarde: false. Opmerking: deze tijdelijke schijfreimageparameter wordt alleen ondersteund voor VM/VMSS met tijdelijke besturingssysteemschijf.
|