Partager via


Virtual Machine Scale Set VMs - Reimage

Reimages (mettre à niveau le système d’exploitation) une machine virtuelle spécifique dans un groupe de machines virtuelles identiques.

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

Paramètres URI

Nom Dans Obligatoire Type Description
instanceId
path True

string

ID d’instance de la machine virtuelle.

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 de chaque appel de service.

vmScaleSetName
path True

string

Nom du groupe de machines virtuelles identiques.

api-version
query True

string

Version de l’API cliente.

Corps de la demande

Nom Type Description
vmScaleSetVMReimageInput

VirtualMachineScaleSetVMReimageParameters

Paramètres de la machine virtuelle de réinitialisation dans ScaleSet.

Réponses

Nom Type Description
200 OK

D’ACCORD

202 Accepted

Accepté

Other Status Codes

CloudError

Réponse d’erreur décrivant pourquoi l’opération a échoué.

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

VirtualMachineScaleSetVM_Reimage_MaximumSet_Gen
VirtualMachineScaleSetVM_Reimage_MinimumSet_Gen

VirtualMachineScaleSetVM_Reimage_MaximumSet_Gen

Exemple de requête

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaaaaaaaaaaa/virtualMachines/aaaaaaaaaaaaaaaaaaaaaaaaaaaaa/reimage?api-version=2024-07-01

{
  "forceUpdateOSDiskForEphemeral": true,
  "tempDisk": true
}

Exemple de réponse

location: https://foo.com/operationstatus

VirtualMachineScaleSetVM_Reimage_MinimumSet_Gen

Exemple de requête

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachineScaleSets/aaaaaaa/virtualMachines/aaaaaaaaaaaaa/reimage?api-version=2024-07-01

Exemple de réponse

location: https://foo.com/operationstatus

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 la réinitialisation du disque de système d’exploitation non éphémère.

VirtualMachineScaleSetVMReimageParameters

Paramètres de la machine virtuelle de réinitialisation dans ScaleSet.

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 la réinitialisation du disque de système d’exploitation non éphémère.

Nom Type Description
adminPassword

string

Spécifie le mot de passe du compte d’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 vérifier 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 encodée en base 64 est décodée dans un tableau binaire enregistré en tant que fichier sur la machine virtuelle. La longueur maximale du tableau binaire est de 65535 octets. Remarque : Ne transmettez pas de secrets ou de mots de passe dans la propriété customData. Cette propriété ne peut pas être mise à jour une fois la machine virtuelle créée. La propriété customData est transmise à la machine virtuelle à enregistrer en tant que fichier, pour plus d’informations, consultez Données personnalisées sur les 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.

VirtualMachineScaleSetVMReimageParameters

Paramètres de la machine virtuelle de réinitialisation dans ScaleSet.

Nom Type Description
exactVersion

string

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

forceUpdateOSDiskForEphemeral

boolean

Paramètre pour forcer la mise à jour du disque de système d’exploitation éphémère pour une machine virtuelle de groupe de machines virtuelles identiques

osProfile

OSProfileProvisioningData

Spécifie les informations requises pour la réinitialisation du 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éimageage de disque temporaire est pris en charge uniquement pour la machine virtuelle/VMSS avec le disque de système d’exploitation éphémère.