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=2024-07-01
URI-parameters
Name | In | Vereist | Type | Description |
---|---|---|---|---|
resource
|
path | True |
string |
De naam van de resourcegroep. |
subscription
|
path | True |
string |
Abonnementsreferenties die het Microsoft Azure-abonnement uniek identificeren. De abonnements-id maakt deel uit van de URI voor elke serviceoproep. |
vm
|
path | True |
string |
De naam van de virtuele machine. |
api-version
|
query | True |
string |
Client-API-versie. |
Aanvraagbody
Name | Type | Description |
---|---|---|
parameters |
Parameters die zijn opgegeven voor de bewerking voor het koppelen en loskoppelen van gegevensschijven op de virtuele machine. |
Antwoorden
Name | Type | Description |
---|---|---|
200 OK |
OK |
|
202 Accepted |
Geaccepteerd Kopteksten Location: string |
|
Other Status Codes |
Foutreactie waarin wordt beschreven waarom de bewerking is mislukt. |
Beveiliging
azure_auth
Azure Active Directory OAuth2-stroom
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=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"
}
]
}
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=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"
}
]
}
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 bronresource-id. Het kan een momentopname of een schijfherstelpunt zijn van waaruit een schijf moet worden gemaakt. |
Api |
Api-fout. |
Api |
Api-foutbasis. |
Attach |
Parameters die zijn opgegeven voor de bewerking voor het koppelen en loskoppelen van gegevensschijven op de virtuele machine. |
Caching |
Hiermee geeft u de cachevereisten op. Mogelijke waarden zijn: None,ReadOnlyReadWrite. Het standaardgedrag is: Geen voor Standard-opslag. ReadOnly voor Premium-opslag. |
Cloud |
Een foutreactie van de Compute-service. |
Data |
Hiermee geeft u de parameters op die worden gebruikt om een gegevensschijf toe te voegen aan een virtuele machine. Zie Over schijven en VHD's voor virtuele Azure-machinesvoor meer informatie over schijven. |
Data |
De lijst met beheerde gegevensschijven die moeten worden gekoppeld. |
Data |
De lijst met beheerde gegevensschijven die moeten worden losgekoppeld. |
Diff |
Hiermee geeft u de tijdelijke schijfinstellingen voor de besturingssysteemschijf. |
Diff |
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. |
Diff |
Hiermee geeft u de tijdelijke schijfinstellingen voor de besturingssysteemschijf die door de virtuele machine wordt gebruikt. |
Disk |
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. |
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. |
Disk |
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. |
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: 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. Als u een gegevensschijfupdate wilt afdwingen naarBeDetached in 'true' samen met de instelling detachOption: 'ForceDetach'. |
Disk |
Hiermee geeft u de resource-id van de door de klant beheerde schijfversleutelingsset voor de beheerde schijf op. |
Disk |
Hiermee geeft u de versleutelingsinstellingen voor de besturingssysteemschijf. Minimale API-versie: 2015-06-15. |
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. |
Inner |
Interne foutdetails. |
Key |
Hiermee geeft u de locatie van de sleutelversleutelingssleutel in Key Vault. |
Key |
Hiermee geeft u de locatie van de schijfversleutelingssleutel, een Sleutelkluisgeheim. |
Managed |
De parameters van de beheerde schijf. |
Operating |
Het type besturingssysteem. |
OSDisk |
Hiermee geeft u informatie op over de besturingssysteemschijf die wordt gebruikt door de virtuele machine. Zie Over schijven en VHD's voor virtuele Azure-machinesvoor meer informatie over schijven. |
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. OPMERKING: UltraSSD_LRS kan alleen worden gebruikt met gegevensschijven, deze kan niet worden gebruikt met besturingssysteemschijf. |
Storage |
Hiermee geeft u de opslaginstellingen voor de schijven van de virtuele machine op. |
Sub |
|
Virtual |
De virtuele harde schijf. |
VMDisk |
Hiermee geeft u het beveiligingsprofiel voor de beheerde schijf. |
ApiEntityReference
De bronresource-id. Het kan een momentopname of een schijfherstelpunt zijn van waaruit een schijf moet worden gemaakt.
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 interne API-fout |
|
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
Parameters die zijn opgegeven voor de bewerking voor het koppelen en loskoppelen van gegevensschijven op de virtuele machine.
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: None,ReadOnlyReadWrite. Het standaardgedrag is: Geen voor Standard-opslag. ReadOnly voor Premium-opslag.
Name | Type | Description |
---|---|---|
None |
string |
|
ReadOnly |
string |
|
ReadWrite |
string |
CloudError
Een foutreactie van de Compute-service.
Name | Type | Description |
---|---|---|
error |
Api-fout. |
DataDisk
Hiermee geeft u de parameters op die worden gebruikt om een gegevensschijf toe te voegen aan een virtuele machine. Zie Over schijven en VHD's voor virtuele Azure-machinesvoor meer informatie over schijven.
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. Als u een gegevensschijfupdate wilt afdwingen naarBeDetached in 'true' samen met de instelling detachOption: 'ForceDetach'. |
|
diskIOPSReadWrite |
integer |
Hiermee geeft u de Read-Write IOPS voor de beheerde schijf wanneer StorageAccountType is UltraSSD_LRS. Alleen geretourneerd voor VM-schijven van VirtualMachine ScaleSet. Kan alleen worden bijgewerkt via updates voor de VirtualMachine-schaalset. |
diskMBpsReadWrite |
integer |
Hiermee geeft u de bandbreedte in MB per seconde voor de beheerde schijf op wanneer StorageAccountType is UltraSSD_LRS. Alleen geretourneerd voor VM-schijven van VirtualMachine ScaleSet. Kan alleen worden bijgewerkt via updates voor de VirtualMachine-schaalset. |
diskSizeGB |
integer |
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 |
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. |
|
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
De lijst met beheerde gegevensschijven die moeten 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 |
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
De lijst met beheerde gegevensschijven die moeten 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 tijdelijke schijfinstellingen voor de besturingssysteemschijf.
Name | Type | Description |
---|---|---|
Local |
string |
DiffDiskPlacement
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.
Name | Type | Description |
---|---|---|
CacheDisk |
string |
|
NvmeDisk |
string |
|
ResourceDisk |
string |
DiffDiskSettings
Hiermee geeft u de tijdelijke schijfinstellingen voor de besturingssysteemschijf die door de virtuele machine wordt gebruikt.
Name | Type | Description |
---|---|---|
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. 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.
Name | Type | Description |
---|---|---|
NVMe |
string |
|
SCSI |
string |
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.
Name | Type | Description |
---|---|---|
Attach |
string |
|
Copy |
string |
|
Empty |
string |
|
FromImage |
string |
|
Restore |
string |
DiskDeleteOptionTypes
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.
Name | Type | Description |
---|---|---|
Delete |
string |
|
Detach |
string |
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: 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. Als u een gegevensschijfupdate wilt afdwingen naarBeDetached in 'true' samen met de instelling detachOption: 'ForceDetach'.
Name | Type | Description |
---|---|---|
ForceDetach |
string |
DiskEncryptionSetParameters
Hiermee geeft u de resource-id van de door de klant beheerde schijfversleutelingsset voor de beheerde schijf op.
Name | Type | Description |
---|---|---|
id |
string |
Resource-id |
DiskEncryptionSettings
Hiermee geeft u de versleutelingsinstellingen voor de besturingssysteemschijf. Minimale API-versie: 2015-06-15.
Name | Type | Description |
---|---|---|
diskEncryptionKey |
Hiermee geeft u de locatie van de schijfversleutelingssleutel, een Sleutelkluisgeheim. |
|
enabled |
boolean |
Hiermee geeft u op of schijfversleuteling moet worden ingeschakeld op de virtuele machine. |
keyEncryptionKey |
Hiermee geeft u de locatie van de sleutelversleutelingssleutel 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.
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 |
Hiermee geeft u de decimale getallen op, de versie van de platforminstallatiekopieën of marketplace-installatiekopieën die worden gebruikt om de virtuele machine te maken. Dit alleen-lezen veld verschilt van 'version', alleen als de waarde die is opgegeven in het veld 'version' 'latest' 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 uitgever van de installatiekopieën. |
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 het veld 'version' niet voor de implementatie van galerieafbeeldingen, de galerie-installatiekopieën moeten altijd het veld Id gebruiken voor implementatie, als u de meest recente versie van de galerie-installatiekopieën wilt gebruiken, stelt u '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageName}' in het veld Id in zonder versie-invoer. |
InnerError
Interne foutdetails.
Name | Type | Description |
---|---|---|
errordetail |
string |
Het interne foutbericht of de uitzonderingsdump. |
exceptiontype |
string |
Het uitzonderingstype. |
KeyVaultKeyReference
Hiermee geeft u de locatie van de sleutelversleutelingssleutel in Key Vault.
Name | Type | Description |
---|---|---|
keyUrl |
string |
De URL die verwijst naar een sleutelversleutelingssleutel in Key Vault. |
sourceVault |
De relatieve URL van de sleutelkluis die de sleutel bevat. |
KeyVaultSecretReference
Hiermee geeft u de locatie van de schijfversleutelingssleutel, een Sleutelkluisgeheim.
Name | Type | Description |
---|---|---|
secretUrl |
string |
De URL die verwijst naar een geheim in een Sleutelkluis. |
sourceVault |
De relatieve URL van de sleutelkluis die het geheim bevat. |
ManagedDiskParameters
De parameters van de 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
Het type besturingssysteem.
Name | Type | Description |
---|---|---|
Linux |
string |
|
Windows |
string |
OSDisk
Hiermee geeft u informatie op over de besturingssysteemschijf die wordt gebruikt door de virtuele machine. Zie Over schijven en VHD's voor virtuele Azure-machinesvoor meer informatie over schijven.
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 |
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. |
|
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.
Name | Type | Description |
---|---|---|
DiskWithVMGuestState |
string |
|
NonPersistedTPM |
string |
|
VMGuestStateOnly |
string |
StorageAccountTypes
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.
Name | Type | Description |
---|---|---|
PremiumV2_LRS |
string |
|
Premium_LRS |
string |
|
Premium_ZRS |
string |
|
StandardSSD_LRS |
string |
|
StandardSSD_ZRS |
string |
|
Standard_LRS |
string |
|
UltraSSD_LRS |
string |
StorageProfile
Hiermee geeft u de opslaginstellingen voor de schijven van de virtuele machine op.
Name | Type | Description |
---|---|---|
dataDisks |
Data |
Hiermee geeft u de parameters op die worden gebruikt om een gegevensschijf toe te voegen aan een virtuele machine. Zie Over schijven en VHD's voor virtuele Azure-machinesvoor meer informatie over schijven. |
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. Zie Over schijven en VHD's voor virtuele Azure-machinesvoor meer informatie over schijven. |
SubResource
Name | Type | Description |
---|---|---|
id |
string |
Resource-id |
VirtualHardDisk
De virtuele harde schijf.
Name | Type | Description |
---|---|---|
uri |
string |
Hiermee geeft u de URI van de virtuele harde schijf. |
VMDiskSecurityProfile
Hiermee geeft u het beveiligingsprofiel voor de beheerde schijf.
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. |