Virtual Machine Scale Sets - Reimage

Servicio:: Compute

Versión de la API:: 2025-11-01

Cambia la imagen (actualizar el sistema operativo) una o varias máquinas virtuales de un conjunto de escalado de máquinas virtuales que no tienen un disco de sistema operativo efímero, para las máquinas virtuales que tienen un disco de sistema operativo efímero, la máquina virtual se restablece al estado inicial.

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

Parámetros de identificador URI

Nombre	En	Requerido	Tipo	Description
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas.
subscriptionId	path	True	string minLength: 1	Identificador de la suscripción de destino.
vmScaleSetName	path	True	string	Nombre del conjunto de escalado de máquinas virtuales.
api-version	query	True	string minLength: 1	Versión de API que se usará para la operación.

Cuerpo de la solicitud

Nombre	Tipo	Description
exactVersion	string	Especifica en el número decimal, la versión en la que se debe volver a crear la imagen del disco del sistema operativo. Si no se proporciona la versión exacta, el disco del sistema operativo se vuelve a crear una imagen en la versión existente del disco del sistema operativo.
forceUpdateOSDiskForEphemeral	boolean	Parámetro para forzar la actualización del disco del sistema operativo efímero para una máquina virtual de conjunto de escalado de máquinas virtuales
instanceIds	string[]	Identificadores de instancia del conjunto de escalado de máquinas virtuales. Si se omiten los identificadores de instancia del conjunto de escalado de máquinas virtuales, se realizará la operación en todas las máquinas virtuales del conjunto de escalado de máquinas virtuales.
osProfile	OSProfileProvisioningData	Especifica la información necesaria para volver a crear una imagen del disco del sistema operativo no efímero.
tempDisk	boolean	Especifica si se va a cambiar la imagen del disco temporal. Valor predeterminado: falso. Nota: Este parámetro temp disk reimage solo se admite para VM/VMSS con disco del sistema operativo efímero.

Respuestas

Nombre	Tipo	Description
200 OK		La solicitud se ha realizado correctamente.
202 Accepted		Operación de recursos aceptada. Encabezados Location: string Retry-After: integer
Other Status Codes	CloudError	Una respuesta de error inesperada.

Nombre

Tipo

Description

200 OK

La solicitud se ha realizado correctamente.

202 Accepted

Operación de recursos aceptada.

Encabezados

Location: string
Retry-After: integer

Other Status Codes

CloudError

Una respuesta de error inesperada.

Seguridad

azure_auth

Azure Active Directory OAuth2 Flow.

Tipo: oauth2
Flujo: implicit
Dirección URL de autorización: https://login.microsoftonline.com/common/oauth2/authorize

Ámbitos

Nombre	Description
user_impersonation	suplantar la cuenta de usuario

Ejemplos

VirtualMachineScaleSet_Reimage_MaximumSet_Gen

VirtualMachineScaleSet_Reimage_MinimumSet_Gen

VirtualMachineScaleSet_Reimage_MaximumSet_Gen

Solicitud de ejemplo

HTTP

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

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

Respuesta de muestra

status code:: 200

status code:: 202

location: https://foo.com/operationstatus

VirtualMachineScaleSet_Reimage_MinimumSet_Gen

Solicitud de ejemplo

HTTP

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

Respuesta de muestra

status code:: 200

status code:: 202

location: https://foo.com/operationstatus

Definiciones

Nombre	Description
ApiError	Error de API.
ApiErrorBase	Base de errores de API.
CloudError	Una respuesta de error del servicio de proceso.
InnerError	Detalles del error interno.
OSProfileProvisioningData	Parámetros adicionales para Reimaging Non-Ephemeral Virtual Machine( Reimaging Non-Ephemeral Virtual Machine).
VirtualMachineScaleSetReimageParameters	Describe los parámetros reimage de una máquina virtual del conjunto de escalado de máquinas virtuales.

ApiError

Objeto

Error de API.

Nombre	Tipo	Description
code	string	Código de error.
details	ApiErrorBase[]	Detalles del error de la API
innererror	InnerError	El error interno de la API
message	string	El mensaje de error.
target	string	Destino del error concreto.

ApiErrorBase

Objeto

Base de errores de API.

Nombre	Tipo	Description
code	string	Código de error.
message	string	El mensaje de error.
target	string	Destino del error concreto.

CloudError

Objeto

Una respuesta de error del servicio de proceso.

Nombre	Tipo	Description
error	ApiError	Error de API.

InnerError

Objeto

Detalles del error interno.

Nombre	Tipo	Description
errordetail	string	El mensaje de error interno o el volcado de excepción.
exceptiontype	string	Tipo de la excepción.

OSProfileProvisioningData

Objeto

Parámetros adicionales para Reimaging Non-Ephemeral Virtual Machine( Reimaging Non-Ephemeral Virtual Machine).

Nombre	Tipo	Description
adminPassword	string (password)	Especifica la contraseña de la cuenta de administrador. Longitud mínima (Windows): 8 caracteres Longitud mínima (Linux): 6 caracteres Longitud máxima (Windows): 123 caracteres Longitud máxima (Linux): 72 caracteres requisitos de complejidad: 3 de 4 condiciones siguientes deben cumplirse. Tiene caracteres inferiores Tiene caracteres superiores Tiene un dígito Tiene un carácter especial (coincidencia regex [\W_]) Valores no permitidos: "abc@123", "P@$$w 0rd", "P@ssw0rd", "P@ssword123", "Pa$$word", "pass@word1", "¡Contraseña!", "Contraseña1", "Contraseña22", "¡Te amo!" Para restablecer la contraseña, consulta Cómo restablecer el servicio Remote Desktop o su contraseña de inicio de sesión en una máquina virtual Windows Para restablecer la contraseña root, consulte Gestionar usuarios, SSH y comprobar o reparar discos en Azure máquinas virtuales Linux usando la extensión VMAccess
customData	string	Especifica una cadena codificada en base 64 de datos personalizados. La cadena codificada en base 64 se descodifica en una matriz binaria que se guarda como un archivo en la máquina virtual. La longitud máxima de la matriz binaria es de 65535 bytes. Nota: No pase secretos ni contraseñas en la propiedad customData. Esta propiedad no se puede actualizar después de crear la máquina virtual. La propiedad customData se pasa a la máquina virtual para guardarla como un archivo, para obtener más información, consulte Datos personalizados en máquinas virtuales de Azure. Si usa cloud-init para la máquina virtual Linux, consulte Uso de cloud-init para personalizar una máquina virtual Linux durante la creación.

VirtualMachineScaleSetReimageParameters

Objeto

Describe los parámetros reimage de una máquina virtual del conjunto de escalado de máquinas virtuales.

Nombre	Tipo	Description
exactVersion	string	Especifica en el número decimal, la versión en la que se debe volver a crear la imagen del disco del sistema operativo. Si no se proporciona la versión exacta, el disco del sistema operativo se vuelve a crear una imagen en la versión existente del disco del sistema operativo.
forceUpdateOSDiskForEphemeral	boolean	Parámetro para forzar la actualización del disco del sistema operativo efímero para una máquina virtual de conjunto de escalado de máquinas virtuales
instanceIds	string[]	Identificadores de instancia del conjunto de escalado de máquinas virtuales. Si se omiten los identificadores de instancia del conjunto de escalado de máquinas virtuales, se realizará la operación en todas las máquinas virtuales del conjunto de escalado de máquinas virtuales.
osProfile	OSProfileProvisioningData	Especifica la información necesaria para volver a crear una imagen del disco del sistema operativo no efímero.
tempDisk	boolean	Especifica si se va a cambiar la imagen del disco temporal. Valor predeterminado: falso. Nota: Este parámetro temp disk reimage solo se admite para VM/VMSS con disco del sistema operativo efímero.