Delen via


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
resourceGroupName
path True

string

De naam van de resourcegroep.

subscriptionId
path True

string

Abonnementsreferenties die het Microsoft Azure-abonnement uniek identificeren. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.

vmName
path True

string

De naam van de virtuele machine.

api-version
query True

string

Client-API-versie.

Aanvraagbody

Name Type Description
parameters

AttachDetachDataDisksRequest

Parameters die zijn opgegeven voor de bewerking voor het koppelen en loskoppelen van gegevensschijven op de virtuele machine.

Antwoorden

Name Type Description
200 OK

StorageProfile

OK

202 Accepted

Geaccepteerd

Kopteksten

Location: string

Other Status Codes

CloudError

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

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen
VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

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
ApiEntityReference

De bronresource-id. Het kan een momentopname of een schijfherstelpunt zijn van waaruit een schijf moet worden gemaakt.

ApiError

Api-fout.

ApiErrorBase

Api-foutbasis.

AttachDetachDataDisksRequest

Parameters die zijn opgegeven voor de bewerking voor het koppelen en loskoppelen van gegevensschijven op de virtuele machine.

CachingTypes

Hiermee geeft u de cachevereisten op. Mogelijke waarden zijn: None,ReadOnlyReadWrite. Het standaardgedrag is: Geen voor Standard-opslag. ReadOnly voor Premium-opslag.

CloudError

Een foutreactie van de Compute-service.

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.

DataDisksToAttach

De lijst met beheerde gegevensschijven die moeten worden gekoppeld.

DataDisksToDetach

De lijst met beheerde gegevensschijven die moeten worden losgekoppeld.

DiffDiskOptions

Hiermee geeft u de tijdelijke schijfinstellingen voor de besturingssysteemschijf.

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.

DiffDiskSettings

Hiermee geeft u de tijdelijke schijfinstellingen voor de besturingssysteemschijf die door de virtuele machine wordt gebruikt.

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.

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.

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.

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

DiskEncryptionSetParameters

Hiermee geeft u de resource-id van de door de klant beheerde schijfversleutelingsset voor de beheerde schijf op.

DiskEncryptionSettings

Hiermee geeft u de versleutelingsinstellingen voor de besturingssysteemschijf. Minimale API-versie: 2015-06-15.

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.

InnerError

Interne foutdetails.

KeyVaultKeyReference

Hiermee geeft u de locatie van de sleutelversleutelingssleutel in Key Vault.

KeyVaultSecretReference

Hiermee geeft u de locatie van de schijfversleutelingssleutel, een Sleutelkluisgeheim.

ManagedDiskParameters

De parameters van de beheerde schijf.

OperatingSystemTypes

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.

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.

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.

StorageProfile

Hiermee geeft u de opslaginstellingen voor de schijven van de virtuele machine op.

SubResource
VirtualHardDisk

De virtuele harde schijf.

VMDiskSecurityProfile

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

ApiErrorBase[]

Details van de API-fout

innererror

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

DataDisksToAttach[]

De lijst met beheerde gegevensschijven die moeten worden gekoppeld.

dataDisksToDetach

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

ApiError

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

CachingTypes

Hiermee geeft u de cachevereisten op. Mogelijke waarden zijn: None,ReadOnlyReadWrite. Het standaardgedrag is: Geen voor Standard-opslag. ReadOnly voor Premium-opslag.

createOption

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

DiskDeleteOptionTypes

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

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

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

VirtualHardDisk

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

ManagedDiskParameters

De parameters van de beheerde schijf.

name

string

De naam van de schijf.

sourceResource

ApiEntityReference

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

VirtualHardDisk

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

CachingTypes

Hiermee geeft u de cachevereisten op. Mogelijke waarden zijn: None,ReadOnlyReadWrite. Het standaardgedrag is: Geen voor Standard-opslag. ReadOnly voor Premium-opslag.

deleteOption

DiskDeleteOptionTypes

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

DiskEncryptionSetParameters

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

DiskDetachOptionTypes

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

DiffDiskOptions

Hiermee geeft u de tijdelijke schijfinstellingen voor de besturingssysteemschijf.

placement

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.

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

KeyVaultSecretReference

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

KeyVaultKeyReference

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

SubResource

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

SubResource

De relatieve URL van de sleutelkluis die het geheim bevat.

ManagedDiskParameters

De parameters van de beheerde schijf.

Name Type Description
diskEncryptionSet

DiskEncryptionSetParameters

Hiermee geeft u de resource-id van de door de klant beheerde schijfversleutelingsset voor de beheerde schijf op.

id

string

Resource-id

securityProfile

VMDiskSecurityProfile

Hiermee geeft u het beveiligingsprofiel voor de beheerde schijf.

storageAccountType

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.

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

CachingTypes

Hiermee geeft u de cachevereisten op. Mogelijke waarden zijn: None,ReadOnlyReadWrite. Het standaardgedrag is: Geen voor Standard-opslag. ReadOnly voor Premium-opslag.

createOption

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.

deleteOption

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.

diffDiskSettings

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

DiskEncryptionSettings

Hiermee geeft u de versleutelingsinstellingen voor de besturingssysteemschijf. Minimale API-versie: 2015-06-15.

image

VirtualHardDisk

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

ManagedDiskParameters

De parameters van de beheerde schijf.

name

string

De naam van de schijf.

osType

OperatingSystemTypes

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

VirtualHardDisk

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

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.

diskControllerType

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.

imageReference

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

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

DiskEncryptionSetParameters

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

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.