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-03-01
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Nombre del grupo de recursos. |
subscription
|
path | True |
string |
Credenciales de suscripción que identifican de forma única la suscripción de Microsoft Azure. El identificador de suscripción forma parte del URI para cada llamada al servicio. |
vm
|
path | True |
string |
El nombre de la máquina virtual. |
api-version
|
query | True |
string |
Versión de api de cliente. |
Cuerpo de la solicitud
Nombre | Tipo | Description |
---|---|---|
parameters |
Parámetros proporcionados para la operación de conexión y desasociación de discos de datos en la máquina virtual. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Aceptar |
|
202 Accepted |
Aceptado Encabezados Location: string |
|
Other Status Codes |
Respuesta de error que describe el motivo del error de la operación. |
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 | suplantación de su cuenta de usuario |
Ejemplos
Virtual |
Virtual |
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-03-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-03-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 |
---|---|
Api |
Identificador del recurso de origen. Puede ser una instantánea o un punto de restauración de disco desde el que crear un disco. |
Api |
Error de api. |
Api |
Base de errores de api. |
Attach |
Parámetros proporcionados para la operación de conexión y desasociación de discos de datos en la máquina virtual. |
Caching |
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. |
Cloud |
Respuesta de error del servicio Compute. |
Data |
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 los discos y discos duros virtuales para máquinas virtuales de Azure. |
Data |
Lista de discos de datos administrados que se van a conectar. |
Data |
Lista de discos de datos administrados que se van a desasociar. |
Diff |
Especifica la configuración del disco efímero para el disco del sistema operativo. |
Diff |
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 máquina virtual; de lo 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 la máquina virtual Linux en https://docs.microsoft.com/azure/virtual-machines/linux/sizes para comprobar en qué tamaños de máquina virtual se expone un disco de caché. Versión mínima de api para NvmeDisk: 2024-03-01. |
Diff |
Especifica la configuración de disco efímero para el disco del sistema operativo usado por la máquina virtual. |
Disk |
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 ha especificado que la máquina virtual proporcionada se cree con "hyperVGeneration" establecido en V2 en función de las funcionalidades del disco del sistema operativo y el tamaño de máquina virtual a partir 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 y reasigna implícitamente la máquina virtual. Versión mínima de api: 2022-08-01. |
Disk |
Especifica cómo se debe crear el disco de la máquina virtual. Los valores posibles son Attach: 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. |
Disk |
Especifica si el disco del sistema operativo debe eliminarse o desasociarse 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 del 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 del sistema operativo efímero. |
Disk |
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 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 para desasociar el disco forzosamente 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 sigue en modo de vista previa y no se admite para VirtualMachineScaleSet. Para forzar la desasociación de una actualización del disco de datos aBeDetached a "true" junto con la configuración de detachOption: "ForceDetach". |
Disk |
Especifica el identificador de recurso del conjunto de cifrado de disco administrado por el cliente para el disco administrado. |
Disk |
Especifica la configuración de cifrado del disco del sistema operativo. Versión mínima de api: 2015-06-15. |
Image |
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. |
Inner |
Detalles del error interno. |
Key |
Especifica la ubicación de la clave de cifrado de claves en Key Vault. |
Key |
Especifica la ubicación de la clave de cifrado de disco, que es un secreto de Key Vault. |
Managed |
Parámetros de disco administrado. |
Operating |
Tipo de sistema operativo. |
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 los discos y discos duros virtuales para máquinas virtuales de Azure. |
security |
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. |
Storage |
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. |
Storage |
Especifica la configuración de almacenamiento de los discos de máquina virtual. |
Sub |
|
Virtual |
Disco duro virtual. |
VMDisk |
Especifica el perfil de seguridad del disco administrado. |
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.
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 |
Detalles del error de api |
|
innererror |
Error interno de api |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error determinado. |
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 determinado. |
AttachDetachDataDisksRequest
Parámetros proporcionados para la operación de conexión y desasociación de discos de datos en la máquina virtual.
Nombre | Tipo | Description |
---|---|---|
dataDisksToAttach |
Lista de discos de datos administrados que se van a conectar. |
|
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. El comportamiento predeterminado es: Ninguno para el almacenamiento estándar. ReadOnly para Premium Storage.
Nombre | Tipo | Description |
---|---|---|
None |
string |
|
ReadOnly |
string |
|
ReadWrite |
string |
CloudError
Respuesta de error del servicio Compute.
Nombre | Tipo | Description |
---|---|---|
error |
Error de API. |
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 los discos y discos duros virtuales para máquinas virtuales de Azure.
Nombre | Tipo | Description |
---|---|---|
caching |
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 |
Especifica cómo se debe crear el disco de la máquina virtual. Los valores posibles son Attach: 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. Copia: 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 |
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 |
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 es aplicable para 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 para separar el disco forzosamente 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 sigue en modo de vista previa y no se admite para VirtualMachineScaleSet. 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 |
Especifica el Read-Write IOPS del disco administrado cuando StorageAccountType está UltraSSD_LRS. Solo se devuelve para los discos de máquina virtual VirtualMachine ScaleSet. Solo se puede actualizar a través de actualizaciones del conjunto de escalado virtualMachine. |
diskMBpsReadWrite |
integer |
Especifica el ancho de banda en MB por segundo para el disco administrado cuando StorageAccountType está UltraSSD_LRS. Solo se devuelve para los discos de máquina virtual VirtualMachine ScaleSet. Solo se puede actualizar a través de actualizaciones del conjunto de escalado virtualMachine. |
diskSizeGB |
integer |
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 |
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 |
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 |
Parámetros de disco administrado. |
|
name |
string |
El nombre del disco. |
sourceResource |
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 desconexión de VirtualMachine/VirtualMachineScaleset. |
vhd |
Disco duro virtual. |
|
writeAcceleratorEnabled |
boolean |
Especifica si writeAccelerator debe estar habilitado o deshabilitado en el disco. |
DataDisksToAttach
Lista de discos de datos administrados que se van a conectar.
Nombre | Tipo | Description |
---|---|---|
caching |
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 |
Especifica si el disco de datos se debe eliminar o desasociar al eliminar 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 |
Especifica el identificador de recurso del conjunto de cifrado de disco administrado por el cliente para el disco administrado. |
|
diskId |
string |
Identificador del disco de datos administrado. |
lun |
integer |
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
Lista de discos de datos administrados que se van a desasociar.
Nombre | Tipo | Description |
---|---|---|
detachOption |
Opciones admitidas disponibles para desasociar un disco de una máquina virtual. Consulte La referencia del objeto DetachOption para obtener más detalles. |
|
diskId |
string |
Identificador del disco de datos administrado. |
DiffDiskOptions
Especifica la configuración del disco efímero para el disco del sistema operativo.
Nombre | Tipo | Description |
---|---|---|
Local |
string |
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 máquina virtual; de lo 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 la máquina virtual Linux en https://docs.microsoft.com/azure/virtual-machines/linux/sizes para comprobar en qué tamaños de máquina virtual se expone un disco de caché. Versión mínima de api para NvmeDisk: 2024-03-01.
Nombre | Tipo | Description |
---|---|---|
CacheDisk |
string |
|
NvmeDisk |
string |
|
ResourceDisk |
string |
DiffDiskSettings
Especifica la configuración de disco efímero para el disco del sistema operativo usado por la máquina virtual.
Nombre | Tipo | Description |
---|---|---|
option |
Especifica la configuración del disco efímero para el disco del sistema operativo. |
|
placement |
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 máquina virtual; de lo 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 la máquina virtual Linux en https://docs.microsoft.com/azure/virtual-machines/linux/sizes para comprobar en qué tamaños de máquina virtual se 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. Nota: Esta propiedad se establecerá en el tipo de controlador de disco predeterminado si no se ha especificado que la máquina virtual proporcionada se cree con "hyperVGeneration" establecido en V2 en función de las funcionalidades del disco del sistema operativo y el tamaño de máquina virtual a partir 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 y reasigna implícitamente la máquina virtual. Versión mínima de api: 2022-08-01.
Nombre | Tipo | Description |
---|---|---|
NVMe |
string |
|
SCSI |
string |
DiskCreateOptionTypes
Especifica cómo se debe crear el disco de la máquina virtual. Los valores posibles son Attach: 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.
Nombre | Tipo | Description |
---|---|---|
Attach |
string |
|
Copy |
string |
|
Empty |
string |
|
FromImage |
string |
|
Restore |
string |
DiskDeleteOptionTypes
Especifica si el disco del sistema operativo debe eliminarse o desasociarse 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 del 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 del sistema operativo efímero.
Nombre | Tipo | Description |
---|---|---|
Delete |
string |
|
Detach |
string |
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 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 para desasociar el disco forzosamente 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 sigue en modo de vista previa y no se admite para VirtualMachineScaleSet. Para forzar la desasociación de una actualización del disco de datos aBeDetached a "true" junto con la configuración de detachOption: "ForceDetach".
Nombre | Tipo | Description |
---|---|---|
ForceDetach |
string |
DiskEncryptionSetParameters
Especifica el identificador de recurso del conjunto de cifrado de disco administrado por el cliente para el disco administrado.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Id. de recurso |
DiskEncryptionSettings
Especifica la configuración de cifrado del disco del sistema operativo. Versión mínima de api: 2015-06-15.
Nombre | Tipo | Description |
---|---|---|
diskEncryptionKey |
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 |
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.
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 |
Id. 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 "más reciente" para usar la versión más reciente de una imagen disponible en el momento de la 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/galleries/{galleryName}/images/{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
Especifica la ubicación de la clave de cifrado de claves en Key Vault.
Nombre | Tipo | Description |
---|---|---|
keyUrl |
string |
Dirección URL que hace referencia a una clave de cifrado de clave en Key Vault. |
sourceVault |
Dirección URL relativa del Key Vault que contiene la clave. |
KeyVaultSecretReference
Especifica la ubicación de la clave de cifrado de disco, que es un secreto de Key Vault.
Nombre | Tipo | Description |
---|---|---|
secretUrl |
string |
Dirección URL que hace referencia a un secreto en un Key Vault. |
sourceVault |
Dirección URL relativa del Key Vault que contiene el secreto. |
ManagedDiskParameters
Parámetros de disco administrado.
Nombre | Tipo | Description |
---|---|---|
diskEncryptionSet |
Especifica el identificador de recurso del conjunto de cifrado de disco administrado por el cliente para el disco administrado. |
|
id |
string |
Id. de recurso |
securityProfile |
Especifica el perfil de seguridad del disco administrado. |
|
storageAccountType |
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
Tipo de sistema operativo.
Nombre | Tipo | Description |
---|---|---|
Linux |
string |
|
Windows |
string |
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 los discos y discos duros virtuales para máquinas virtuales de Azure.
Nombre | Tipo | Description |
---|---|---|
caching |
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 |
Especifica cómo se debe crear el disco de máquina virtual. Los valores posibles son Attach: 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 |
Especifica si el disco del sistema operativo debe eliminarse o desasociarse 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. En el caso de un disco del 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 del sistema operativo efímero. |
|
diffDiskSettings |
Especifica la configuración de disco efímera para el disco del sistema operativo usado por la máquina virtual. |
|
diskSizeGB |
integer |
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 |
Especifica la configuración de cifrado del disco del sistema operativo. Versión mínima de api: 2015-06-15. |
|
image |
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 |
Parámetros de disco administrado. |
|
name |
string |
El nombre del disco. |
osType |
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 disco duro virtual especializado. Los valores posibles son: Windows,Linux. |
|
vhd |
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.
Nombre | Tipo | Description |
---|---|---|
DiskWithVMGuestState |
string |
|
NonPersistedTPM |
string |
|
VMGuestStateOnly |
string |
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.
Nombre | Tipo | Description |
---|---|---|
PremiumV2_LRS |
string |
|
Premium_LRS |
string |
|
Premium_ZRS |
string |
|
StandardSSD_LRS |
string |
|
StandardSSD_ZRS |
string |
|
Standard_LRS |
string |
|
UltraSSD_LRS |
string |
StorageProfile
Especifica la configuración de almacenamiento de los discos de máquina virtual.
Nombre | Tipo | Description |
---|---|---|
dataDisks |
Data |
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 los discos y discos duros virtuales para máquinas virtuales de Azure. |
diskControllerType |
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 la máquina virtual proporcionada se cree con "hyperVGeneration" establecida en V2 en función de las funcionalidades del disco del sistema operativo y el tamaño de máquina virtual a partir de la versión de API mínima 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 y reasigna implícitamente la máquina virtual. Versión mínima de api: 2022-08-01. |
|
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 |
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 los discos y discos duros virtuales para máquinas virtuales de Azure. |
SubResource
Nombre | Tipo | Description |
---|---|---|
id |
string |
Id. de recurso |
VirtualHardDisk
Disco duro virtual.
Nombre | Tipo | Description |
---|---|---|
uri |
string |
Especifica el URI del disco duro virtual. |
VMDiskSecurityProfile
Especifica el perfil de seguridad del disco administrado.
Nombre | Tipo | Description |
---|---|---|
diskEncryptionSet |
Especifica el identificador de recurso del conjunto de cifrado de disco administrado por el cliente para el disco administrado que se usa para el disco de sistema operativo ConfidentialVM cifrado de clave administrada por el cliente y el blob VMGuest. |
|
securityEncryptionType |
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. |