Virtual Machines - Attach Detach Data Disks

Conecte y desasocie discos de datos hacia o desde la máquina virtual.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/attachDetachDataDisks?api-version=2026-04-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.

vmName
path True

string

El nombre de la máquina virtual.

api-version
query True

string

minLength: 1

Versión de la API que se va a usar para esta operación.

Cuerpo de la solicitud

Nombre Tipo Description
dataDisksToAttach

DataDisksToAttach[]

Lista de discos de datos administrados que se van a conectar.

dataDisksToDetach

DataDisksToDetach[]

Lista de discos de datos administrados que se van a desasociar.

Respuestas

Nombre Tipo Description
200 OK

StorageProfile

Operación de Azure completada con éxito.

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 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 su cuenta de usuario

Ejemplos

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen
VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

Solicitud de ejemplo

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaaaaaaaaa/attachDetachDataDisks?api-version=2026-04-01

{
  "dataDisksToAttach": [
    {
      "lun": 1,
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d",
      "diskEncryptionSet": {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
      },
      "caching": "ReadOnly",
      "deleteOption": "Delete",
      "writeAcceleratorEnabled": true
    },
    {
      "lun": 2,
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e",
      "diskEncryptionSet": {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
      },
      "caching": "ReadWrite",
      "deleteOption": "Detach",
      "writeAcceleratorEnabled": false
    }
  ],
  "dataDisksToDetach": [
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x",
      "detachOption": "ForceDetach"
    },
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_4_disk4_4d4e784bdafa49baa780eb2d256ff41z",
      "detachOption": "ForceDetach"
    }
  ]
}

Respuesta de muestra

location: https://foo.com/operationstatus
{
  "imageReference": {
    "publisher": "MicrosoftWindowsServer",
    "offer": "WindowsServer",
    "sku": "2016-Datacenter",
    "version": "latest"
  },
  "osDisk": {
    "osType": "Windows",
    "name": "myOsDisk",
    "createOption": "FromImage",
    "caching": "ReadWrite",
    "managedDisk": {
      "storageAccountType": "Premium_LRS",
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myOsDisk"
    },
    "diskSizeGB": 30
  },
  "dataDisks": [
    {
      "lun": 1,
      "name": "vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d",
      "createOption": "Attach",
      "caching": "ReadOnly",
      "managedDisk": {
        "storageAccountType": "Premium_LRS",
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d",
        "diskEncryptionSet": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
        }
      },
      "deleteOption": "Delete",
      "diskSizeGB": 30,
      "writeAcceleratorEnabled": true
    },
    {
      "lun": 2,
      "name": "vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e",
      "createOption": "Attach",
      "caching": "ReadWrite",
      "managedDisk": {
        "storageAccountType": "Premium_LRS",
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e",
        "diskEncryptionSet": {
          "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
        }
      },
      "deleteOption": "Detach",
      "diskSizeGB": 100,
      "writeAcceleratorEnabled": false
    }
  ]
}
location: https://foo.com/operationstatus

VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

Solicitud de ejemplo

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/azure-vm/attachDetachDataDisks?api-version=2026-04-01

{
  "dataDisksToAttach": [
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"
    }
  ],
  "dataDisksToDetach": [
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x"
    }
  ]
}

Respuesta de muestra

location: https://foo.com/operationstatus
{
  "imageReference": {
    "publisher": "MicrosoftWindowsServer",
    "offer": "WindowsServer",
    "sku": "2016-Datacenter",
    "version": "latest"
  },
  "osDisk": {
    "osType": "Windows",
    "name": "myOsDisk",
    "createOption": "FromImage",
    "caching": "ReadWrite",
    "managedDisk": {
      "storageAccountType": "Premium_LRS",
      "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myOsDisk"
    },
    "diskSizeGB": 30
  },
  "dataDisks": [
    {
      "lun": 0,
      "name": "vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d",
      "createOption": "Attach",
      "caching": "ReadWrite",
      "managedDisk": {
        "storageAccountType": "Premium_LRS",
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"
      },
      "diskSizeGB": 30
    }
  ]
}
location: https://foo.com/operationstatus

Definiciones

Nombre Description
AdditionalDiskProperties

Especifica propiedades adicionales para un disco gestionado que pueden establecerse en el momento de la creación implícita del disco.

ApiEntityReference

Referencia de entidad de API.

ApiError

Error de API.

ApiErrorBase

Base de errores de api.

AttachDetachDataDisksRequest

Especifica la entrada para adjuntar y desasociar una lista de discos de datos administrados.

AvailabilityPolicyDiskDelay

Determina cómo controlar los discos con E/S lentas.

CachingTypes

Especifica los requisitos de almacenamiento en caché. Los valores posibles son: None,ReadOnly,ReadWrite. Los valores predeterminados son: Ninguno para el almacenamiento estándar. ReadOnly para el almacenamiento Premium

CloudError

Respuesta de error del servicio Compute.

DataDisk

Describe un disco de datos.

DataDisksToAttach

Describe el disco de datos que se va a conectar.

DataDisksToDetach

Describe el disco de datos que se va a desasociar.

DiffDiskOptions

Especifica la opción de disco efímero para el disco del sistema operativo.

DiffDiskPlacement

Especifica la ubicación del disco efímero para el disco del sistema operativo. El usuario puede usar esta propiedad en la solicitud para elegir la ubicación, es decir, el disco de caché, el disco de recursos o el espacio en disco nvme para el aprovisionamiento de discos del sistema operativo efímero. Para obtener más información sobre los requisitos de tamaño de disco del sistema operativo efímero, consulte Requisitos de tamaño de disco del sistema operativo efímero para máquinas virtuales Windows en https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements y máquinas virtuales Linux en https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Versión mínima de api para NvmeDisk: 2024-03-01.

DiffDiskSettings

Describe los parámetros de la configuración de disco efímero que se puede especificar para el disco del sistema operativo. Nota: La configuración del disco efímero solo se puede especificar para el disco administrado.

DiskApiVersion

Especifica la versión de la API de disco utilizada al aplicar propiedades de disco adicionales a discos gestionados. El valor debe estar en el formato AAAAA-MM-DD.

DiskAvailabilityPolicy

En caso de un problema de disponibilidad o conectividad con el disco, especifica el comportamiento de tu máquina virtual.

DiskControllerTypes

Especifica el tipo de controlador de disco configurado para la máquina virtual y VirtualMachineScaleSet. Esta propiedad solo es compatible con las máquinas virtuales cuyo disco del sistema operativo y la SKU de máquina virtual admiten la generación 2 (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2), compruebe la funcionalidad HyperVGenerations devuelta como parte de las funcionalidades de SKU de máquina virtual en la respuesta de la API de SKU de Microsoft.Compute para la región contiene V2 (https://docs.microsoft.com/rest/api/compute/resourceskus/list). Para obtener más información sobre los tipos de controlador de disco admitidos, consulte https://aka.ms/azure-diskcontrollertypes.

DiskCreateOptionTypes

Especifica cómo se debe crear el disco de máquina virtual. Los valores posibles son Adjuntar: Este valor se usa cuando se usa un disco especializado para crear la máquina virtual. FromImage: Este valor se usa cuando se usa una imagen para crear la máquina virtual. Si usa una imagen de plataforma, también debe usar el elemento imageReference descrito anteriormente. Si usa una imagen de Marketplace, también debe usar el elemento plan descrito anteriormente. Vacío: Este valor se usa al crear un disco de datos vacío. Copiar: Este valor se usa para crear un disco de datos a partir de una instantánea u otro disco. Restaurar: este valor se usa para crear un disco de datos a partir de un punto de restauración de disco.

DiskDeleteOptionTypes

Especifica el comportamiento del disco administrado cuando se elimina la máquina virtual, por ejemplo, si el disco administrado se elimina o se desasocia. Los valores admitidos son: Delete. Si se usa este valor, el disco administrado se elimina cuando se elimina la máquina virtual. Separar. Si se usa este valor, el disco administrado se conserva después de eliminar la máquina virtual. Versión mínima de api: 2021-03-01.

DiskDetachOptionTypes

Especifica el comportamiento de desasociación que se va a usar al desasociar un disco o que ya está en proceso de desasociación de la máquina virtual. Los valores admitidos son: ForceDetach. detachOption: ForceDetach solo se aplica a los discos de datos administrados. Si un intento anterior de desasociación del disco de datos no se completó debido a un error inesperado de la máquina virtual y el disco todavía no se libera, use la opción forzar la desasociación como última opción de recurso para separar el disco forzadamente de la máquina virtual. Es posible que todas las escrituras no se hayan vaciado al usar este comportamiento de desasociación. Esta característica aún está en versión preliminar. Para forzar la desasociación de una actualización del disco de datos aBeDetached a "true" junto con la configuración de detachOption: "ForceDetach".

DiskEncryptionSetParameters

Describe el parámetro del identificador de recurso del conjunto de cifrado de disco administrado por el cliente que se puede especificar para el disco. Nota: El identificador de recurso del conjunto de cifrado de disco solo se puede especificar para el disco administrado. Consulte https://aka.ms/mdssewithcmkoverview para obtener más información.

DiskEncryptionSettings

Describe una configuración de cifrado para un disco

ImageReference

Especifica información sobre la imagen que se va a usar. Puede especificar información sobre imágenes de plataforma, imágenes de Marketplace o imágenes de máquina virtual. Este elemento es necesario cuando desea usar una imagen de plataforma, una imagen de Marketplace o una imagen de máquina virtual, pero no se usa en otras operaciones de creación. NOTA: El publicador y la oferta de referencia de imágenes solo se pueden establecer al crear el conjunto de escalado.

InnerError

Detalles del error interno.

KeyVaultKeyReference

Describe una referencia a la clave de Key Vault.

KeyVaultSecretReference

Describe una referencia al secreto de Key Vault.

ManagedDiskParameters

Parámetros de un disco administrado.

ManagedDiskProperties

Especifica las propiedades de un disco gestionado que pueden establecerse en el momento de la creación implícita del disco.

NetworkAccessPolicy

Directiva para acceder al disco a través de la red.

OperatingSystemTypes

Esta propiedad permite especificar el tipo del sistema operativo que se incluye en el disco si crea una máquina virtual a partir de una imagen personalizada. Los valores posibles son: Windows,Linux.

OSDisk

Especifica información sobre el disco del sistema operativo utilizado por la máquina virtual. Para más información sobre los discos, consulte Acerca de discos y discos duros virtuales para máquinas virtuales de Azure.

SecurityEncryptionTypes

Especifica encryptionType del disco administrado. Se establece en DiskWithVMGuestState para el cifrado del disco administrado junto con el blob VMGuestState, VMGuestStateOnly para el cifrado de solo el blob VMGuestState y NonPersistedTPM para no conservar el estado de firmware en el blob VMGuestState. Nota: Solo se puede establecer para máquinas virtuales confidenciales.

StorageAccountTypes

Especifica el tipo de cuenta de almacenamiento para el disco administrado. El tipo de cuenta de almacenamiento en disco del sistema operativo administrado solo se puede establecer al crear el conjunto de escalado. NOTA: UltraSSD_LRS solo se pueden usar con discos de datos. No se puede usar con el disco del sistema operativo. Standard_LRS usa HDD estándar. StandardSSD_LRS usa SSD estándar. Premium_LRS usa SSD Premium. UltraSSD_LRS usa disco Ultra. Premium_ZRS usa almacenamiento con redundancia de zona SSD Premium. StandardSSD_ZRS usa el almacenamiento con redundancia de zona SSD estándar. Para obtener más información sobre los discos compatibles con máquinas virtuales Windows, consulte https://docs.microsoft.com/azure/virtual-machines/windows/disks-types y, para máquinas virtuales Linux, consulte https://docs.microsoft.com/azure/virtual-machines/linux/disks-types

StorageFaultDomainAlignmentType

Especifica el tipo de alineación del dominio de fallo de almacenamiento para el disco.

StorageProfile

Especifica la configuración de almacenamiento de los discos de máquina virtual.

SubResource
VirtualHardDisk

Describe el URI de un disco.

VMDiskSecurityProfile

Especifica la configuración del perfil de seguridad para el disco administrado. Nota: Solo se puede establecer para máquinas virtuales confidenciales.

AdditionalDiskProperties

Especifica propiedades adicionales para un disco gestionado que pueden establecerse en el momento de la creación implícita del disco.

Nombre Tipo Description
managedDiskProperties

ManagedDiskProperties

Especifica las propiedades gestionadas del disco que pueden establecerse en el momento de la creación implícita del disco.

ApiEntityReference

Referencia de entidad de API.

Nombre Tipo Description
id

string

Identificador de recurso de ARM en forma de /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

ApiError

Error de API.

Nombre Tipo Description
code

string

Código de error.

details

ApiErrorBase[]

Detalles del error de api

innererror

InnerError

Error interno de 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.

AttachDetachDataDisksRequest

Especifica la entrada para adjuntar y desasociar una lista de discos de datos administrados.

Nombre Tipo Description
dataDisksToAttach

DataDisksToAttach[]

Lista de discos de datos administrados que se van a conectar.

dataDisksToDetach

DataDisksToDetach[]

Lista de discos de datos administrados que se van a desasociar.

AvailabilityPolicyDiskDelay

Determina cómo controlar los discos con E/S lentas.

Valor Description
None

Por defecto se comporta sin especificar la política de disponibilidad, que es reiniciar la máquina virtual tras una entrada de salida lenta en disco.

AutomaticReattach

En caso de fallo en la E/S del disco o respuesta lenta, intenta desacoplar y volver a conectar el disco.

CachingTypes

Especifica los requisitos de almacenamiento en caché. Los valores posibles son: None,ReadOnly,ReadWrite. Los valores predeterminados son: Ninguno para el almacenamiento estándar. ReadOnly para el almacenamiento Premium

Valor Description
None
ReadOnly
ReadWrite

CloudError

Respuesta de error del servicio Compute.

Nombre Tipo Description
error

ApiError

Error de API.

DataDisk

Describe un disco de datos.

Nombre Tipo Description
caching

CachingTypes

Especifica los requisitos de almacenamiento en caché. Los valores posibles son: None,ReadOnly,ReadWrite. El comportamiento predeterminado es: Ninguno para el almacenamiento estándar. ReadOnly para Premium Storage.

createOption

DiskCreateOptionTypes

Especifica cómo se debe crear el disco de máquina virtual. Los valores posibles son Adjuntar: Este valor se usa cuando se usa un disco especializado para crear la máquina virtual. FromImage: Este valor se usa cuando se usa una imagen para crear el disco de datos de la máquina virtual. Si usa una imagen de plataforma, también debe usar el elemento imageReference descrito anteriormente. Si usa una imagen de Marketplace, también debe usar el elemento plan descrito anteriormente. Vacío: Este valor se usa al crear un disco de datos vacío. Copiar: Este valor se usa para crear un disco de datos a partir de una instantánea u otro disco. Restaurar: este valor se usa para crear un disco de datos a partir de un punto de restauración de disco.

deleteOption

DiskDeleteOptionTypes

Especifica si se debe eliminar o desasociar el disco de datos tras la eliminación de la máquina virtual. Los valores posibles son: Delete. Si se usa este valor, el disco de datos se elimina cuando se elimina la máquina virtual. Separar. Si se usa este valor, el disco de datos se conserva después de eliminar la máquina virtual. El valor predeterminado se establece en Desasociar.

detachOption

DiskDetachOptionTypes

Especifica el comportamiento de desasociación que se va a usar al desasociar un disco o que ya está en proceso de desasociación de la máquina virtual. Valores admitidos: ForceDetach. detachOption: ForceDetach solo se aplica a discos de datos administrados. Si un intento anterior de desasociación del disco de datos no se completó debido a un error inesperado de la máquina virtual y el disco todavía no se libera, use la opción forzar la desasociación como última opción de recurso para separar el disco forzadamente de la máquina virtual. Es posible que todas las escrituras no se hayan vaciado al usar este comportamiento de desasociación. Esta característica aún está en versión preliminar. Para forzar la desasociación de una actualización del disco de datos aBeDetached a "true" junto con la configuración de detachOption: "ForceDetach".

diskIOPSReadWrite

integer (int64)

Especifica el Read-Write IOPS del disco administrado cuando se UltraSSD_LRS StorageAccountType.

diskMBpsReadWrite

integer (int64)

Especifica el ancho de banda en MB por segundo para el disco administrado cuando StorageAccountType es UltraSSD_LRS.

diskSizeGB

integer (int32)

Especifica el tamaño de un disco de datos vacío en gigabytes. Este elemento se puede usar para sobrescribir el tamaño del disco en una imagen de máquina virtual. La propiedad 'diskSizeGB' es el número de bytes x 1024^3 para el disco y el valor no puede ser mayor que 1023.

image

VirtualHardDisk

Disco duro virtual de la imagen de usuario de origen. El disco duro virtual se copiará antes de conectarse a la máquina virtual. Si se proporciona SourceImage, el disco duro virtual de destino no debe existir.

lun

integer (int32)

Especifica el número de unidad lógica del disco de datos. Este valor se usa para identificar discos de datos dentro de la máquina virtual y, por tanto, debe ser único para cada disco de datos conectado a una máquina virtual.

managedDisk

ManagedDiskParameters

Parámetros de disco administrado.

name

string

Nombre del disco.

sourceResource

ApiEntityReference

Identificador del recurso de origen. Puede ser una instantánea o un punto de restauración de disco desde el que crear un disco.

storageFaultDomainAlignment

StorageFaultDomainAlignmentType

Especifica el tipo de alineación del dominio de fallo de almacenamiento para el disco.

toBeDetached

boolean

Especifica si el disco de datos está en proceso de desasociamiento de VirtualMachine/VirtualMachineScaleset

vhd

VirtualHardDisk

Disco duro virtual.

writeAcceleratorEnabled

boolean

Especifica si writeAccelerator debe estar habilitado o deshabilitado en el disco.

DataDisksToAttach

Describe el disco de datos que se va a conectar.

Nombre Tipo Description
caching

CachingTypes

Especifica los requisitos de almacenamiento en caché. Los valores posibles son: None,ReadOnly,ReadWrite. El comportamiento predeterminado es: Ninguno para el almacenamiento estándar. ReadOnly para Premium Storage.

deleteOption

DiskDeleteOptionTypes

Especifica si se debe eliminar o desasociar el disco de datos tras la eliminación de la máquina virtual. Los valores posibles son: Delete. Si se usa este valor, el disco de datos se elimina cuando se elimina la máquina virtual. Separar. Si se usa este valor, el disco de datos se conserva después de eliminar la máquina virtual. El valor predeterminado se establece en Desasociar.

diskEncryptionSet

DiskEncryptionSetParameters

Especifica el identificador de recurso del conjunto de cifrado de disco administrado del cliente para el disco administrado.

diskId

string

Identificador del disco de datos administrado.

lun

integer (int32)

Número de unidad lógica del disco de datos. Este valor se usa para identificar discos de datos dentro de la máquina virtual y, por tanto, debe ser único para cada disco de datos conectado a una máquina virtual. Si no se especifica, se asignaría automáticamente lun.

writeAcceleratorEnabled

boolean

Especifica si writeAccelerator debe estar habilitado o deshabilitado en el disco.

DataDisksToDetach

Describe el disco de datos que se va a desasociar.

Nombre Tipo Description
detachOption

DiskDetachOptionTypes

Opciones admitidas disponibles para desasociar un disco de una máquina virtual. Consulte La referencia de objetos DetachOption para obtener más detalles.

diskId

string

Identificador del disco de datos administrado.

DiffDiskOptions

Especifica la opción de disco efímero para el disco del sistema operativo.

Valor Description
Local

DiffDiskPlacement

Especifica la ubicación del disco efímero para el disco del sistema operativo. El usuario puede usar esta propiedad en la solicitud para elegir la ubicación, es decir, el disco de caché, el disco de recursos o el espacio en disco nvme para el aprovisionamiento de discos del sistema operativo efímero. Para obtener más información sobre los requisitos de tamaño de disco del sistema operativo efímero, consulte Requisitos de tamaño de disco del sistema operativo efímero para máquinas virtuales Windows en https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements y máquinas virtuales Linux en https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Versión mínima de api para NvmeDisk: 2024-03-01.

Valor Description
CacheDisk
ResourceDisk
NvmeDisk

DiffDiskSettings

Describe los parámetros de la configuración de disco efímero que se puede especificar para el disco del sistema operativo. Nota: La configuración del disco efímero solo se puede especificar para el disco administrado.

Nombre Tipo Description
enableFullCaching

boolean

Especifica si habilitar o no la caché completa para esta VM, lo que almacenará en caché el disco del sistema operativo localmente en el host y hará que esta VM sea más resistente a caídas de almacenamiento

option

DiffDiskOptions

Especifica la configuración del disco efímero para el disco del sistema operativo.

placement

DiffDiskPlacement

Especifica la ubicación del disco efímero para el disco del sistema operativo. Los valores posibles son: CacheDisk,ResourceDisk,NvmeDisk. El comportamiento predeterminado es: CacheDisk si se configura uno para el tamaño de la máquina virtual en caso contrario, se usa resourceDisk o nvmeDisk. Consulte la documentación sobre el tamaño de la máquina virtual Windows en https://docs.microsoft.com/azure/virtual-machines/windows/sizes y máquina virtual Linux en https://docs.microsoft.com/azure/virtual-machines/linux/sizes para comprobar qué tamaños de máquina virtual expone un disco de caché. Versión mínima de api para NvmeDisk: 2024-03-01.

DiskApiVersion

Especifica la versión de la API de disco utilizada al aplicar propiedades de disco adicionales a discos gestionados. El valor debe estar en el formato AAAAA-MM-DD.

Valor Description
2025-01-02

La versión de la API Disk RP de 2025-01-02.

2026-03-02

Versión de la API de Disk RP 2026-03-02.

DiskAvailabilityPolicy

En caso de un problema de disponibilidad o conectividad con el disco, especifica el comportamiento de tu máquina virtual.

Nombre Tipo Description
actionOnDiskDelay

AvailabilityPolicyDiskDelay

Determina cómo controlar los discos con E/S lentas.

DiskControllerTypes

Especifica el tipo de controlador de disco configurado para la máquina virtual y VirtualMachineScaleSet. Esta propiedad solo es compatible con las máquinas virtuales cuyo disco del sistema operativo y la SKU de máquina virtual admiten la generación 2 (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2), compruebe la funcionalidad HyperVGenerations devuelta como parte de las funcionalidades de SKU de máquina virtual en la respuesta de la API de SKU de Microsoft.Compute para la región contiene V2 (https://docs.microsoft.com/rest/api/compute/resourceskus/list). Para obtener más información sobre los tipos de controlador de disco admitidos, consulte https://aka.ms/azure-diskcontrollertypes.

Valor Description
SCSI
NVMe

DiskCreateOptionTypes

Especifica cómo se debe crear el disco de máquina virtual. Los valores posibles son Adjuntar: Este valor se usa cuando se usa un disco especializado para crear la máquina virtual. FromImage: Este valor se usa cuando se usa una imagen para crear la máquina virtual. Si usa una imagen de plataforma, también debe usar el elemento imageReference descrito anteriormente. Si usa una imagen de Marketplace, también debe usar el elemento plan descrito anteriormente. Vacío: Este valor se usa al crear un disco de datos vacío. Copiar: Este valor se usa para crear un disco de datos a partir de una instantánea u otro disco. Restaurar: este valor se usa para crear un disco de datos a partir de un punto de restauración de disco.

Valor Description
FromImage
Empty
Attach
Copy
Restore

DiskDeleteOptionTypes

Especifica el comportamiento del disco administrado cuando se elimina la máquina virtual, por ejemplo, si el disco administrado se elimina o se desasocia. Los valores admitidos son: Delete. Si se usa este valor, el disco administrado se elimina cuando se elimina la máquina virtual. Separar. Si se usa este valor, el disco administrado se conserva después de eliminar la máquina virtual. Versión mínima de api: 2021-03-01.

Valor Description
Delete
Detach

DiskDetachOptionTypes

Especifica el comportamiento de desasociación que se va a usar al desasociar un disco o que ya está en proceso de desasociación de la máquina virtual. Los valores admitidos son: ForceDetach. detachOption: ForceDetach solo se aplica a los discos de datos administrados. Si un intento anterior de desasociación del disco de datos no se completó debido a un error inesperado de la máquina virtual y el disco todavía no se libera, use la opción forzar la desasociación como última opción de recurso para separar el disco forzadamente de la máquina virtual. Es posible que todas las escrituras no se hayan vaciado al usar este comportamiento de desasociación. Esta característica aún está en versión preliminar. Para forzar la desasociación de una actualización del disco de datos aBeDetached a "true" junto con la configuración de detachOption: "ForceDetach".

Valor Description
ForceDetach

DiskEncryptionSetParameters

Describe el parámetro del identificador de recurso del conjunto de cifrado de disco administrado por el cliente que se puede especificar para el disco. Nota: El identificador de recurso del conjunto de cifrado de disco solo se puede especificar para el disco administrado. Consulte https://aka.ms/mdssewithcmkoverview para obtener más información.

Nombre Tipo Description
id

string

Identificador de recurso

DiskEncryptionSettings

Describe una configuración de cifrado para un disco

Nombre Tipo Description
diskEncryptionKey

KeyVaultSecretReference

Especifica la ubicación de la clave de cifrado de disco, que es un secreto de Key Vault.

enabled

boolean

Especifica si se debe habilitar el cifrado de disco en la máquina virtual.

keyEncryptionKey

KeyVaultKeyReference

Especifica la ubicación de la clave de cifrado de claves en Key Vault.

ImageReference

Especifica información sobre la imagen que se va a usar. Puede especificar información sobre imágenes de plataforma, imágenes de Marketplace o imágenes de máquina virtual. Este elemento es necesario cuando desea usar una imagen de plataforma, una imagen de Marketplace o una imagen de máquina virtual, pero no se usa en otras operaciones de creación. NOTA: El publicador y la oferta de referencia de imágenes solo se pueden establecer al crear el conjunto de escalado.

Nombre Tipo Description
communityGalleryImageId

string

Se especificó el identificador único de la imagen de la galería de la comunidad para la implementación de la máquina virtual. Esto se puede capturar desde la llamada GET de la imagen de la galería de la comunidad.

exactVersion

string

Especifica en números decimales, la versión de la imagen de plataforma o la imagen de Marketplace que se usa para crear la máquina virtual. Este campo de solo lectura difiere de "version", solo si el valor especificado en el campo "version" es "latest".

id

string

Identificador de recurso

offer

string

Especifica la oferta de la imagen de plataforma o la imagen de Marketplace que se usa para crear la máquina virtual.

publisher

string

Publicador de imágenes.

sharedGalleryImageId

string

Se especificó el identificador único de la imagen de la galería compartida para la implementación de la máquina virtual. Esto se puede capturar desde la llamada GET de la imagen de la galería compartida.

sku

string

SKU de imagen.

version

string

Especifica la versión de la imagen de plataforma o la imagen de Marketplace que se usa para crear la máquina virtual. Los formatos permitidos son Major.Minor.Build o "latest". Major, Minor y Build son números decimales. Especifique "latest" para usar la versión más reciente de una imagen disponible en tiempo de implementación. Incluso si usa "latest", la imagen de máquina virtual no se actualizará automáticamente después del tiempo de implementación incluso si hay disponible una nueva versión. No use el campo "version" para la implementación de imágenes de la galería, la imagen de la galería siempre debe usar el campo "id" para la implementación, para usar la versión "latest" de la imagen de la galería, simplemente establezca "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/gallerys/{galleryName}/{imageName}" en el campo "id" sin entrada de versión.

InnerError

Detalles del error interno.

Nombre Tipo Description
errordetail

string

Mensaje de error interno o volcado de memoria de excepciones.

exceptiontype

string

Tipo de la excepción.

KeyVaultKeyReference

Describe una referencia a la clave de Key Vault.

Nombre Tipo Description
keyUrl

string

Dirección URL que hace referencia a una clave de cifrado de claves en Key Vault.

sourceVault

SubResource

Dirección URL relativa del almacén de claves que contiene la clave.

KeyVaultSecretReference

Describe una referencia al secreto de Key Vault.

Nombre Tipo Description
secretUrl

string

Dirección URL que hace referencia a un secreto en un almacén de claves.

sourceVault

SubResource

Dirección URL relativa del almacén de claves que contiene el secreto.

ManagedDiskParameters

Parámetros de un disco administrado.

Nombre Tipo Description
additionalDiskProperties

AdditionalDiskProperties

Especifica propiedades adicionales para el disco gestionado que pueden establecerse en el momento de la creación implícita del disco. Esta propiedad no se captura para los Puntos de Restauración.

diskEncryptionSet

DiskEncryptionSetParameters

Especifica el identificador de recurso del conjunto de cifrado de disco administrado del cliente para el disco administrado.

id

string

Identificador de recurso

securityProfile

VMDiskSecurityProfile

Especifica el perfil de seguridad del disco administrado.

storageAccountType

StorageAccountTypes

Especifica el tipo de cuenta de almacenamiento para el disco administrado. NOTA: UltraSSD_LRS solo se puede usar con discos de datos, no se puede usar con disco del sistema operativo.

ManagedDiskProperties

Especifica las propiedades de un disco gestionado que pueden establecerse en el momento de la creación implícita del disco.

Nombre Tipo Description
availabilityPolicy

DiskAvailabilityPolicy

En caso de un problema de disponibilidad o conectividad con el disco, especifica el comportamiento de tu máquina virtual.

burstingEnabled

boolean

Establézcalo en true para habilitar la expansión más allá del destino de rendimiento aprovisionado del disco. La expansión está deshabilitada de manera predeterminada. No se aplica a discos Ultra.

diskAccessId

string

ID de recurso Azure del recurso DiskAccess para usar endpoints privados en discos.

diskIOPSReadOnly

integer (int64)

Número total de IOPS que se permitirán en todas las máquinas virtuales que montan el disco compartido como ReadOnly. Una operación puede transferir entre 4 000 y 256 000 bytes.

diskMBpsReadOnly

integer (int64)

Rendimiento total (MBps) que se permitirá en todas las máquinas virtuales que montan el disco compartido como ReadOnly. MBps significa millones de bytes por segundo: MB aquí usa la notación ISO, de potencias de 10.

logicalSectorSize

integer (int32)

Tamaño lógico del sector en bytes para discos ultra. Los valores admitidos son 512 y 4096. 4096 es el valor predeterminado.

maxShares

integer (int32)

minimum: 1

Número máximo de máquinas virtuales que se pueden conectar al disco al mismo tiempo. El valor mayor que uno indica un disco que se puede montar en varias máquinas virtuales al mismo tiempo. Se aplica solo a discos de datos.

networkAccessPolicy

NetworkAccessPolicy

Directiva para acceder al disco a través de la red.

optimizedForFrequentAttach

boolean

Configurar esta propiedad en verdadero mejora la fiabilidad y el rendimiento de los discos de datos que con frecuencia (más de 5 veces al día) se desconectan de una máquina virtual y se conectan a otra. Esta propiedad no debe establecerse para los discos que no están desasociados y conectados con frecuencia, ya que hace que los discos no se alineen con el dominio de error de la máquina virtual.

performancePlus

boolean

Establezca esta marca en true para obtener un aumento en el destino de rendimiento del disco implementado. Esta marca solo se puede establecer en el tiempo de creación del disco y no se puede deshabilitar después de habilitarse.

tier

string

Nivel de rendimiento del disco (por ejemplo, P4, S10) como se describe aquí: https://azure.microsoft.com/en-us/pricing/details/managed-disks/. No se aplica a discos Ultra.

NetworkAccessPolicy

Directiva para acceder al disco a través de la red.

Valor Description
AllowAll

El disco puede exportarse o subirse desde cualquier red.

AllowPrivate

El disco puede exportarse o subirse utilizando los puntos finales privados de un recurso DiskAccess.

DenyAll

No se puede exportar el disco.

OperatingSystemTypes

Esta propiedad permite especificar el tipo del sistema operativo que se incluye en el disco si crea una máquina virtual a partir de una imagen personalizada. Los valores posibles son: Windows,Linux.

Valor Description
Windows
Linux

OSDisk

Especifica información sobre el disco del sistema operativo utilizado por la máquina virtual. Para más información sobre los discos, consulte Acerca de discos y discos duros virtuales para máquinas virtuales de Azure.

Nombre Tipo Description
caching

CachingTypes

Especifica los requisitos de almacenamiento en caché. Los valores posibles son: None,ReadOnly,ReadWrite. El comportamiento predeterminado es: Ninguno para el almacenamiento estándar. ReadOnly para Premium Storage.

createOption

DiskCreateOptionTypes

Especifica cómo se debe crear el disco de máquina virtual. Los valores posibles son Adjuntar: Este valor se usa cuando se usa un disco especializado para crear la máquina virtual. FromImage: Este valor se usa cuando se usa una imagen para crear la máquina virtual. Si usa una imagen de plataforma, también debe usar el elemento imageReference descrito anteriormente. Si usa una imagen de Marketplace, también debe usar el elemento plan descrito anteriormente.

deleteOption

DiskDeleteOptionTypes

Especifica si el disco del sistema operativo se debe eliminar o desasociar tras la eliminación de la máquina virtual. Los valores posibles son: Delete. Si se usa este valor, el disco del sistema operativo se elimina cuando se elimina la máquina virtual. Separar. Si se usa este valor, el disco del sistema operativo se conserva después de eliminar la máquina virtual. El valor predeterminado se establece en Desasociar. Para un disco de sistema operativo efímero, el valor predeterminado se establece en Eliminar. El usuario no puede cambiar la opción de eliminación de un disco de sistema operativo efímero.

diffDiskSettings

DiffDiskSettings

Especifica la configuración de disco efímero para el disco del sistema operativo utilizado por la máquina virtual.

diskSizeGB

integer (int32)

Especifica el tamaño de un disco de datos vacío en gigabytes. Este elemento se puede usar para sobrescribir el tamaño del disco en una imagen de máquina virtual. La propiedad 'diskSizeGB' es el número de bytes x 1024^3 para el disco y el valor no puede ser mayor que 1023.

encryptionSettings

DiskEncryptionSettings

Especifica la configuración de cifrado del disco del sistema operativo. Versión mínima de api: 2015-06-15.

image

VirtualHardDisk

Disco duro virtual de la imagen de usuario de origen. El disco duro virtual se copiará antes de conectarse a la máquina virtual. Si se proporciona SourceImage, el disco duro virtual de destino no debe existir.

managedDisk

ManagedDiskParameters

Parámetros de disco administrado.

name

string

Nombre del disco.

osType

OperatingSystemTypes

Esta propiedad permite especificar el tipo del sistema operativo que se incluye en el disco si crea una máquina virtual a partir de una imagen de usuario o un VHD especializado. Los valores posibles son: Windows,Linux.

storageFaultDomainAlignment

StorageFaultDomainAlignmentType

Especifica el tipo de alineación del dominio de fallo de almacenamiento para el disco.

vhd

VirtualHardDisk

Disco duro virtual.

writeAcceleratorEnabled

boolean

Especifica si writeAccelerator debe estar habilitado o deshabilitado en el disco.

SecurityEncryptionTypes

Especifica encryptionType del disco administrado. Se establece en DiskWithVMGuestState para el cifrado del disco administrado junto con el blob VMGuestState, VMGuestStateOnly para el cifrado de solo el blob VMGuestState y NonPersistedTPM para no conservar el estado de firmware en el blob VMGuestState. Nota: Solo se puede establecer para máquinas virtuales confidenciales.

Valor Description
VMGuestStateOnly
DiskWithVMGuestState
NonPersistedTPM

StorageAccountTypes

Especifica el tipo de cuenta de almacenamiento para el disco administrado. El tipo de cuenta de almacenamiento en disco del sistema operativo administrado solo se puede establecer al crear el conjunto de escalado. NOTA: UltraSSD_LRS solo se pueden usar con discos de datos. No se puede usar con el disco del sistema operativo. Standard_LRS usa HDD estándar. StandardSSD_LRS usa SSD estándar. Premium_LRS usa SSD Premium. UltraSSD_LRS usa disco Ultra. Premium_ZRS usa almacenamiento con redundancia de zona SSD Premium. StandardSSD_ZRS usa el almacenamiento con redundancia de zona SSD estándar. Para obtener más información sobre los discos compatibles con máquinas virtuales Windows, consulte https://docs.microsoft.com/azure/virtual-machines/windows/disks-types y, para máquinas virtuales Linux, consulte https://docs.microsoft.com/azure/virtual-machines/linux/disks-types

Valor Description
Standard_LRS
Premium_LRS
StandardSSD_LRS
UltraSSD_LRS
Premium_ZRS
StandardSSD_ZRS
PremiumV2_LRS

StorageFaultDomainAlignmentType

Especifica el tipo de alineación del dominio de fallo de almacenamiento para el disco.

Valor Description
Aligned

Los dominios de fallo de almacenamiento en disco se asignan a dominios de fallo de cálculo. El despliegue falla si el disco no soporta suficientes Dominios de Falla.

BestEffortAligned

Intenta mapear dominios de fallo de almacenamiento para calcular dominios de fallo. Los discos se desalinean si el disco no soporta suficientes dominios de falla.

StorageProfile

Especifica la configuración de almacenamiento de los discos de máquina virtual.

Nombre Tipo Description
alignRegionalDisksToVMZone

boolean

Especifica si los discos regionales se deben alinear o mover a la zona de máquina virtual. Esto solo es aplicable a las máquinas virtuales con el conjunto de propiedades placement. Tenga en cuenta que este cambio es irreversible. Versión mínima de api: 2024-11-01.

dataDisks

DataDisk[]

Especifica los parámetros que se usan para agregar un disco de datos a una máquina virtual. Para más información sobre los discos, consulte Acerca de discos y discos duros virtuales para máquinas virtuales de Azure.

diskApiVersion

DiskApiVersion

Especifica la versión de la API de disco utilizada al aplicar propiedades de disco adicionales a discos gestionados. El valor debe estar en el formato YYYY-MM-DD (por ejemplo, "2026-03-02").

diskControllerType

DiskControllerTypes

Especifica el tipo de controlador de disco configurado para la máquina virtual. Nota: Esta propiedad se establecerá en el tipo de controlador de disco predeterminado si no se especifica que se cree una máquina virtual con "hyperVGeneration" establecido en V2 en función de las funcionalidades del disco del sistema operativo y el tamaño de máquina virtual de la versión mínima de api especificada. Debe desasignar la máquina virtual antes de actualizar su tipo de controlador de disco a menos que actualice el tamaño de la máquina virtual en la configuración de la máquina virtual que desasigna implícitamente y reasigna la máquina virtual. Versión mínima de api: 2022-08-01.

imageReference

ImageReference

Especifica información sobre la imagen que se va a usar. Puede especificar información sobre imágenes de plataforma, imágenes de Marketplace o imágenes de máquina virtual. Este elemento es necesario cuando desea usar una imagen de plataforma, una imagen de Marketplace o una imagen de máquina virtual, pero no se usa en otras operaciones de creación.

osDisk

OSDisk

Especifica información sobre el disco del sistema operativo utilizado por la máquina virtual. Para más información sobre los discos, consulte Acerca de discos y discos duros virtuales para máquinas virtuales de Azure.

SubResource

Nombre Tipo Description
id

string

Identificador de recurso

VirtualHardDisk

Describe el URI de un disco.

Nombre Tipo Description
uri

string

Especifica el URI del disco duro virtual.

VMDiskSecurityProfile

Especifica la configuración del perfil de seguridad para el disco administrado. Nota: Solo se puede establecer para máquinas virtuales confidenciales.

Nombre Tipo Description
diskEncryptionSet

DiskEncryptionSetParameters

Especifica el identificador de recurso del conjunto de cifrado de disco administrado del cliente para el disco administrado que se usa para el disco de sistema operativo ConfidentialVM cifrado con clave administrada por el cliente y el blob vmGuest.

securityEncryptionType

SecurityEncryptionTypes

Especifica encryptionType del disco administrado. Se establece en DiskWithVMGuestState para el cifrado del disco administrado junto con el blob VMGuestState, VMGuestStateOnly para el cifrado de solo el blob VMGuestState y NonPersistedTPM para no conservar el estado de firmware en el blob VMGuestState. Nota: Solo se puede establecer para máquinas virtuales confidenciales.