Partager via


Virtual Machines - Reimage

Reimage (mettre à niveau le système d’exploitation) une machine virtuelle qui n’a pas de disque de système d’exploitation éphémère. Pour les machines virtuelles qui ont un disque de système d’exploitation éphémère, la machine virtuelle est réinitialisée à l’état initial. REMARQUE : La conservation de l’ancien disque de système d’exploitation dépend de la valeur de deleteOption du disque du système d’exploitation. Si deleteOption est détaché, l’ancien disque du système d’exploitation est conservé après une nouvelle image. Si deleteOption est delete, l’ancien disque du système d’exploitation est supprimé après une nouvelle image. L’option deleteOption du disque du système d’exploitation doit être mise à jour en conséquence avant d’effectuer la nouvelle image.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/reimage?api-version=2024-03-01

Paramètres URI

Nom Dans Obligatoire Type Description
resourceGroupName
path True

string

Nom du groupe de ressources.

subscriptionId
path True

string

Informations d’identification d’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI pour chaque appel de service.

vmName
path True

string

Nom de la machine virtuelle.

api-version
query True

string

Version de l’API cliente.

Corps de la demande

Nom Type Description
parameters

VirtualMachineReimageParameters

Paramètres fournis à l’opération Reimager la machine virtuelle.

Réponses

Nom Type Description
200 OK

Ok

202 Accepted

Accepté

Other Status Codes

CloudError

Réponse d’erreur décrivant la raison de l’échec de l’opération.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom Description
user_impersonation Emprunter l’identité de votre compte d’utilisateur

Exemples

Reimage a Non-Ephemeral Virtual Machine.
Reimage a Virtual Machine.

Reimage a Non-Ephemeral Virtual Machine.

Exemple de requête

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}"
  }
}

Exemple de réponse

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.

Exemple de requête

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/virtualMachines/myVMName/reimage?api-version=2024-03-01

{
  "tempDisk": true
}

Exemple de réponse

Location: https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.Compute/locations/westus/operations/{operationId}&monitor=true&api-version=2024-03-01

Définitions

Nom Description
ApiError

Erreur d’API.

ApiErrorBase

Base d’erreurs d’API.

CloudError

Réponse d’erreur du service de calcul.

InnerError

Détails de l’erreur interne.

OSProfileProvisioningData

Spécifie les informations requises pour réimaginer le disque de système d’exploitation non éphémère.

VirtualMachineReimageParameters

Paramètres fournis à l’opération Reimager la machine virtuelle.

ApiError

Erreur d’API.

Nom Type Description
code

string

Code d'erreur.

details

ApiErrorBase[]

Détails de l’erreur api

innererror

InnerError

Erreur interne de l’API

message

string

Message d’erreur.

target

string

Cible de l’erreur particulière.

ApiErrorBase

Base d’erreurs d’API.

Nom Type Description
code

string

Code d'erreur.

message

string

Message d’erreur.

target

string

Cible de l’erreur particulière.

CloudError

Réponse d’erreur du service de calcul.

Nom Type Description
error

ApiError

Erreur d’API.

InnerError

Détails de l’erreur interne.

Nom Type Description
errordetail

string

Message d’erreur interne ou vidage d’exception.

exceptiontype

string

Type d'exception.

OSProfileProvisioningData

Spécifie les informations requises pour réimaginer le disque de système d’exploitation non éphémère.

Nom Type Description
adminPassword

string

Spécifie le mot de passe du compte administrateur.

Longueur minimale (Windows) : 8 caractères

Longueur minimale (Linux) : 6 caractères

Longueur maximale (Windows) : 123 caractères

Longueur maximale (Linux) : 72 caractères

Exigences de complexité : 3 conditions sur 4 ci-dessous doivent être remplies
Comporte des caractères inférieurs
Comporte des caractères supérieurs
A un chiffre
A un caractère spécial (correspondance regex [\W_])

Valeurs non autorisées : « abc@123 », « P@$$w 0rd », « P@ssw0rd », « P@ssword123 », « Pa$$word », « pass@word1 », « Password ! », « Password1 », « Password22 », « iloveyou ! »

Pour réinitialiser le mot de passe, consultez Comment réinitialiser le service Bureau à distance ou son mot de passe de connexion dans une machine virtuelle Windows

Pour réinitialiser le mot de passe racine, consultez Gérer les utilisateurs, SSH et case activée ou réparer des disques sur des machines virtuelles Linux Azure à l’aide de l’extension VMAccess

customData

string

Spécifie une chaîne codée en base 64 de données personnalisées. La chaîne codée en base 64 est décodée dans un tableau binaire enregistré dans un fichier sur la machine virtuelle. La longueur maximale du tableau binaire est 65535 octets. Remarque : Ne passez pas de secrets ou de mots de passe dans la propriété customData. Cette propriété ne peut pas être mise à jour après la création de la machine virtuelle. La propriété customData est passée à la machine virtuelle pour être enregistrée en tant que fichier. Pour plus d’informations, consultez Données personnalisées sur des machines virtuelles Azure. Si vous utilisez cloud-init pour votre machine virtuelle Linux, consultez Utilisation de cloud-init pour personnaliser une machine virtuelle Linux lors de la création.

VirtualMachineReimageParameters

Paramètres fournis à l’opération Reimager la machine virtuelle.

Nom Type Description
exactVersion

string

Spécifie en nombre décimal, la version vers laquelle le disque du système d’exploitation doit être réinitialé. Si la version exacte n’est pas fournie, le disque du système d’exploitation est réinitialé à la version existante du disque du système d’exploitation.

osProfile

OSProfileProvisioningData

Spécifie les informations requises pour réimaginer le disque de système d’exploitation non éphémère.

tempDisk

boolean

Spécifie s’il faut réimager le disque temporaire. Valeur par défaut : false. Remarque : ce paramètre de réimage de disque temporaire est uniquement pris en charge pour les machines virtuelles/VMSS avec un disque de système d’exploitation éphémère.