Virtual Machine Scale Sets - Reimage

  • Référence
Service:
Compute
API Version:
2024-03-01

Reimage (mettre à niveau le système d’exploitation) une ou plusieurs machines virtuelles dans un groupe de machines virtuelles identiques qui n’ont 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.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachineScaleSets/{vmScaleSetName}/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.
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
exactVersion

string

Spécifie, en nombre décimal, la version dans 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
instanceIds

string[]

Le groupe de machines virtuelles identiques instance ids. L’omission du groupe de machines virtuelles identiques instance id entraîne l’exécution de l’opération sur toutes les machines virtuelles du groupe de machines virtuelles identiques.
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 la machine virtuelle/vmSS avec un disque de système d’exploitation éphémère.

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
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

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

Exemples

VirtualMachineScaleSet_Reimage_MaximumSet_Gen
VirtualMachineScaleSet_Reimage_MinimumSet_Gen

VirtualMachineScaleSet_Reimage_MaximumSet_Gen

Sample Request

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

{
  "instanceIds": [
    "aaaaaaaaaa"
  ],
  "forceUpdateOSDiskForEphemeral": true,
  "tempDisk": true
}

Sample Response

Status code:
200
Status code:
202 
location: https://foo.com/operationstatus

VirtualMachineScaleSet_Reimage_MinimumSet_Gen

Sample Request

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

Sample Response

Status code:
200
Status code:
202 
location: https://foo.com/operationstatus

Définitions

Nom Description
ApiError

Erreur d’API.
ApiErrorBase

Base d’erreurs de l’API.
CloudError

Réponse d’erreur du service de calcul.
InnerError

Détails internes de l’erreur.
OSProfileProvisioningData

Paramètres supplémentaires pour la réimagination d’une machine virtuelle non éphémère.
VirtualMachineScaleSetReimageParameters

Décrit les paramètres de réimage d’un groupe de machines virtuelles identiques.

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 de l’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 internes de l’erreur.

Nom Type Description
errordetail

string

Message d’erreur interne ou vidage d’exception.
exceptiontype

string

Type d'exception.

OSProfileProvisioningData

Paramètres supplémentaires pour la réimagination d’une machine virtuelle 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 des 4 conditions 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.

VirtualMachineScaleSetReimageParameters

Décrit les paramètres de réimage d’un groupe de machines virtuelles identiques.

Nom Type Description
exactVersion

string

Spécifie, en nombre décimal, la version dans 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
instanceIds

string[]

Le groupe de machines virtuelles identiques instance ids. L’omission du groupe de machines virtuelles identiques instance id entraîne l’exécution de l’opération sur toutes les machines virtuelles du groupe de machines virtuelles identiques.
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 la machine virtuelle/vmSS avec un disque de système d’exploitation éphémère.