Virtual Machines - Attach Detach Data Disks
Attachez et détachez des disques de données à/à partir de la machine virtuelle.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/attachDetachDataDisks?api-version=2024-07-01
Paramètres URI
Nom | Dans | Obligatoire | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string |
Nom du groupe de ressources. |
subscription
|
path | True |
string |
Informations d’identification d’abonnement qui identifient de manière unique l’abonnement Microsoft Azure. L’ID d’abonnement fait partie de l’URI de chaque appel de service. |
vm
|
path | True |
string |
Nom de la machine virtuelle. |
api-version
|
query | True |
string |
Version de l’API cliente. |
Corps de la demande
Nom | Type | Description |
---|---|---|
parameters |
Paramètres fournis pour l’opération attacher et détacher les disques de données sur la machine virtuelle. |
Réponses
Nom | Type | Description |
---|---|---|
200 OK |
D’ACCORD |
|
202 Accepted |
Accepté En-têtes Location: string |
|
Other Status Codes |
Réponse d’erreur décrivant pourquoi l’opération a échoué. |
Sécurité
azure_auth
Flux OAuth2 Azure Active Directory
Type:
oauth2
Flux:
implicit
URL d’autorisation:
https://login.microsoftonline.com/common/oauth2/authorize
Étendues
Nom | Description |
---|---|
user_impersonation | emprunter l’identité de votre compte d’utilisateur |
Exemples
Virtual |
Virtual |
VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen
Exemple de requête
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaaaaaaaaa/attachDetachDataDisks?api-version=2024-07-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"
}
]
}
Exemple de réponse
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
Exemple de requête
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/azure-vm/attachDetachDataDisks?api-version=2024-07-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"
}
]
}
Exemple de réponse
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
Définitions
Nom | Description |
---|---|
Api |
Identificateur de ressource source. Il peut s’agir d’un instantané ou d’un point de restauration de disque à partir duquel créer un disque. |
Api |
Erreur d’API. |
Api |
Base d’erreurs d’API. |
Attach |
Paramètres fournis pour l’opération attacher et détacher les disques de données sur la machine virtuelle. |
Caching |
Spécifie les exigences de mise en cache. Les valeurs possibles sont : None,ReadOnly,ReadWrite. Le comportement par défaut est : None pour le stockage Standard. ReadOnly pour le stockage Premium. |
Cloud |
Réponse d’erreur du service de calcul. |
Data |
Spécifie les paramètres utilisés pour ajouter un disque de données à une machine virtuelle. Pour plus d’informations sur les disques, consultez À propos des disques et des disques durs virtuels pour les machines virtuelles Azure. |
Data |
Liste des disques de données managés à joindre. |
Data |
Liste des disques de données managés à détacher. |
Diff |
Spécifie les paramètres de disque éphémères pour le disque du système d’exploitation. |
Diff |
Spécifie le placement de disque éphémère pour le disque du système d’exploitation. Les valeurs possibles sont les suivantes : CacheDisk,ResourceDisk,NvmeDisk. Le comportement par défaut est : CacheDisk si une taille de machine virtuelle est configurée pour la taille de machine virtuelle sinon ResourceDisk ou NvmeDisk est utilisé. Reportez-vous à la documentation sur la taille des machines virtuelles Windows sur https://docs.microsoft.com/azure/virtual-machines/windows/sizes et la machine virtuelle Linux à https://docs.microsoft.com/azure/virtual-machines/linux/sizes pour vérifier quelles tailles de machine virtuelle exposent un disque de cache. Version minimale de l’API pour NvmeDisk : 2024-03-01. |
Diff |
Spécifie les paramètres de disque éphémères pour le disque du système d’exploitation utilisé par la machine virtuelle. |
Disk |
Spécifie le type de contrôleur de disque configuré pour la machine virtuelle. Remarque : Cette propriété est définie sur le type de contrôleur de disque par défaut si aucune machine virtuelle fournie n’est créée avec « hyperVGeneration » définie sur V2 en fonction des fonctionnalités du disque du système d’exploitation et de la taille de machine virtuelle à partir de la version minimale spécifiée de l’API. Vous devez libérer la machine virtuelle avant de mettre à jour son type de contrôleur de disque, sauf si vous mettez à jour la taille de machine virtuelle dans la configuration de la machine virtuelle qui désalloue et réalloue implicitement la machine virtuelle. Version minimale de l’API : 2022-08-01. |
Disk |
Spécifie la façon dont le disque de machine virtuelle doit être créé. Les valeurs possibles sont Attacher : Cette valeur est utilisée lorsque vous utilisez un disque spécialisé pour créer la machine virtuelle. FromImage : Cette valeur est utilisée lorsque vous utilisez une image pour créer la machine virtuelle. Si vous utilisez une image de plateforme, vous devez également utiliser l’élément imageReference décrit ci-dessus. Si vous utilisez une image de la Place de marché, vous devez également utiliser l’élément de plan décrit précédemment. |
Disk |
Spécifie si le disque du système d’exploitation doit être supprimé ou détaché lors de la suppression de la machine virtuelle. Les valeurs possibles sont les suivantes : Supprimer. Si cette valeur est utilisée, le disque du système d’exploitation est supprimé lorsque la machine virtuelle est supprimée. Détacher. Si cette valeur est utilisée, le disque du système d’exploitation est conservé après la suppression de la machine virtuelle. La valeur par défaut est définie sur détacher. Pour un disque de système d’exploitation éphémère, la valeur par défaut est définie sur Supprimer. L’utilisateur ne peut pas modifier l’option de suppression d’un disque de système d’exploitation éphémère. |
Disk |
Spécifie le comportement de détachement à utiliser lors du détachement d’un disque ou déjà en cours de détachement de la machine virtuelle. Valeurs prises en charge : ForceDetach. détacherOption : ForceDetach s’applique uniquement aux disques de données managés. Si une tentative de détachement précédente du disque de données n’a pas été effectuée en raison d’une défaillance inattendue de la machine virtuelle et que le disque n’est toujours pas libéré, utilisez une option de détachement forcé comme option de dernier recours pour détacher le disque de force de la machine virtuelle. Toutes les écritures n’ont peut-être pas été vidées lors de l’utilisation de ce comportement de détachement. Pour forcer le détachement d’une mise à jour du disque de données versBeDetached à « true », ainsi que le paramètre detachOption : « ForceDetach ». |
Disk |
Spécifie l’ID de ressource du jeu de chiffrement de disque managé du client pour le disque managé. |
Disk |
Spécifie les paramètres de chiffrement du disque du système d’exploitation. Version minimale de l’API : 2015-06-15. |
Image |
Spécifie des informations sur l’image à utiliser. Vous pouvez spécifier des informations sur les images de plateforme, les images de la Place de marché ou les images de machine virtuelle. Cet élément est requis lorsque vous souhaitez utiliser une image de plateforme, une image de la Place de marché ou une image de machine virtuelle, mais n’est pas utilisé dans d’autres opérations de création. |
Inner |
Détails de l’erreur interne. |
Key |
Spécifie l’emplacement de la clé de chiffrement de clé dans Key Vault. |
Key |
Spécifie l’emplacement de la clé de chiffrement de disque, qui est un secret Key Vault. |
Managed |
Paramètres de disque managé. |
Operating |
Type de système d’exploitation. |
OSDisk |
Spécifie des informations sur le disque du système d’exploitation utilisé par la machine virtuelle. Pour plus d’informations sur les disques, consultez À propos des disques et des disques durs virtuels pour les machines virtuelles Azure. |
security |
Spécifie le EncryptionType du disque managé. Il est défini sur DiskWithVMGuestState pour le chiffrement du disque managé avec l’objet blob VMGuestState, VMGuestStateOnly pour le chiffrement de l’objet blob VMGuestState et nonPersistedTPM pour ne pas conserver l’état du microprogramme dans l’objet blob VMGuestState.. Remarque : Il peut être défini uniquement pour les machines virtuelles confidentielles. |
Storage |
Spécifie le type de compte de stockage pour le disque managé. REMARQUE : UltraSSD_LRS ne peut être utilisé qu’avec des disques de données, il ne peut pas être utilisé avec le disque du système d’exploitation. |
Storage |
Spécifie les paramètres de stockage des disques de machine virtuelle. |
Sub |
|
Virtual |
Disque dur virtuel. |
VMDisk |
Spécifie le profil de sécurité du disque managé. |
ApiEntityReference
Identificateur de ressource source. Il peut s’agir d’un instantané ou d’un point de restauration de disque à partir duquel créer un disque.
Nom | Type | Description |
---|---|---|
id |
string |
ID de ressource ARM sous la forme de /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/... |
ApiError
Erreur d’API.
Nom | Type | Description |
---|---|---|
code |
string |
Code d’erreur. |
details |
Détails de l’erreur api |
|
innererror |
Erreur interne de l’API |
|
message |
string |
Message d’erreur. |
target |
string |
Cible de l’erreur particulière. |
ApiErrorBase
Base d’erreurs d’API.
Nom | Type | Description |
---|---|---|
code |
string |
Code d’erreur. |
message |
string |
Message d’erreur. |
target |
string |
Cible de l’erreur particulière. |
AttachDetachDataDisksRequest
Paramètres fournis pour l’opération attacher et détacher les disques de données sur la machine virtuelle.
Nom | Type | Description |
---|---|---|
dataDisksToAttach |
Liste des disques de données managés à joindre. |
|
dataDisksToDetach |
Liste des disques de données managés à détacher. |
CachingTypes
Spécifie les exigences de mise en cache. Les valeurs possibles sont : None,ReadOnly,ReadWrite. Le comportement par défaut est : None pour le stockage Standard. ReadOnly pour le stockage Premium.
Nom | Type | Description |
---|---|---|
None |
string |
|
ReadOnly |
string |
|
ReadWrite |
string |
CloudError
Réponse d’erreur du service de calcul.
Nom | Type | Description |
---|---|---|
error |
Erreur d’API. |
DataDisk
Spécifie les paramètres utilisés pour ajouter un disque de données à une machine virtuelle. Pour plus d’informations sur les disques, consultez À propos des disques et des disques durs virtuels pour les machines virtuelles Azure.
Nom | Type | Description |
---|---|---|
caching |
Spécifie les exigences de mise en cache. Les valeurs possibles sont : None,ReadOnly,ReadWrite. Le comportement par défaut est : None pour le stockage Standard. ReadOnly pour le stockage Premium. |
|
createOption |
Spécifie la façon dont le disque de machine virtuelle doit être créé. Les valeurs possibles sont Attacher : Cette valeur est utilisée lorsque vous utilisez un disque spécialisé pour créer la machine virtuelle. FromImage : Cette valeur est utilisée lorsque vous utilisez une image pour créer le disque de données de machine virtuelle. Si vous utilisez une image de plateforme, vous devez également utiliser l’élément imageReference décrit ci-dessus. Si vous utilisez une image de la Place de marché, vous devez également utiliser l’élément de plan décrit précédemment. Vide : Cette valeur est utilisée lors de la création d’un disque de données vide. Copier : Cette valeur est utilisée pour créer un disque de données à partir d’un instantané ou d’un autre disque. Restauration : Cette valeur est utilisée pour créer un disque de données à partir d’un point de restauration de disque. |
|
deleteOption |
Spécifie si le disque de données doit être supprimé ou détaché lors de la suppression de la machine virtuelle. Les valeurs possibles sont les suivantes : Supprimer. Si cette valeur est utilisée, le disque de données est supprimé lorsque la machine virtuelle est supprimée. Détacher. Si cette valeur est utilisée, le disque de données est conservé après la suppression de la machine virtuelle. La valeur par défaut est définie sur détacher. |
|
detachOption |
Spécifie le comportement de détachement à utiliser lors du détachement d’un disque ou déjà en cours de détachement de la machine virtuelle. Valeurs prises en charge : ForceDetach. détacherOption : ForceDetach s’applique uniquement aux disques de données managés. Si une tentative de détachement précédente du disque de données n’a pas été effectuée en raison d’une défaillance inattendue de la machine virtuelle et que le disque n’est toujours pas libéré, utilisez une option de détachement forcé comme option de dernier recours pour détacher le disque de force de la machine virtuelle. Toutes les écritures n’ont peut-être pas été vidées lors de l’utilisation de ce comportement de détachement. Pour forcer le détachement d’une mise à jour du disque de données versBeDetached à « true », ainsi que le paramètre detachOption : « ForceDetach ». |
|
diskIOPSReadWrite |
integer |
Spécifie l’IOPS Read-Write pour le disque managé lorsque StorageAccountType est UltraSSD_LRS. Retourné uniquement pour les disques de machine virtuelle VirtualMachine ScaleSet. Peut être mis à jour uniquement par le biais de mises à jour du groupe identique VirtualMachine. |
diskMBpsReadWrite |
integer |
Spécifie la bande passante en Mo par seconde pour le disque managé lorsque StorageAccountType est UltraSSD_LRS. Retourné uniquement pour les disques de machine virtuelle VirtualMachine ScaleSet. Peut être mis à jour uniquement par le biais de mises à jour du groupe identique VirtualMachine. |
diskSizeGB |
integer |
Spécifie la taille d’un disque de données vide en gigaoctets. Cet élément peut être utilisé pour remplacer la taille du disque dans une image de machine virtuelle. La propriété « diskSizeGB » est le nombre d’octets x 1024^3 pour le disque et la valeur ne peut pas être supérieure à 1023. |
image |
Disque dur virtuel de l’image utilisateur source. Le disque dur virtuel est copié avant d’être attaché à la machine virtuelle. Si SourceImage est fourni, le disque dur virtuel de destination ne doit pas exister. |
|
lun |
integer |
Spécifie le numéro d’unité logique du disque de données. Cette valeur est utilisée pour identifier les disques de données au sein de la machine virtuelle et doit donc être unique pour chaque disque de données attaché à une machine virtuelle. |
managedDisk |
Paramètres de disque managé. |
|
name |
string |
Nom du disque. |
sourceResource |
Identificateur de ressource source. Il peut s’agir d’un instantané ou d’un point de restauration de disque à partir duquel créer un disque. |
|
toBeDetached |
boolean |
Spécifie si le disque de données est en cours de détachement à partir de VirtualMachine/VirtualMachineScaleset |
vhd |
Disque dur virtuel. |
|
writeAcceleratorEnabled |
boolean |
Spécifie si writeAccelerator doit être activé ou désactivé sur le disque. |
DataDisksToAttach
Liste des disques de données managés à joindre.
Nom | Type | Description |
---|---|---|
caching |
Spécifie les exigences de mise en cache. Les valeurs possibles sont : None,ReadOnly,ReadWrite. Le comportement par défaut est : None pour le stockage Standard. ReadOnly pour le stockage Premium. |
|
deleteOption |
Spécifie si le disque de données doit être supprimé ou détaché lors de la suppression de la machine virtuelle. Les valeurs possibles sont les suivantes : Supprimer. Si cette valeur est utilisée, le disque de données est supprimé lorsque la machine virtuelle est supprimée. Détacher. Si cette valeur est utilisée, le disque de données est conservé après la suppression de la machine virtuelle. La valeur par défaut est définie sur détacher. |
|
diskEncryptionSet |
Spécifie l’ID de ressource du jeu de chiffrement de disque managé du client pour le disque managé. |
|
diskId |
string |
ID du disque de données managé. |
lun |
integer |
Numéro d’unité logique du disque de données. Cette valeur est utilisée pour identifier les disques de données au sein de la machine virtuelle et doit donc être unique pour chaque disque de données attaché à une machine virtuelle. S’il n’est pas spécifié, lun est attribué automatiquement. |
writeAcceleratorEnabled |
boolean |
Spécifie si writeAccelerator doit être activé ou désactivé sur le disque. |
DataDisksToDetach
Liste des disques de données managés à détacher.
Nom | Type | Description |
---|---|---|
detachOption |
Options prises en charge pour détacher un disque d’une machine virtuelle. Pour plus d’informations, reportez-vous à la référence de l’objet DetachOption. |
|
diskId |
string |
ID du disque de données managé. |
DiffDiskOptions
Spécifie les paramètres de disque éphémères pour le disque du système d’exploitation.
Nom | Type | Description |
---|---|---|
Local |
string |
DiffDiskPlacement
Spécifie le placement de disque éphémère pour le disque du système d’exploitation. Les valeurs possibles sont les suivantes : CacheDisk,ResourceDisk,NvmeDisk. Le comportement par défaut est : CacheDisk si une taille de machine virtuelle est configurée pour la taille de machine virtuelle sinon ResourceDisk ou NvmeDisk est utilisé. Reportez-vous à la documentation sur la taille des machines virtuelles Windows sur https://docs.microsoft.com/azure/virtual-machines/windows/sizes et la machine virtuelle Linux à https://docs.microsoft.com/azure/virtual-machines/linux/sizes pour vérifier quelles tailles de machine virtuelle exposent un disque de cache. Version minimale de l’API pour NvmeDisk : 2024-03-01.
Nom | Type | Description |
---|---|---|
CacheDisk |
string |
|
NvmeDisk |
string |
|
ResourceDisk |
string |
DiffDiskSettings
Spécifie les paramètres de disque éphémères pour le disque du système d’exploitation utilisé par la machine virtuelle.
Nom | Type | Description |
---|---|---|
option |
Spécifie les paramètres de disque éphémères pour le disque du système d’exploitation. |
|
placement |
Spécifie le placement de disque éphémère pour le disque du système d’exploitation. Les valeurs possibles sont les suivantes : CacheDisk,ResourceDisk,NvmeDisk. Le comportement par défaut est : CacheDisk si une taille de machine virtuelle est configurée pour la taille de machine virtuelle sinon ResourceDisk ou NvmeDisk est utilisé. Reportez-vous à la documentation sur la taille des machines virtuelles Windows sur https://docs.microsoft.com/azure/virtual-machines/windows/sizes et la machine virtuelle Linux à https://docs.microsoft.com/azure/virtual-machines/linux/sizes pour vérifier quelles tailles de machine virtuelle exposent un disque de cache. Version minimale de l’API pour NvmeDisk : 2024-03-01. |
DiskControllerTypes
Spécifie le type de contrôleur de disque configuré pour la machine virtuelle. Remarque : Cette propriété est définie sur le type de contrôleur de disque par défaut si aucune machine virtuelle fournie n’est créée avec « hyperVGeneration » définie sur V2 en fonction des fonctionnalités du disque du système d’exploitation et de la taille de machine virtuelle à partir de la version minimale spécifiée de l’API. Vous devez libérer la machine virtuelle avant de mettre à jour son type de contrôleur de disque, sauf si vous mettez à jour la taille de machine virtuelle dans la configuration de la machine virtuelle qui désalloue et réalloue implicitement la machine virtuelle. Version minimale de l’API : 2022-08-01.
Nom | Type | Description |
---|---|---|
NVMe |
string |
|
SCSI |
string |
DiskCreateOptionTypes
Spécifie la façon dont le disque de machine virtuelle doit être créé. Les valeurs possibles sont Attacher : Cette valeur est utilisée lorsque vous utilisez un disque spécialisé pour créer la machine virtuelle. FromImage : Cette valeur est utilisée lorsque vous utilisez une image pour créer la machine virtuelle. Si vous utilisez une image de plateforme, vous devez également utiliser l’élément imageReference décrit ci-dessus. Si vous utilisez une image de la Place de marché, vous devez également utiliser l’élément de plan décrit précédemment.
Nom | Type | Description |
---|---|---|
Attach |
string |
|
Copy |
string |
|
Empty |
string |
|
FromImage |
string |
|
Restore |
string |
DiskDeleteOptionTypes
Spécifie si le disque du système d’exploitation doit être supprimé ou détaché lors de la suppression de la machine virtuelle. Les valeurs possibles sont les suivantes : Supprimer. Si cette valeur est utilisée, le disque du système d’exploitation est supprimé lorsque la machine virtuelle est supprimée. Détacher. Si cette valeur est utilisée, le disque du système d’exploitation est conservé après la suppression de la machine virtuelle. La valeur par défaut est définie sur détacher. Pour un disque de système d’exploitation éphémère, la valeur par défaut est définie sur Supprimer. L’utilisateur ne peut pas modifier l’option de suppression d’un disque de système d’exploitation éphémère.
Nom | Type | Description |
---|---|---|
Delete |
string |
|
Detach |
string |
DiskDetachOptionTypes
Spécifie le comportement de détachement à utiliser lors du détachement d’un disque ou déjà en cours de détachement de la machine virtuelle. Valeurs prises en charge : ForceDetach. détacherOption : ForceDetach s’applique uniquement aux disques de données managés. Si une tentative de détachement précédente du disque de données n’a pas été effectuée en raison d’une défaillance inattendue de la machine virtuelle et que le disque n’est toujours pas libéré, utilisez une option de détachement forcé comme option de dernier recours pour détacher le disque de force de la machine virtuelle. Toutes les écritures n’ont peut-être pas été vidées lors de l’utilisation de ce comportement de détachement. Pour forcer le détachement d’une mise à jour du disque de données versBeDetached à « true », ainsi que le paramètre detachOption : « ForceDetach ».
Nom | Type | Description |
---|---|---|
ForceDetach |
string |
DiskEncryptionSetParameters
Spécifie l’ID de ressource du jeu de chiffrement de disque managé du client pour le disque managé.
Nom | Type | Description |
---|---|---|
id |
string |
ID de ressource |
DiskEncryptionSettings
Spécifie les paramètres de chiffrement du disque du système d’exploitation. Version minimale de l’API : 2015-06-15.
Nom | Type | Description |
---|---|---|
diskEncryptionKey |
Spécifie l’emplacement de la clé de chiffrement de disque, qui est un secret Key Vault. |
|
enabled |
boolean |
Spécifie si le chiffrement de disque doit être activé sur la machine virtuelle. |
keyEncryptionKey |
Spécifie l’emplacement de la clé de chiffrement de clé dans Key Vault. |
ImageReference
Spécifie des informations sur l’image à utiliser. Vous pouvez spécifier des informations sur les images de plateforme, les images de la Place de marché ou les images de machine virtuelle. Cet élément est requis lorsque vous souhaitez utiliser une image de plateforme, une image de la Place de marché ou une image de machine virtuelle, mais n’est pas utilisé dans d’autres opérations de création.
Nom | Type | Description |
---|---|---|
communityGalleryImageId |
string |
Spécifie l’ID unique de l’image de la galerie de communautés pour le déploiement de machines virtuelles. Cette opération peut être extraite de l’appel GET de la galerie de la communauté. |
exactVersion |
string |
Spécifie en nombres décimaux, la version de l’image de plateforme ou de la place de marché utilisée pour créer la machine virtuelle. Ce champ en lecture seule diffère de « version », uniquement si la valeur spécifiée dans le champ « version » est « latest ». |
id |
string |
ID de ressource |
offer |
string |
Spécifie l’offre de l’image de plateforme ou de la place de marché utilisée pour créer la machine virtuelle. |
publisher |
string |
Éditeur d’images. |
sharedGalleryImageId |
string |
Spécifie l’ID unique de l’image de galerie partagée pour le déploiement de machines virtuelles. Cette opération peut être extraite de l’appel GET de l’image de galerie partagée. |
sku |
string |
Référence SKU d’image. |
version |
string |
Spécifie la version de l’image de plateforme ou de la place de marché utilisée pour créer la machine virtuelle. Les formats autorisés sont Major.Minor.Build ou « latest ». Les nombres principaux, mineurs et build sont des nombres décimaux. Spécifiez « latest » pour utiliser la dernière version d’une image disponible au moment du déploiement. Même si vous utilisez la « dernière version », l’image de machine virtuelle ne sera pas automatiquement mise à jour après le déploiement même si une nouvelle version devient disponible. N’utilisez pas le champ « version » pour le déploiement d’images de galerie, l’image de la galerie doit toujours utiliser le champ « ID » pour le déploiement, pour utiliser la version la plus récente de l’image de la galerie, il vous suffit de définir « /subscriptions/{subscriptionId}/resourceGroupName}/{resourceGroupName}/providers/Microsoft.Compute/galleryName}/images/{imageName} » dans le champ « id » sans entrée de version. |
InnerError
Détails de l’erreur interne.
Nom | Type | Description |
---|---|---|
errordetail |
string |
Message d’erreur interne ou vidage d’exception. |
exceptiontype |
string |
Type d’exception. |
KeyVaultKeyReference
Spécifie l’emplacement de la clé de chiffrement de clé dans Key Vault.
Nom | Type | Description |
---|---|---|
keyUrl |
string |
URL référençant une clé de chiffrement de clé dans Key Vault. |
sourceVault |
URL relative du coffre de clés contenant la clé. |
KeyVaultSecretReference
Spécifie l’emplacement de la clé de chiffrement de disque, qui est un secret Key Vault.
Nom | Type | Description |
---|---|---|
secretUrl |
string |
URL référençant un secret dans un coffre de clés. |
sourceVault |
URL relative du coffre de clés contenant le secret. |
ManagedDiskParameters
Paramètres de disque managé.
Nom | Type | Description |
---|---|---|
diskEncryptionSet |
Spécifie l’ID de ressource du jeu de chiffrement de disque managé du client pour le disque managé. |
|
id |
string |
ID de ressource |
securityProfile |
Spécifie le profil de sécurité du disque managé. |
|
storageAccountType |
Spécifie le type de compte de stockage pour le disque managé. REMARQUE : UltraSSD_LRS ne peut être utilisé qu’avec des disques de données, il ne peut pas être utilisé avec le disque du système d’exploitation. |
OperatingSystemTypes
Type de système d’exploitation.
Nom | Type | Description |
---|---|---|
Linux |
string |
|
Windows |
string |
OSDisk
Spécifie des informations sur le disque du système d’exploitation utilisé par la machine virtuelle. Pour plus d’informations sur les disques, consultez À propos des disques et des disques durs virtuels pour les machines virtuelles Azure.
Nom | Type | Description |
---|---|---|
caching |
Spécifie les exigences de mise en cache. Les valeurs possibles sont : None,ReadOnly,ReadWrite. Le comportement par défaut est : None pour le stockage Standard. ReadOnly pour le stockage Premium. |
|
createOption |
Spécifie la façon dont le disque de machine virtuelle doit être créé. Les valeurs possibles sont Attacher : Cette valeur est utilisée lorsque vous utilisez un disque spécialisé pour créer la machine virtuelle. FromImage : Cette valeur est utilisée lorsque vous utilisez une image pour créer la machine virtuelle. Si vous utilisez une image de plateforme, vous devez également utiliser l’élément imageReference décrit ci-dessus. Si vous utilisez une image de la Place de marché, vous devez également utiliser l’élément de plan décrit précédemment. |
|
deleteOption |
Spécifie si le disque du système d’exploitation doit être supprimé ou détaché lors de la suppression de la machine virtuelle. Les valeurs possibles sont les suivantes : Supprimer. Si cette valeur est utilisée, le disque du système d’exploitation est supprimé lorsque la machine virtuelle est supprimée. Détacher. Si cette valeur est utilisée, le disque du système d’exploitation est conservé après la suppression de la machine virtuelle. La valeur par défaut est définie sur détacher. Pour un disque de système d’exploitation éphémère, la valeur par défaut est définie sur Supprimer. L’utilisateur ne peut pas modifier l’option de suppression d’un disque de système d’exploitation éphémère. |
|
diffDiskSettings |
Spécifie les paramètres de disque éphémères pour le disque du système d’exploitation utilisé par la machine virtuelle. |
|
diskSizeGB |
integer |
Spécifie la taille d’un disque de données vide en gigaoctets. Cet élément peut être utilisé pour remplacer la taille du disque dans une image de machine virtuelle. La propriété « diskSizeGB » est le nombre d’octets x 1024^3 pour le disque et la valeur ne peut pas être supérieure à 1023. |
encryptionSettings |
Spécifie les paramètres de chiffrement du disque du système d’exploitation. Version minimale de l’API : 2015-06-15. |
|
image |
Disque dur virtuel de l’image utilisateur source. Le disque dur virtuel est copié avant d’être attaché à la machine virtuelle. Si SourceImage est fourni, le disque dur virtuel de destination ne doit pas exister. |
|
managedDisk |
Paramètres de disque managé. |
|
name |
string |
Nom du disque. |
osType |
Cette propriété vous permet de spécifier le type du système d’exploitation inclus dans le disque si vous créez une machine virtuelle à partir d’une image utilisateur ou d’un disque dur virtuel spécialisé. Les valeurs possibles sont : Windows,Linux. |
|
vhd |
Disque dur virtuel. |
|
writeAcceleratorEnabled |
boolean |
Spécifie si writeAccelerator doit être activé ou désactivé sur le disque. |
securityEncryptionTypes
Spécifie le EncryptionType du disque managé. Il est défini sur DiskWithVMGuestState pour le chiffrement du disque managé avec l’objet blob VMGuestState, VMGuestStateOnly pour le chiffrement de l’objet blob VMGuestState et nonPersistedTPM pour ne pas conserver l’état du microprogramme dans l’objet blob VMGuestState.. Remarque : Il peut être défini uniquement pour les machines virtuelles confidentielles.
Nom | Type | Description |
---|---|---|
DiskWithVMGuestState |
string |
|
NonPersistedTPM |
string |
|
VMGuestStateOnly |
string |
StorageAccountTypes
Spécifie le type de compte de stockage pour le disque managé. REMARQUE : UltraSSD_LRS ne peut être utilisé qu’avec des disques de données, il ne peut pas être utilisé avec le disque du système d’exploitation.
Nom | Type | Description |
---|---|---|
PremiumV2_LRS |
string |
|
Premium_LRS |
string |
|
Premium_ZRS |
string |
|
StandardSSD_LRS |
string |
|
StandardSSD_ZRS |
string |
|
Standard_LRS |
string |
|
UltraSSD_LRS |
string |
StorageProfile
Spécifie les paramètres de stockage des disques de machine virtuelle.
Nom | Type | Description |
---|---|---|
dataDisks |
Data |
Spécifie les paramètres utilisés pour ajouter un disque de données à une machine virtuelle. Pour plus d’informations sur les disques, consultez À propos des disques et des disques durs virtuels pour les machines virtuelles Azure. |
diskControllerType |
Spécifie le type de contrôleur de disque configuré pour la machine virtuelle. Remarque : Cette propriété est définie sur le type de contrôleur de disque par défaut si aucune machine virtuelle fournie n’est créée avec « hyperVGeneration » définie sur V2 en fonction des fonctionnalités du disque du système d’exploitation et de la taille de machine virtuelle à partir de la version minimale spécifiée de l’API. Vous devez libérer la machine virtuelle avant de mettre à jour son type de contrôleur de disque, sauf si vous mettez à jour la taille de machine virtuelle dans la configuration de la machine virtuelle qui désalloue et réalloue implicitement la machine virtuelle. Version minimale de l’API : 2022-08-01. |
|
imageReference |
Spécifie des informations sur l’image à utiliser. Vous pouvez spécifier des informations sur les images de plateforme, les images de la Place de marché ou les images de machine virtuelle. Cet élément est requis lorsque vous souhaitez utiliser une image de plateforme, une image de la Place de marché ou une image de machine virtuelle, mais n’est pas utilisé dans d’autres opérations de création. |
|
osDisk |
Spécifie des informations sur le disque du système d’exploitation utilisé par la machine virtuelle. Pour plus d’informations sur les disques, consultez À propos des disques et des disques durs virtuels pour les machines virtuelles Azure. |
SubResource
Nom | Type | Description |
---|---|---|
id |
string |
ID de ressource |
VirtualHardDisk
Disque dur virtuel.
Nom | Type | Description |
---|---|---|
uri |
string |
Spécifie l’URI du disque dur virtuel. |
VMDiskSecurityProfile
Spécifie le profil de sécurité du disque managé.
Nom | Type | Description |
---|---|---|
diskEncryptionSet |
Spécifie l’ID de ressource du jeu de chiffrement de disque managé du client pour le disque managé utilisé pour le disque de système d’exploitation ConfidentielVM chiffré par clé gérée par le client et l’objet blob VMGuest. |
|
securityEncryptionType |
Spécifie le EncryptionType du disque managé. Il est défini sur DiskWithVMGuestState pour le chiffrement du disque managé avec l’objet blob VMGuestState, VMGuestStateOnly pour le chiffrement de l’objet blob VMGuestState et nonPersistedTPM pour ne pas conserver l’état du microprogramme dans l’objet blob VMGuestState.. Remarque : Il peut être défini uniquement pour les machines virtuelles confidentielles. |