Compartir a través de


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=2024-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.

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

La operación de Azure se completó correctamente.

202 Accepted

Operación de recurso 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 la 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=2024-11-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=2024-11-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
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.

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.

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.

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.

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

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.

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.

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. Se devuelve solo para los discos de máquina virtual VirtualMachine ScaleSet. Solo se puede actualizar a través de las actualizaciones del conjunto de escalado virtualMachine.

diskMBpsReadWrite

integer (int64)

Especifica el ancho de banda en MB por segundo para el disco administrado cuando StorageAccountType es UltraSSD_LRS. Se devuelve solo para los discos de máquina virtual VirtualMachine ScaleSet. Solo se puede actualizar a través de las actualizaciones del conjunto de escalado virtualMachine.

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.

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
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.

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 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
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.

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.

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.

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

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.

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.