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 |
|---|---|---|---|---|
|
instance
|
path | True |
string |
Identificador de instancia de la máquina virtual. |
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
Nombre del grupo de recursos. El nombre distingue mayúsculas de minúsculas. |
|
subscription
|
path | True |
string minLength: 1 |
Identificador de la suscripción de destino. |
|
vm
|
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 |
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
|
|
| Other Status Codes |
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
|
Virtual |
|
Virtual |
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
Respuesta de muestra
location: https://foo.com/operationstatus
Definiciones
| Nombre | Description |
|---|---|
|
Api |
Error de API. |
|
Api |
Base de errores de API. |
|
Cloud |
Una respuesta de error del servicio de proceso. |
|
Inner |
Detalles del error interno. |
|
OSProfile |
Parámetros adicionales para volver a crear imágenes de máquinas virtuales no efímeras. |
|
Virtual |
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 |
Detalles del error de la API |
|
| 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 |
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. |
| 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 |
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. |