Virtual Machines - Attach Detach Data Disks
Gegevensschijven koppelen en loskoppelen van/naar de virtuele machine.
POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/attachDetachDataDisks?api-version=2025-11-01
URI-parameters
| Name | In | Vereist | Type | Description |
|---|---|---|---|---|
|
resource
|
path | True |
string minLength: 1maxLength: 90 |
De naam van de resourcegroep. De naam is hoofdletterongevoelig. |
|
subscription
|
path | True |
string minLength: 1 |
De ID van het doelabonnement. |
|
vm
|
path | True |
string |
De naam van de virtuele machine. |
|
api-version
|
query | True |
string minLength: 1 |
De API-versie die voor deze bewerking moet worden gebruikt. |
Aanvraagbody
| Name | Type | Description |
|---|---|---|
| dataDisksToAttach |
De lijst met beheerde gegevensschijven die moeten worden gekoppeld. |
|
| dataDisksToDetach |
De lijst met beheerde gegevensschijven die moeten worden losgekoppeld. |
Antwoorden
| Name | Type | Description |
|---|---|---|
| 200 OK |
Azure-operatie succesvol voltooid. |
|
| 202 Accepted |
Resourcebewerking geaccepteerd. Kopteksten
|
|
| Other Status Codes |
Een onverwachte foutreactie. |
Beveiliging
azure_auth
Azure Active Directory OAuth2 Flow.
Type:
oauth2
Stroom:
implicit
Autorisatie-URL:
https://login.microsoftonline.com/common/oauth2/authorize
Bereiken
| Name | Description |
|---|---|
| user_impersonation | Uw gebruikersaccount imiteren |
Voorbeelden
|
Virtual |
|
Virtual |
VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen
Voorbeeldaanvraag
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaaaaaaaaa/attachDetachDataDisks?api-version=2025-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"
}
]
}
Voorbeeldrespons
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
Voorbeeldaanvraag
POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/azure-vm/attachDetachDataDisks?api-version=2025-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"
}
]
}
Voorbeeldrespons
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
Definities
| Name | Description |
|---|---|
|
Api |
De API-entiteitsreferentie. |
|
Api |
Api-fout. |
|
Api |
Api-foutbasis. |
|
Attach |
Hiermee geeft u de invoer voor het koppelen en loskoppelen van een lijst met beheerde gegevensschijven. |
|
Caching |
Hiermee geeft u de cachevereisten op. Mogelijke waarden zijn: Geen,Alleen-lezen,Lezen'. De standaardwaarden zijn: Geen voor standaardopslag. ReadOnly voor Premium opslag |
|
Cloud |
Een foutreactie van de Compute-service. |
|
Data |
Beschrijft een gegevensschijf. |
|
Data |
Beschrijft de gegevensschijf die moet worden gekoppeld. |
|
Data |
Beschrijft de gegevensschijf die moet worden losgekoppeld. |
|
Diff |
Hiermee geeft u de optie voor kortstondige schijf op voor de schijf van het besturingssysteem. |
|
Diff |
Hiermee geeft u de tijdelijke schijfplaatsing voor de besturingssysteemschijf. Deze eigenschap kan door de gebruiker worden gebruikt in het verzoek om de locatie te kiezen, d.w.z. cacheschijf, bronschijf of nvme-schijfruimte voor kortstondige OS-schijfinrichting. Voor meer informatie over de vereisten voor schijfgrootte van Ephemeral OS, zie Ephemeral OS schijfgroottevereisten voor Windows VM op https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements en Linux VM op https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Minimale API-versie voor NvmeDisk: 2024-03-01. |
|
Diff |
Beschrijft de parameters van tijdelijke schijfinstellingen die kunnen worden opgegeven voor de besturingssysteemschijf. Opmerking: De tijdelijke schijfinstellingen kunnen alleen worden opgegeven voor beheerde schijven. |
|
Disk |
Hiermee geeft u het type schijfcontroller geconfigureerd voor de VIRTUELE machine en VirtualMachineScaleSet. Deze eigenschap wordt alleen ondersteund voor virtuele machines waarvan de besturingssysteemschijf en VM-sku Generatie 2 (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2) ondersteunen; controleer alstublieft de HyperVGenerations-functionaliteit die als onderdeel van VM-sku-mogelijkheden wordt weergegeven in de respons van Microsoft. De API van de Compute SKUs voor de regio bevat V2 (https://docs.microsoft.com/rest/api/compute/resourceskus/list). Raadpleeg https://aka.ms/azure-diskcontrollertypesvoor meer informatie over ondersteunde schijfcontrollertypen. |
|
Disk |
Hiermee geeft u op hoe de schijf van de virtuele machine moet worden gemaakt. Mogelijke waarden zijn Koppelen: Deze waarde wordt gebruikt wanneer u een gespecialiseerde schijf gebruikt om de virtuele machine te maken. FromImage: Deze waarde wordt gebruikt wanneer u een installatiekopie gebruikt om de virtuele machine te maken. Als u een platforminstallatiekopie gebruikt, moet u ook het element imageReference gebruiken dat hierboven wordt beschreven. Als u een marketplace-installatiekopieën gebruikt, moet u ook het eerder beschreven planelement gebruiken. Leeg: Deze waarde wordt gebruikt bij het maken van een lege gegevensschijf. Kopiëren: Deze waarde wordt gebruikt om een gegevensschijf te maken op basis van een momentopname of een andere schijf. Herstellen: Deze waarde wordt gebruikt om een gegevensschijf te maken vanaf een schijfherstelpunt. |
|
Disk |
Hiermee geeft u het gedrag van de beheerde schijf op wanneer de virtuele machine wordt verwijderd, bijvoorbeeld of de beheerde schijf wordt verwijderd of losgekoppeld. Ondersteunde waarden zijn: Verwijderen. Als deze waarde wordt gebruikt, wordt de beheerde schijf verwijderd wanneer de VIRTUELE machine wordt verwijderd. Loskoppelen. Als deze waarde wordt gebruikt, blijft de beheerde schijf behouden nadat de VIRTUELE machine is verwijderd. Minimale API-versie: 2021-03-01. |
|
Disk |
Hiermee geeft u het loskoppelgedrag op dat moet worden gebruikt tijdens het loskoppelen van een schijf of die al bezig is met loskoppelen van de virtuele machine. Ondersteunde waarden zijn: ForceDetach. detachOption: ForceDetach is alleen van toepassing op beheerde gegevensschijven. Als een vorige loskoppelpoging van de gegevensschijf niet is voltooid vanwege een onverwachte fout van de virtuele machine en de schijf nog steeds niet wordt vrijgegeven, gebruikt u force-loskoppelen als laatste redmiddeloptie om de schijf geforceerd los te koppelen van de virtuele machine. Alle schrijfbewerkingen zijn mogelijk niet leeggemaakt wanneer u dit loskoppelgedrag gebruikt. Deze functie is nog in preview-versie. Als u een gegevensschijfupdate wilt afdwingen naarBeDetached in 'true' samen met de instelling detachOption: 'ForceDetach'. |
|
Disk |
Beschrijft de parameter van de resource-id van de door de klant beheerde schijfversleutelingsset die kan worden opgegeven voor schijf. Opmerking: de resource-id van de schijfversleutelingsset kan alleen worden opgegeven voor beheerde schijven. Raadpleeg https://aka.ms/mdssewithcmkoverview voor meer informatie. |
|
Disk |
Beschrijft een versleutelingsinstelling voor een schijf |
|
Image |
Hiermee geeft u informatie over de te gebruiken afbeelding. U kunt informatie opgeven over platforminstallatiekopieën, marketplace-installatiekopieën of installatiekopieën van virtuele machines. Dit element is vereist wanneer u een platforminstallatiekopie, marketplace-installatiekopie of installatiekopie van virtuele machines wilt gebruiken, maar niet wordt gebruikt in andere bewerkingen voor het maken. OPMERKING: De uitgever en aanbieding van afbeeldingsreferentie kunnen alleen worden ingesteld wanneer u de schaalset maakt. |
|
Inner |
Interne foutdetails. |
|
Key |
Beschrijft een verwijzing naar Key Vault Key |
|
Key |
Beschrijft een verwijzing naar Key Vault Secret |
|
Managed |
De parameters van een beheerde schijf. |
|
Operating |
Met deze eigenschap kunt u het type besturingssysteem opgeven dat op de schijf is opgenomen als u een virtuele machine maakt op basis van een aangepaste installatiekopie. Mogelijke waarden zijn: Windows,Linux. |
| OSDisk |
Hiermee geeft u informatie op over de besturingssysteemschijf die wordt gebruikt door de virtuele machine. Voor meer informatie over schijven, zie Over schijven en VHD's voor Azure virtuele machines. |
|
Security |
Hiermee geeft u het EncryptionType van de beheerde schijf. Deze is ingesteld op DiskWithVMGuestState voor versleuteling van de beheerde schijf, samen met VMGuestState-blob, VMGuestStateOnly voor versleuteling van alleen de VMGuestState-blob en NonPersistedTPM voor het niet behouden van de firmwarestatus in de VMGuestState-blob.. Opmerking: Deze kan alleen worden ingesteld voor vertrouwelijke VM's. |
|
Storage |
Hiermee geeft u het type opslagaccount voor de beheerde schijf. Het opslagaccounttype beheerde besturingssysteemschijf kan alleen worden ingesteld wanneer u de schaalset maakt. OPMERKING: UltraSSD_LRS kan alleen worden gebruikt met gegevensschijven. Het kan niet worden gebruikt met besturingssysteemschijf. Standard_LRS maakt gebruik van Standard HDD. StandardSSD_LRS maakt gebruik van Standard SSD. Premium_LRS maakt gebruik van Premium SSD. UltraSSD_LRS maakt gebruik van Ultra disk. Premium_ZRS maakt gebruik van premium SSD-zone-redundante opslag. StandardSSD_ZRS maakt gebruik van zone-redundante opslag met Standard SSD. Voor meer informatie over schijven die voor Windows Virtual Machines worden ondersteund, zie https://docs.microsoft.com/azure/virtual-machines/windows/disks-types en voor Linux-Virtual Machines https://docs.microsoft.com/azure/virtual-machines/linux/disks-types |
|
Storage |
Specificeert het type uitlijning van het opslagfoutdomein voor de schijf. |
|
Storage |
Hiermee geeft u de opslaginstellingen voor de schijven van de virtuele machine op. |
|
Sub |
|
|
Virtual |
Beschrijft de URI van een schijf. |
|
VMDisk |
Hiermee geeft u de beveiligingsprofielinstellingen voor de beheerde schijf. Opmerking: Deze kan alleen worden ingesteld voor vertrouwelijke VM's. |
ApiEntityReference
De API-entiteitsreferentie.
| Name | Type | Description |
|---|---|---|
| id |
string |
De ARM-resource-id in de vorm van /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/... |
ApiError
Api-fout.
| Name | Type | Description |
|---|---|---|
| code |
string |
De foutcode. |
| details |
Details van de Api-fout |
|
| innererror |
De innerlijke fout van de Api |
|
| message |
string |
Het foutbericht. |
| target |
string |
Het doel van de specifieke fout. |
ApiErrorBase
Api-foutbasis.
| Name | Type | Description |
|---|---|---|
| code |
string |
De foutcode. |
| message |
string |
Het foutbericht. |
| target |
string |
Het doel van de specifieke fout. |
AttachDetachDataDisksRequest
Hiermee geeft u de invoer voor het koppelen en loskoppelen van een lijst met beheerde gegevensschijven.
| Name | Type | Description |
|---|---|---|
| dataDisksToAttach |
De lijst met beheerde gegevensschijven die moeten worden gekoppeld. |
|
| dataDisksToDetach |
De lijst met beheerde gegevensschijven die moeten worden losgekoppeld. |
CachingTypes
Hiermee geeft u de cachevereisten op. Mogelijke waarden zijn: Geen,Alleen-lezen,Lezen'. De standaardwaarden zijn: Geen voor standaardopslag. ReadOnly voor Premium opslag
| Waarde | Description |
|---|---|
| None | |
| ReadOnly | |
| ReadWrite |
CloudError
Een foutreactie van de Compute-service.
| Name | Type | Description |
|---|---|---|
| error |
Api-fout. |
DataDisk
Beschrijft een gegevensschijf.
| Name | Type | Description |
|---|---|---|
| caching |
Hiermee geeft u de cachevereisten op. Mogelijke waarden zijn: None,ReadOnlyReadWrite. Het standaardgedrag is: Geen voor Standard-opslag. ReadOnly voor Premium-opslag. |
|
| createOption |
Hiermee geeft u op hoe de schijf van de virtuele machine moet worden gemaakt. Mogelijke waarden zijn Koppelen: Deze waarde wordt gebruikt wanneer u een gespecialiseerde schijf gebruikt om de virtuele machine te maken. FromImage: Deze waarde wordt gebruikt wanneer u een installatiekopie gebruikt om de gegevensschijf van de virtuele machine te maken. Als u een platforminstallatiekopie gebruikt, moet u ook het element imageReference gebruiken dat hierboven wordt beschreven. Als u een marketplace-installatiekopieën gebruikt, moet u ook het eerder beschreven planelement gebruiken. Leeg: Deze waarde wordt gebruikt bij het maken van een lege gegevensschijf. Kopiëren: Deze waarde wordt gebruikt om een gegevensschijf te maken op basis van een momentopname of een andere schijf. Herstellen: Deze waarde wordt gebruikt om een gegevensschijf te maken vanaf een schijfherstelpunt. |
|
| deleteOption |
Hiermee geeft u op of de gegevensschijf moet worden verwijderd of losgekoppeld bij het verwijderen van de virtuele machine. Mogelijke waarden zijn: Verwijderen. Als deze waarde wordt gebruikt, wordt de gegevensschijf verwijderd wanneer de VIRTUELE machine wordt verwijderd. Loskoppelen. Als deze waarde wordt gebruikt, blijft de gegevensschijf behouden nadat de VIRTUELE machine is verwijderd. De standaardwaarde is ingesteld op Loskoppelen. |
|
| detachOption |
Hiermee geeft u het loskoppelgedrag op dat moet worden gebruikt tijdens het loskoppelen van een schijf of die al bezig is met loskoppelen van de virtuele machine. Ondersteunde waarden: ForceDetach. detachOption: ForceDetach- is alleen van toepassing op beheerde gegevensschijven. Als een vorige loskoppelpoging van de gegevensschijf niet is voltooid vanwege een onverwachte fout van de virtuele machine en de schijf nog steeds niet wordt vrijgegeven, gebruikt u force-loskoppelen als laatste redmiddeloptie om de schijf geforceerd los te koppelen van de virtuele machine. Alle schrijfbewerkingen zijn mogelijk niet leeggemaakt wanneer u dit loskoppelgedrag gebruikt. Deze functie is nog in preview-versie. Als u een gegevensschijfupdate wilt afdwingen naarBeDetached in 'true' samen met de instelling detachOption: 'ForceDetach'. |
|
| diskIOPSReadWrite |
integer (int64) |
Hiermee geeft u de Read-Write IOPS op voor de beheerde schijf wanneer StorageAccountType is UltraSSD_LRS. |
| diskMBpsReadWrite |
integer (int64) |
Hiermee geeft u de bandbreedte in MB per seconde op voor de beheerde schijf wanneer StorageAccountType is UltraSSD_LRS. |
| diskSizeGB |
integer (int32) |
Hiermee geeft u de grootte van een lege gegevensschijf in gigabytes. Dit element kan worden gebruikt om de grootte van de schijf in een installatiekopieën van een virtuele machine te overschrijven. De eigenschap diskSizeGB is het aantal bytes x 1024^3 voor de schijf en de waarde mag niet groter zijn dan 1023. |
| image |
De virtuele harde schijf van de brongebruiker. De virtuele harde schijf wordt gekopieerd voordat deze aan de virtuele machine wordt gekoppeld. Als SourceImage is opgegeven, mag de virtuele doelschijf niet bestaan. |
|
| lun |
integer (int32) |
Hiermee geeft u het nummer van de logische eenheid van de gegevensschijf. Deze waarde wordt gebruikt om gegevensschijven binnen de VIRTUELE machine te identificeren en moet daarom uniek zijn voor elke gegevensschijf die is gekoppeld aan een VIRTUELE machine. |
| managedDisk |
De parameters van de beheerde schijf. |
|
| name |
string |
De naam van de schijf. |
| sourceResource |
De bronresource-id. Het kan een momentopname of een schijfherstelpunt zijn van waaruit een schijf moet worden gemaakt. |
|
| storageFaultDomainAlignment |
Specificeert het type uitlijning van het opslagfoutdomein voor de schijf. |
|
| toBeDetached |
boolean |
Hiermee geeft u op of de gegevensschijf wordt losgekoppeld van de VirtualMachine/VirtualMachineScaleset |
| vhd |
De virtuele harde schijf. |
|
| writeAcceleratorEnabled |
boolean |
Hiermee geeft u op of writeAccelerator moet worden ingeschakeld of uitgeschakeld op de schijf. |
DataDisksToAttach
Beschrijft de gegevensschijf die moet worden gekoppeld.
| Name | Type | Description |
|---|---|---|
| caching |
Hiermee geeft u de cachevereisten op. Mogelijke waarden zijn: None,ReadOnlyReadWrite. Het standaardgedrag is: Geen voor Standard-opslag. ReadOnly voor Premium-opslag. |
|
| deleteOption |
Hiermee geeft u op of de gegevensschijf moet worden verwijderd of losgekoppeld bij het verwijderen van de virtuele machine. Mogelijke waarden zijn: Verwijderen. Als deze waarde wordt gebruikt, wordt de gegevensschijf verwijderd wanneer de VIRTUELE machine wordt verwijderd. Loskoppelen. Als deze waarde wordt gebruikt, blijft de gegevensschijf behouden nadat de VIRTUELE machine is verwijderd. De standaardwaarde is ingesteld op Loskoppelen. |
|
| diskEncryptionSet |
Hiermee geeft u de resource-id van de door de klant beheerde schijfversleutelingsset voor de beheerde schijf op. |
|
| diskId |
string |
Id van de beheerde gegevensschijf. |
| lun |
integer (int32) |
Het logische eenheidsnummer van de gegevensschijf. Deze waarde wordt gebruikt om gegevensschijven binnen de VIRTUELE machine te identificeren en moet daarom uniek zijn voor elke gegevensschijf die is gekoppeld aan een VIRTUELE machine. Als dit niet is opgegeven, wordt lun automatisch toegewezen. |
| writeAcceleratorEnabled |
boolean |
Hiermee geeft u op of writeAccelerator moet worden ingeschakeld of uitgeschakeld op de schijf. |
DataDisksToDetach
Beschrijft de gegevensschijf die moet worden losgekoppeld.
| Name | Type | Description |
|---|---|---|
| detachOption |
Ondersteunde opties die beschikbaar zijn voor het loskoppelen van een schijf vanaf een virtuele machine. Raadpleeg DetachOption-objectverwijzing voor meer informatie. |
|
| diskId |
string |
Id van de beheerde gegevensschijf. |
DiffDiskOptions
Hiermee geeft u de optie voor kortstondige schijf op voor de schijf van het besturingssysteem.
| Waarde | Description |
|---|---|
| Local |
DiffDiskPlacement
Hiermee geeft u de tijdelijke schijfplaatsing voor de besturingssysteemschijf. Deze eigenschap kan door de gebruiker worden gebruikt in het verzoek om de locatie te kiezen, d.w.z. cacheschijf, bronschijf of nvme-schijfruimte voor kortstondige OS-schijfinrichting. Voor meer informatie over de vereisten voor schijfgrootte van Ephemeral OS, zie Ephemeral OS schijfgroottevereisten voor Windows VM op https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements en Linux VM op https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Minimale API-versie voor NvmeDisk: 2024-03-01.
| Waarde | Description |
|---|---|
| CacheDisk | |
| ResourceDisk | |
| NvmeDisk |
DiffDiskSettings
Beschrijft de parameters van tijdelijke schijfinstellingen die kunnen worden opgegeven voor de besturingssysteemschijf. Opmerking: De tijdelijke schijfinstellingen kunnen alleen worden opgegeven voor beheerde schijven.
| Name | Type | Description |
|---|---|---|
| enableFullCaching |
boolean |
Geeft aan of volledige caching voor deze VM moet worden ingeschakeld, waardoor de OS-schijf lokaal op de host wordt gecachet en deze VM bestand wordt tegen opslaguitval |
| option |
Hiermee geeft u de tijdelijke schijfinstellingen voor de besturingssysteemschijf. |
|
| placement |
Hiermee geeft u de tijdelijke schijfplaatsing voor de besturingssysteemschijf. Mogelijke waarden zijn: CacheDisk,ResourceDisk,NvmeDisk. Het standaardgedrag is: CacheDisk als deze is geconfigureerd voor de VM-grootte, anders wordt ResourceDisk of NvmeDisk- gebruikt. Raadpleeg de documentatie over de VM-grootte voor Windows-VM's op https://docs.microsoft.com/azure/virtual-machines/windows/sizes en Linux-VM op https://docs.microsoft.com/azure/virtual-machines/linux/sizes om te controleren welke VM-grootten een cacheschijf beschikbaar maken. Minimale API-versie voor NvmeDisk: 2024-03-01. |
DiskControllerTypes
Hiermee geeft u het type schijfcontroller geconfigureerd voor de VIRTUELE machine en VirtualMachineScaleSet. Deze eigenschap wordt alleen ondersteund voor virtuele machines waarvan de besturingssysteemschijf en VM-sku Generatie 2 (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2) ondersteunen; controleer alstublieft de HyperVGenerations-functionaliteit die als onderdeel van VM-sku-mogelijkheden wordt weergegeven in de respons van Microsoft. De API van de Compute SKUs voor de regio bevat V2 (https://docs.microsoft.com/rest/api/compute/resourceskus/list). Raadpleeg https://aka.ms/azure-diskcontrollertypesvoor meer informatie over ondersteunde schijfcontrollertypen.
| Waarde | Description |
|---|---|
| SCSI | |
| NVMe |
DiskCreateOptionTypes
Hiermee geeft u op hoe de schijf van de virtuele machine moet worden gemaakt. Mogelijke waarden zijn Koppelen: Deze waarde wordt gebruikt wanneer u een gespecialiseerde schijf gebruikt om de virtuele machine te maken. FromImage: Deze waarde wordt gebruikt wanneer u een installatiekopie gebruikt om de virtuele machine te maken. Als u een platforminstallatiekopie gebruikt, moet u ook het element imageReference gebruiken dat hierboven wordt beschreven. Als u een marketplace-installatiekopieën gebruikt, moet u ook het eerder beschreven planelement gebruiken. Leeg: Deze waarde wordt gebruikt bij het maken van een lege gegevensschijf. Kopiëren: Deze waarde wordt gebruikt om een gegevensschijf te maken op basis van een momentopname of een andere schijf. Herstellen: Deze waarde wordt gebruikt om een gegevensschijf te maken vanaf een schijfherstelpunt.
| Waarde | Description |
|---|---|
| FromImage | |
| Empty | |
| Attach | |
| Copy | |
| Restore |
DiskDeleteOptionTypes
Hiermee geeft u het gedrag van de beheerde schijf op wanneer de virtuele machine wordt verwijderd, bijvoorbeeld of de beheerde schijf wordt verwijderd of losgekoppeld. Ondersteunde waarden zijn: Verwijderen. Als deze waarde wordt gebruikt, wordt de beheerde schijf verwijderd wanneer de VIRTUELE machine wordt verwijderd. Loskoppelen. Als deze waarde wordt gebruikt, blijft de beheerde schijf behouden nadat de VIRTUELE machine is verwijderd. Minimale API-versie: 2021-03-01.
| Waarde | Description |
|---|---|
| Delete | |
| Detach |
DiskDetachOptionTypes
Hiermee geeft u het loskoppelgedrag op dat moet worden gebruikt tijdens het loskoppelen van een schijf of die al bezig is met loskoppelen van de virtuele machine. Ondersteunde waarden zijn: ForceDetach. detachOption: ForceDetach is alleen van toepassing op beheerde gegevensschijven. Als een vorige loskoppelpoging van de gegevensschijf niet is voltooid vanwege een onverwachte fout van de virtuele machine en de schijf nog steeds niet wordt vrijgegeven, gebruikt u force-loskoppelen als laatste redmiddeloptie om de schijf geforceerd los te koppelen van de virtuele machine. Alle schrijfbewerkingen zijn mogelijk niet leeggemaakt wanneer u dit loskoppelgedrag gebruikt. Deze functie is nog in preview-versie. Als u een gegevensschijfupdate wilt afdwingen naarBeDetached in 'true' samen met de instelling detachOption: 'ForceDetach'.
| Waarde | Description |
|---|---|
| ForceDetach |
DiskEncryptionSetParameters
Beschrijft de parameter van de resource-id van de door de klant beheerde schijfversleutelingsset die kan worden opgegeven voor schijf. Opmerking: de resource-id van de schijfversleutelingsset kan alleen worden opgegeven voor beheerde schijven. Raadpleeg https://aka.ms/mdssewithcmkoverview voor meer informatie.
| Name | Type | Description |
|---|---|---|
| id |
string |
Resource-id |
DiskEncryptionSettings
Beschrijft een versleutelingsinstelling voor een schijf
| Name | Type | Description |
|---|---|---|
| diskEncryptionKey |
Specificeert de locatie van de schijfencryptiesleutel, die een Key Vault Secret is. |
|
| enabled |
boolean |
Hiermee geeft u op of schijfversleuteling moet worden ingeschakeld op de virtuele machine. |
| keyEncryptionKey |
Specificeert de locatie van de sleutelsleutel voor encryptie in Key Vault. |
ImageReference
Hiermee geeft u informatie over de te gebruiken afbeelding. U kunt informatie opgeven over platforminstallatiekopieën, marketplace-installatiekopieën of installatiekopieën van virtuele machines. Dit element is vereist wanneer u een platforminstallatiekopie, marketplace-installatiekopie of installatiekopie van virtuele machines wilt gebruiken, maar niet wordt gebruikt in andere bewerkingen voor het maken. OPMERKING: De uitgever en aanbieding van afbeeldingsreferentie kunnen alleen worden ingesteld wanneer u de schaalset maakt.
| Name | Type | Description |
|---|---|---|
| communityGalleryImageId |
string |
De unieke id van de communitygalerie opgegeven voor vm-implementatie. Dit kan worden opgehaald uit de get-aanroep van de communitygalerieafbeelding. |
| exactVersion |
string |
Geeft in decimale getallen de versie van de platformafbeelding of marktplaatsafbeelding op die is gebruikt om de virtuele machine te maken. Dit alleen-lezen veld verschilt alleen van 'versie' als de waarde die is opgegeven in het veld 'versie' 'nieuwste' is. |
| id |
string |
Resource-id |
| offer |
string |
Hiermee geeft u de aanbieding op van de platforminstallatiekopieën of marketplace-installatiekopieën die worden gebruikt om de virtuele machine te maken. |
| publisher |
string |
De image publisher. |
| sharedGalleryImageId |
string |
De unieke id van de gedeelde galerie-installatiekopieën opgegeven voor vm-implementatie. Dit kan worden opgehaald uit de get-aanroep van de installatiekopieën in de gedeelde galerie. |
| sku |
string |
De installatiekopieën-SKU. |
| version |
string |
Hiermee geeft u de versie van de platforminstallatiekopieën of marketplace-installatiekopieën op die worden gebruikt om de virtuele machine te maken. De toegestane indelingen zijn Major.Minor.Build of 'latest'. Primaire, secundaire en build zijn decimale getallen. Geef 'nieuwste' op om de nieuwste versie van een installatiekopieën te gebruiken die beschikbaar is tijdens de implementatie. Zelfs als u 'nieuwste' gebruikt, wordt de VM-installatiekopie niet automatisch bijgewerkt na de implementatietijd, zelfs niet als er een nieuwe versie beschikbaar is. Gebruik alsjeblieft geen veld 'versie' voor galerijafbeeldingen, galerijafbeelding moet altijd het veld 'id' gebruiken voor deployment, om de 'nieuwste' versie van de galerijafbeelding te gebruiken, stel gewoon '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft in. Compute/galleries/{galleryName}/images/{imageName}' in het veld 'id' zonder versie-invoer. |
InnerError
Interne foutdetails.
| Name | Type | Description |
|---|---|---|
| errordetail |
string |
De interne foutmelding of uitzonderingsdump. |
| exceptiontype |
string |
Het uitzonderingstype. |
KeyVaultKeyReference
Beschrijft een verwijzing naar Key Vault Key
| Name | Type | Description |
|---|---|---|
| keyUrl |
string |
De URL verwijst naar een sleutelversleutelsleutel in Key Vault. |
| sourceVault |
De relatieve URL van de Key Vault die de sleutel bevat. |
KeyVaultSecretReference
Beschrijft een verwijzing naar Key Vault Secret
| Name | Type | Description |
|---|---|---|
| secretUrl |
string |
De URL verwijst naar een geheim in een Key Vault. |
| sourceVault |
De relatieve URL van de Key Vault die het geheim bevat. |
ManagedDiskParameters
De parameters van een beheerde schijf.
| Name | Type | Description |
|---|---|---|
| diskEncryptionSet |
Hiermee geeft u de resource-id van de door de klant beheerde schijfversleutelingsset voor de beheerde schijf op. |
|
| id |
string |
Resource-id |
| securityProfile |
Hiermee geeft u het beveiligingsprofiel voor de beheerde schijf. |
|
| storageAccountType |
Hiermee geeft u het type opslagaccount voor de beheerde schijf. OPMERKING: UltraSSD_LRS kan alleen worden gebruikt met gegevensschijven, deze kan niet worden gebruikt met besturingssysteemschijf. |
OperatingSystemTypes
Met deze eigenschap kunt u het type besturingssysteem opgeven dat op de schijf is opgenomen als u een virtuele machine maakt op basis van een aangepaste installatiekopie. Mogelijke waarden zijn: Windows,Linux.
| Waarde | Description |
|---|---|
| Windows | |
| Linux |
OSDisk
Hiermee geeft u informatie op over de besturingssysteemschijf die wordt gebruikt door de virtuele machine. Voor meer informatie over schijven, zie Over schijven en VHD's voor Azure virtuele machines.
| Name | Type | Description |
|---|---|---|
| caching |
Hiermee geeft u de cachevereisten op. Mogelijke waarden zijn: None,ReadOnlyReadWrite. Het standaardgedrag is: Geen voor Standard-opslag. ReadOnly voor Premium-opslag. |
|
| createOption |
Hiermee geeft u op hoe de schijf van de virtuele machine moet worden gemaakt. Mogelijke waarden zijn Koppelen: Deze waarde wordt gebruikt wanneer u een gespecialiseerde schijf gebruikt om de virtuele machine te maken. FromImage: Deze waarde wordt gebruikt wanneer u een installatiekopie gebruikt om de virtuele machine te maken. Als u een platforminstallatiekopie gebruikt, moet u ook het element imageReference gebruiken dat hierboven wordt beschreven. Als u een marketplace-installatiekopieën gebruikt, moet u ook het eerder beschreven planelement gebruiken. |
|
| deleteOption |
Hiermee geeft u op of de besturingssysteemschijf moet worden verwijderd of losgekoppeld bij het verwijderen van de virtuele machine. Mogelijke waarden zijn: Verwijderen. Als deze waarde wordt gebruikt, wordt de besturingssysteemschijf verwijderd wanneer de VIRTUELE machine wordt verwijderd. Loskoppelen. Als deze waarde wordt gebruikt, blijft de besturingssysteemschijf behouden nadat de VIRTUELE machine is verwijderd. De standaardwaarde is ingesteld op Loskoppelen. Voor een tijdelijke besturingssysteemschijf is de standaardwaarde ingesteld op Verwijderen. De gebruiker kan de verwijderoptie voor een tijdelijke besturingssysteemschijf niet wijzigen. |
|
| diffDiskSettings |
Hiermee geeft u de tijdelijke schijfinstellingen voor de besturingssysteemschijf die door de virtuele machine wordt gebruikt. |
|
| diskSizeGB |
integer (int32) |
Hiermee geeft u de grootte van een lege gegevensschijf in gigabytes. Dit element kan worden gebruikt om de grootte van de schijf in een installatiekopieën van een virtuele machine te overschrijven. De eigenschap diskSizeGB is het aantal bytes x 1024^3 voor de schijf en de waarde mag niet groter zijn dan 1023. |
| encryptionSettings |
Hiermee geeft u de versleutelingsinstellingen voor de besturingssysteemschijf. Minimale API-versie: 2015-06-15. |
|
| image |
De virtuele harde schijf van de brongebruiker. De virtuele harde schijf wordt gekopieerd voordat deze aan de virtuele machine wordt gekoppeld. Als SourceImage is opgegeven, mag de virtuele doelschijf niet bestaan. |
|
| managedDisk |
De parameters van de beheerde schijf. |
|
| name |
string |
De naam van de schijf. |
| osType |
Met deze eigenschap kunt u het type besturingssysteem opgeven dat is opgenomen in de schijf als u een virtuele machine maakt op basis van een gebruikersinstallatiekopie of een gespecialiseerde VHD. Mogelijke waarden zijn: Windows,Linux. |
|
| storageFaultDomainAlignment |
Specificeert het type uitlijning van het opslagfoutdomein voor de schijf. |
|
| vhd |
De virtuele harde schijf. |
|
| writeAcceleratorEnabled |
boolean |
Hiermee geeft u op of writeAccelerator moet worden ingeschakeld of uitgeschakeld op de schijf. |
SecurityEncryptionTypes
Hiermee geeft u het EncryptionType van de beheerde schijf. Deze is ingesteld op DiskWithVMGuestState voor versleuteling van de beheerde schijf, samen met VMGuestState-blob, VMGuestStateOnly voor versleuteling van alleen de VMGuestState-blob en NonPersistedTPM voor het niet behouden van de firmwarestatus in de VMGuestState-blob.. Opmerking: Deze kan alleen worden ingesteld voor vertrouwelijke VM's.
| Waarde | Description |
|---|---|
| VMGuestStateOnly | |
| DiskWithVMGuestState | |
| NonPersistedTPM |
StorageAccountTypes
Hiermee geeft u het type opslagaccount voor de beheerde schijf. Het opslagaccounttype beheerde besturingssysteemschijf kan alleen worden ingesteld wanneer u de schaalset maakt. OPMERKING: UltraSSD_LRS kan alleen worden gebruikt met gegevensschijven. Het kan niet worden gebruikt met besturingssysteemschijf. Standard_LRS maakt gebruik van Standard HDD. StandardSSD_LRS maakt gebruik van Standard SSD. Premium_LRS maakt gebruik van Premium SSD. UltraSSD_LRS maakt gebruik van Ultra disk. Premium_ZRS maakt gebruik van premium SSD-zone-redundante opslag. StandardSSD_ZRS maakt gebruik van zone-redundante opslag met Standard SSD. Voor meer informatie over schijven die voor Windows Virtual Machines worden ondersteund, zie https://docs.microsoft.com/azure/virtual-machines/windows/disks-types en voor Linux-Virtual Machines https://docs.microsoft.com/azure/virtual-machines/linux/disks-types
| Waarde | Description |
|---|---|
| Standard_LRS | |
| Premium_LRS | |
| StandardSSD_LRS | |
| UltraSSD_LRS | |
| Premium_ZRS | |
| StandardSSD_ZRS | |
| PremiumV2_LRS |
StorageFaultDomainAlignmentType
Specificeert het type uitlijning van het opslagfoutdomein voor de schijf.
| Waarde | Description |
|---|---|
| Aligned |
Schijfopslagfoutdomeinen worden gekoppeld aan rekenfoutdomeinen. Deployment faalt als de schijf niet genoeg Fault Domains ondersteunt. |
| BestEffortAligned |
Probeer opslagfoutdomeinen te mappen naar berekeningsfoutdomeinen. Schijven zijn niet uitgelijnd als de schijf niet genoeg Foutdomeinen ondersteunt. |
StorageProfile
Hiermee geeft u de opslaginstellingen voor de schijven van de virtuele machine op.
| Name | Type | Description |
|---|---|---|
| alignRegionalDisksToVMZone |
boolean |
Hiermee geeft u op of de regionale schijven moeten worden uitgelijnd/verplaatst naar de VM-zone. Dit is alleen van toepassing op VM's waarvoor plaatsingseigenschappen zijn ingesteld. Houd er rekening mee dat deze wijziging niet ongedaan kan worden. Minimale API-versie: 2024-11-01. |
| dataDisks |
Data |
Hiermee geeft u de parameters op die worden gebruikt om een gegevensschijf toe te voegen aan een virtuele machine. Voor meer informatie over schijven, zie Over schijven en VHD's voor Azure virtuele machines. |
| diskControllerType |
Hiermee geeft u het type schijfcontroller geconfigureerd voor de virtuele machine. Opmerking: Deze eigenschap wordt ingesteld op het standaardtype schijfcontroller als er geen opgegeven virtuele machine wordt gemaakt met hyperVGeneratie ingesteld op V2 op basis van de mogelijkheden van de besturingssysteemschijf en VM-grootte van de opgegeven minimale API-versie. U moet de toewijzing van de VIRTUELE machine ongedaan maken voordat u het type schijfcontroller bijwerkt, tenzij u de VM-grootte bijwerkt in de VM-configuratie die impliciet de toewijzing ongedaan maakt en de VM opnieuw toewijst. Minimale API-versie: 2022-08-01. |
|
| imageReference |
Hiermee geeft u informatie over de te gebruiken afbeelding. U kunt informatie opgeven over platforminstallatiekopieën, marketplace-installatiekopieën of installatiekopieën van virtuele machines. Dit element is vereist wanneer u een platforminstallatiekopie, marketplace-installatiekopie of installatiekopie van virtuele machines wilt gebruiken, maar niet wordt gebruikt in andere bewerkingen voor het maken. |
|
| osDisk |
Hiermee geeft u informatie op over de besturingssysteemschijf die wordt gebruikt door de virtuele machine. Voor meer informatie over schijven, zie Over schijven en VHD's voor Azure virtuele machines. |
SubResource
| Name | Type | Description |
|---|---|---|
| id |
string |
Resource-id |
VirtualHardDisk
Beschrijft de URI van een schijf.
| Name | Type | Description |
|---|---|---|
| uri |
string |
Hiermee geeft u de URI van de virtuele harde schijf. |
VMDiskSecurityProfile
Hiermee geeft u de beveiligingsprofielinstellingen voor de beheerde schijf. Opmerking: Deze kan alleen worden ingesteld voor vertrouwelijke VM's.
| Name | Type | Description |
|---|---|---|
| diskEncryptionSet |
Hiermee geeft u de door de klant beheerde schijfversleutelingssetresource-id op voor de beheerde schijf die wordt gebruikt voor door de klant beheerde sleutel versleutelde ConfidentialVM-besturingssysteemschijf en VMGuest-blob. |
|
| securityEncryptionType |
Hiermee geeft u het EncryptionType van de beheerde schijf. Deze is ingesteld op DiskWithVMGuestState voor versleuteling van de beheerde schijf, samen met VMGuestState-blob, VMGuestStateOnly voor versleuteling van alleen de VMGuestState-blob en NonPersistedTPM voor het niet behouden van de firmwarestatus in de VMGuestState-blob.. Opmerking: Deze kan alleen worden ingesteld voor vertrouwelijke VM's. |