Compartir a través de


Virtual Machine Scale Set VMs - Reimage

Cambia la imagen inicial (actualización del sistema operativo) de una máquina virtual específica en un conjunto de escalado de máquinas virtuales.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
instanceId
path True

string

Identificador de instancia de la máquina virtual.

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

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 de reimagen de disco temporal solo se admite para VM/VMSS con disco de 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.

Seguridad

azure_auth

Flujo de OAuth2 de Azure Active Directory.

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

VirtualMachineScaleSetVM_Reimage_MaximumSet_Gen
VirtualMachineScaleSetVM_Reimage_MinimumSet_Gen

VirtualMachineScaleSetVM_Reimage_MaximumSet_Gen

Solicitud de ejemplo

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

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

Respuesta de muestra

location: https://foo.com/operationstatus

VirtualMachineScaleSetVM_Reimage_MinimumSet_Gen

Solicitud de ejemplo

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

Respuesta de muestra

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 volver a crear imágenes de máquinas virtuales no efímeras.

VirtualMachineScaleSetVMReimageParameters

Describe los parámetros de recreación de la imagen inicial de una máquina virtual del conjunto de escalado de máquinas virtuales.

ApiError

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

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

Una respuesta de error del servicio de proceso.

Nombre Tipo Description
error

ApiError

Error de API.

InnerError

Detalles del error interno.

Nombre Tipo Description
errordetail

string

El mensaje de error interno o el volcado de excepción.

exceptiontype

string

El tipo de excepción.

OSProfileProvisioningData

Parámetros adicionales para volver a crear imágenes de máquinas virtuales no efímeras.

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", "Password!", "Password1", "Password22", "iloveyou!"

Para restablecer la contraseña, consulte restablecimiento del servicio Escritorio remoto o su contraseña de inicio de sesión en una máquina virtual Windows

Para restablecer la contraseña raíz, consulte Administración de usuarios, SSH y comprobación o reparación de discos en máquinas virtuales Linux de Azure mediante 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.

VirtualMachineScaleSetVMReimageParameters

Describe los parámetros de recreación de la imagen inicial 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

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 de reimagen de disco temporal solo se admite para VM/VMSS con disco de sistema operativo efímero.