Dela via


Virtual Machines - Attach Detach Data Disks

Koppla och koppla från datadiskar till/från den virtuella datorn.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/virtualMachines/{vmName}/attachDetachDataDisks?api-version=2025-04-01

URI-parametrar

Name I Obligatorisk Typ Description
resourceGroupName
path True

string

minLength: 1
maxLength: 90

Namnet på resursgruppen. Namnet är skiftlägesokänsligt.

subscriptionId
path True

string

minLength: 1

ID för målprenumerationen.

vmName
path True

string

Namnet på den virtuella datorn.

api-version
query True

string

minLength: 1

Den API-version som ska användas för den här åtgärden.

Begärandetext

Name Typ Description
dataDisksToAttach

DataDisksToAttach[]

Listan över hanterade datadiskar som ska bifogas.

dataDisksToDetach

DataDisksToDetach[]

Listan över hanterade datadiskar som ska kopplas från.

Svar

Name Typ Description
200 OK

StorageProfile

Azure-åtgärden har slutförts.

202 Accepted

Resursåtgärden har godkänts.

Sidhuvuden

  • Location: string
  • Retry-After: integer
Other Status Codes

CloudError

Ett oväntat felsvar.

Säkerhet

azure_auth

Azure Active Directory OAuth2-flöde.

Typ: oauth2
Flow: implicit
Auktoriseringswebbadress: https://login.microsoftonline.com/common/oauth2/authorize

Omfattningar

Name Description
user_impersonation personifiera ditt användarkonto

Exempel

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen
VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

Exempelbegäran

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaaaaaaaaa/attachDetachDataDisks?api-version=2025-04-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"
    }
  ]
}

Exempelsvar

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

Exempelbegäran

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/azure-vm/attachDetachDataDisks?api-version=2025-04-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"
    }
  ]
}

Exempelsvar

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

Definitioner

Name Description
ApiEntityReference

API-entitetsreferensen.

ApiError

API-fel.

ApiErrorBase

bas för API-fel.

AttachDetachDataDisksRequest

Anger indata för att koppla och koppla från en lista över hanterade datadiskar.

CachingTypes

Anger cachelagringskraven. Möjliga värden är: None,ReadOnly,ReadWrite. Standardvärdena är: Ingen för Standard Storage. ReadOnly för Premium-lagring

CloudError

Ett felsvar från beräkningstjänsten.

DataDisk

Beskriver en datadisk.

DataDisksToAttach

Beskriver den datadisk som ska anslutas.

DataDisksToDetach

Beskriver den datadisk som ska kopplas från.

DiffDiskOptions

Anger det tillfälliga diskalternativet för operativsystemdisken.

DiffDiskPlacement

Anger den tillfälliga diskplaceringen för operativsystemdisken. Den här egenskapen kan användas av användaren i begäran för att välja plats, t.ex. cachedisk, resursdisk eller nvme-diskutrymme för etablering av tillfälliga OS-diskar. Mer information om krav för tillfällig OS-diskstorlek finns i Krav på tillfällig OS-diskstorlek för virtuella Windows-datorer på https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements och virtuella Linux-datorer på https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Lägsta api-version för NvmeDisk: 2024-03-01.

DiffDiskSettings

Beskriver parametrarna för tillfälliga diskinställningar som kan anges för operativsystemdisken. Obs! De tillfälliga diskinställningarna kan bara anges för hanterad disk.

DiskControllerTypes

Anger vilken typ av diskkontrollant som konfigurerats för den virtuella datorn och VirtualMachineScaleSet. Den här egenskapen stöds endast för virtuella datorer vars operativsystemdisk och VM-SKU stöder generation 2 (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2), kontrollera funktionen HyperVGenerations som returneras som en del av vm-sku-funktionerna i svaret från Microsoft.Compute SKU:er api för regionen innehåller V2 (https://docs.microsoft.com/rest/api/compute/resourceskus/list). Mer information om diskkontrollanttyper som stöds finns i https://aka.ms/azure-diskcontrollertypes.

DiskCreateOptionTypes

Anger hur den virtuella datordisken ska skapas. Möjliga värden är Bifoga: Det här värdet används när du använder en specialiserad disk för att skapa den virtuella datorn. FromImage: Det här värdet används när du använder en avbildning för att skapa den virtuella datorn. Om du använder en plattformsavbildning bör du också använda imageReference-elementet som beskrivs ovan. Om du använder en Marketplace-avbildning bör du också använda det planelement som beskrevs tidigare. Tom: Det här värdet används när du skapar en tom datadisk. Kopiera: Det här värdet används för att skapa en datadisk från en ögonblicksbild eller en annan disk. Återställ: Det här värdet används för att skapa en datadisk från en diskåterställningspunkt.

DiskDeleteOptionTypes

Anger beteendet för den hanterade disken när den virtuella datorn tas bort, till exempel om den hanterade disken tas bort eller kopplas från. Värden som stöds är: Ta bort. Om det här värdet används tas den hanterade disken bort när den virtuella datorn tas bort. Lösgöra. Om det här värdet används behålls den hanterade disken när den virtuella datorn tas bort. Lägsta API-version: 2021-03-01.

DiskDetachOptionTypes

Anger det frånkopplingsbeteende som ska användas när en disk kopplas från eller som redan håller på att kopplas från från den virtuella datorn. Värden som stöds är: ForceDetach. detachOption: ForceDetach gäller endast för hanterade datadiskar. Om ett tidigare frånkopplingsförsök av datadisken inte slutfördes på grund av ett oväntat fel från den virtuella datorn och disken fortfarande inte har släppts använder du force-detach som ett sista utvägsalternativ för att koppla från disken med två våld från den virtuella datorn. Alla skrivningar kanske inte har tömts när du använder det här frånkopplingsbeteendet. Den här funktionen är fortfarande i förhandsversion. För att tvinga bort en datadiskuppdatering tillBeDetached till "true" tillsammans med inställningen detachOption: "ForceDetach".

DiskEncryptionSetParameters

Beskriver parametern för resurs-ID för kundhanterad diskkrypteringsuppsättning som kan anges för disk. Obs! Diskkrypteringsuppsättningens resurs-ID kan bara anges för hanterad disk. Mer information finns i https://aka.ms/mdssewithcmkoverview.

DiskEncryptionSettings

Beskriver en krypteringsinställning för en disk

ImageReference

Anger information om den avbildning som ska användas. Du kan ange information om plattformsbilder, marketplace-avbildningar eller avbildningar av virtuella datorer. Det här elementet krävs när du vill använda en plattformsbild, marketplace-avbildning eller virtuell datorbild, men inte används i andra skapandeåtgärder. Obs! Bildreferensutgivare och -erbjudande kan bara anges när du skapar skalningsuppsättningen.

InnerError

Inre felinformation.

KeyVaultKeyReference

Beskriver en referens till 密钥保管库 nyckel

KeyVaultSecretReference

Beskriver en referens till Key Vault Secret

ManagedDiskParameters

Parametrarna för en hanterad disk.

OperatingSystemTypes

Med den här egenskapen kan du ange vilken typ av operativsystem som ingår i disken om du skapar en virtuell dator från användaravbildning eller en specialiserad virtuell hårddisk. Möjliga värden är: Windows,Linux.

OSDisk

Anger information om den operativsystemdisk som används av den virtuella datorn. Mer information om diskar finns i Om diskar och virtuella hårddiskar för virtuella Azure-datorer.

SecurityEncryptionTypes

Anger EncryptionType för den hanterade disken. Den är inställd på DiskWithVMGuestState för kryptering av den hanterade disken tillsammans med VMGuestState-blob, VMGuestStateOnly för kryptering av bara VMGuestState-bloben och NonPersistedTPM för att inte bevara tillståndet för inbyggd programvara i VMGuestState-bloben. Obs! Det kan endast anges för konfidentiella virtuella datorer.

StorageAccountTypes

Anger lagringskontotypen för den hanterade disken. Kontotypen hanterad os-disklagring kan bara anges när du skapar skalningsuppsättningen. OBS: UltraSSD_LRS kan endast användas med datadiskar. Den kan inte användas med OS Disk. Standard_LRS använder standardhårddisk. StandardSSD_LRS använder Standard SSD. Premium_LRS använder Premium SSD. UltraSSD_LRS använder Ultra Disk. Premium_ZRS använder Premium SSD-zonredundant lagring. StandardSSD_ZRS använder zonredundant lagring av standard-SSD. Mer information om diskar som stöds för Windows Virtual Machines finns i https://docs.microsoft.com/azure/virtual-machines/windows/disks-types och, för Linux Virtual Machines, se https://docs.microsoft.com/azure/virtual-machines/linux/disks-types

StorageProfile

Anger lagringsinställningarna för de virtuella datordiskarna.

SubResource
VirtualHardDisk

Beskriver URI för en disk.

VMDiskSecurityProfile

Anger säkerhetsprofilinställningarna för den hanterade disken. Obs! Det kan bara anges för konfidentiella virtuella datorer.

ApiEntityReference

API-entitetsreferensen.

Name Typ Description
id

string

ARM-resurs-ID i form av /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

ApiError

API-fel.

Name Typ Description
code

string

Felkoden.

details

ApiErrorBase[]

Information om API-fel

innererror

InnerError

Det inre API-felet

message

string

Felmeddelandet.

target

string

Målet för det specifika felet.

ApiErrorBase

bas för API-fel.

Name Typ Description
code

string

Felkoden.

message

string

Felmeddelandet.

target

string

Målet för det specifika felet.

AttachDetachDataDisksRequest

Anger indata för att koppla och koppla från en lista över hanterade datadiskar.

Name Typ Description
dataDisksToAttach

DataDisksToAttach[]

Listan över hanterade datadiskar som ska bifogas.

dataDisksToDetach

DataDisksToDetach[]

Listan över hanterade datadiskar som ska kopplas från.

CachingTypes

Anger cachelagringskraven. Möjliga värden är: None,ReadOnly,ReadWrite. Standardvärdena är: Ingen för Standard Storage. ReadOnly för Premium-lagring

Värde Description
None
ReadOnly
ReadWrite

CloudError

Ett felsvar från beräkningstjänsten.

Name Typ Description
error

ApiError

API-fel.

DataDisk

Beskriver en datadisk.

Name Typ Description
caching

CachingTypes

Anger cachelagringskraven. Möjliga värden är: Ingen,ReadOnlyReadWrite. Standardbeteendet är: Ingen för standardlagring. ReadOnly för Premium Storage.

createOption

DiskCreateOptionTypes

Anger hur den virtuella datordisken ska skapas. Möjliga värden är Bifoga: Det här värdet används när du använder en specialiserad disk för att skapa den virtuella datorn. FromImage: Det här värdet används när du använder en avbildning för att skapa datadisken för den virtuella datorn. Om du använder en plattformsavbildning bör du också använda imageReference-elementet som beskrivs ovan. Om du använder en Marketplace-avbildning bör du också använda det planelement som beskrevs tidigare. Tom: Det här värdet används när du skapar en tom datadisk. Kopiera: Det här värdet används för att skapa en datadisk från en ögonblicksbild eller en annan disk. Återställ: Det här värdet används för att skapa en datadisk från en diskåterställningspunkt.

deleteOption

DiskDeleteOptionTypes

Anger om datadisken ska tas bort eller kopplas från vid borttagning av virtuella datorer. Möjliga värden är: Ta bort. Om det här värdet används tas datadisken bort när den virtuella datorn tas bort. Lösgöra. Om det här värdet används behålls datadisken när den virtuella datorn har tagits bort. Standardvärdet är inställt på Koppla från.

detachOption

DiskDetachOptionTypes

Anger det frånkopplingsbeteende som ska användas när en disk kopplas från eller som redan håller på att kopplas från från den virtuella datorn. Värden som stöds: ForceDetach. detachOption: ForceDetach gäller endast för hanterade datadiskar. Om ett tidigare frånkopplingsförsök av datadisken inte slutfördes på grund av ett oväntat fel från den virtuella datorn och disken fortfarande inte har släppts använder du force-detach som ett sista utvägsalternativ för att koppla från disken med två våld från den virtuella datorn. Alla skrivningar kanske inte har tömts när du använder det här frånkopplingsbeteendet. Den här funktionen är fortfarande i förhandsversion. För att tvinga bort en datadiskuppdatering tillBeDetached till "true" tillsammans med inställningen detachOption: "ForceDetach".

diskIOPSReadWrite

integer (int64)

Anger Read-Write IOPS för den hanterade disken när StorageAccountType UltraSSD_LRS.

diskMBpsReadWrite

integer (int64)

Anger bandbredden i MB per sekund för den hanterade disken när StorageAccountType UltraSSD_LRS.

diskSizeGB

integer (int32)

Anger storleken på en tom datadisk i gigabyte. Det här elementet kan användas för att skriva över storleken på disken i en virtuell datorbild. Egenskapen "diskSizeGB" är antalet byte x 1024^3 för disken och värdet får inte vara större än 1023.

image

VirtualHardDisk

Den virtuella hårddisken för källanvändarens avbildning. Den virtuella hårddisken kopieras innan den ansluts till den virtuella datorn. Om SourceImage tillhandahålls får den virtuella målhårdenheten inte finnas.

lun

integer (int32)

Anger datadiskens logiska enhetsnummer. Det här värdet används för att identifiera datadiskar i den virtuella datorn och måste därför vara unikt för varje datadisk som är ansluten till en virtuell dator.

managedDisk

ManagedDiskParameters

Parametrarna för hanterade diskar.

name

string

Disknamnet.

sourceResource

ApiEntityReference

Källresursidentifieraren. Det kan vara en ögonblicksbild eller en diskåterställningspunkt för att skapa en disk.

toBeDetached

boolean

Anger om datadisken håller på att kopplas från VirtualMachine/VirtualMachineScaleset

vhd

VirtualHardDisk

Den virtuella hårddisken.

writeAcceleratorEnabled

boolean

Anger om writeAccelerator ska aktiveras eller inaktiveras på disken.

DataDisksToAttach

Beskriver den datadisk som ska anslutas.

Name Typ Description
caching

CachingTypes

Anger cachelagringskraven. Möjliga värden är: Ingen,ReadOnlyReadWrite. Standardbeteendet är: Ingen för standardlagring. ReadOnly för Premium Storage.

deleteOption

DiskDeleteOptionTypes

Anger om datadisken ska tas bort eller kopplas från vid borttagning av virtuella datorer. Möjliga värden är: Ta bort. Om det här värdet används tas datadisken bort när den virtuella datorn tas bort. Lösgöra. Om det här värdet används behålls datadisken när den virtuella datorn har tagits bort. Standardvärdet är inställt på Koppla från.

diskEncryptionSet

DiskEncryptionSetParameters

Anger resurs-ID för kundhanterad diskkrypteringsuppsättning för den hanterade disken.

diskId

string

ID för den hanterade datadisken.

lun

integer (int32)

Det logiska enhetsnumret för datadisken. Det här värdet används för att identifiera datadiskar i den virtuella datorn och måste därför vara unikt för varje datadisk som är ansluten till en virtuell dator. Om inget anges tilldelas lun automatiskt.

writeAcceleratorEnabled

boolean

Anger om writeAccelerator ska aktiveras eller inaktiveras på disken.

DataDisksToDetach

Beskriver den datadisk som ska kopplas från.

Name Typ Description
detachOption

DiskDetachOptionTypes

Alternativ som stöds är tillgängliga för frånkoppling av en disk från en virtuell dator. Mer information finns i objektreferensen för DetachOption.

diskId

string

ID för den hanterade datadisken.

DiffDiskOptions

Anger det tillfälliga diskalternativet för operativsystemdisken.

Värde Description
Local

DiffDiskPlacement

Anger den tillfälliga diskplaceringen för operativsystemdisken. Den här egenskapen kan användas av användaren i begäran för att välja plats, t.ex. cachedisk, resursdisk eller nvme-diskutrymme för etablering av tillfälliga OS-diskar. Mer information om krav för tillfällig OS-diskstorlek finns i Krav på tillfällig OS-diskstorlek för virtuella Windows-datorer på https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements och virtuella Linux-datorer på https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Lägsta api-version för NvmeDisk: 2024-03-01.

Värde Description
CacheDisk
ResourceDisk
NvmeDisk

DiffDiskSettings

Beskriver parametrarna för tillfälliga diskinställningar som kan anges för operativsystemdisken. Obs! De tillfälliga diskinställningarna kan bara anges för hanterad disk.

Name Typ Description
option

DiffDiskOptions

Anger tillfälliga diskinställningar för operativsystemdisken.

placement

DiffDiskPlacement

Anger den tillfälliga diskplaceringen för operativsystemdisken. Möjliga värden är: CacheDisk,ResourceDiskNvmeDisk. Standardbeteendet är: CacheDisk om en har konfigurerats för den virtuella datorns storlek, annars används ResourceDisk eller NvmeDisk. Se dokumentationen om VM-storlek för virtuella Windows-datorer på https://docs.microsoft.com/azure/virtual-machines/windows/sizes och virtuell Linux-dator på https://docs.microsoft.com/azure/virtual-machines/linux/sizes för att kontrollera vilka VM-storlekar som exponerar en cachedisk. Lägsta api-version för NvmeDisk: 2024-03-01.

DiskControllerTypes

Anger vilken typ av diskkontrollant som konfigurerats för den virtuella datorn och VirtualMachineScaleSet. Den här egenskapen stöds endast för virtuella datorer vars operativsystemdisk och VM-SKU stöder generation 2 (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2), kontrollera funktionen HyperVGenerations som returneras som en del av vm-sku-funktionerna i svaret från Microsoft.Compute SKU:er api för regionen innehåller V2 (https://docs.microsoft.com/rest/api/compute/resourceskus/list). Mer information om diskkontrollanttyper som stöds finns i https://aka.ms/azure-diskcontrollertypes.

Värde Description
SCSI
NVMe

DiskCreateOptionTypes

Anger hur den virtuella datordisken ska skapas. Möjliga värden är Bifoga: Det här värdet används när du använder en specialiserad disk för att skapa den virtuella datorn. FromImage: Det här värdet används när du använder en avbildning för att skapa den virtuella datorn. Om du använder en plattformsavbildning bör du också använda imageReference-elementet som beskrivs ovan. Om du använder en Marketplace-avbildning bör du också använda det planelement som beskrevs tidigare. Tom: Det här värdet används när du skapar en tom datadisk. Kopiera: Det här värdet används för att skapa en datadisk från en ögonblicksbild eller en annan disk. Återställ: Det här värdet används för att skapa en datadisk från en diskåterställningspunkt.

Värde Description
FromImage
Empty
Attach
Copy
Restore

DiskDeleteOptionTypes

Anger beteendet för den hanterade disken när den virtuella datorn tas bort, till exempel om den hanterade disken tas bort eller kopplas från. Värden som stöds är: Ta bort. Om det här värdet används tas den hanterade disken bort när den virtuella datorn tas bort. Lösgöra. Om det här värdet används behålls den hanterade disken när den virtuella datorn tas bort. Lägsta API-version: 2021-03-01.

Värde Description
Delete
Detach

DiskDetachOptionTypes

Anger det frånkopplingsbeteende som ska användas när en disk kopplas från eller som redan håller på att kopplas från från den virtuella datorn. Värden som stöds är: ForceDetach. detachOption: ForceDetach gäller endast för hanterade datadiskar. Om ett tidigare frånkopplingsförsök av datadisken inte slutfördes på grund av ett oväntat fel från den virtuella datorn och disken fortfarande inte har släppts använder du force-detach som ett sista utvägsalternativ för att koppla från disken med två våld från den virtuella datorn. Alla skrivningar kanske inte har tömts när du använder det här frånkopplingsbeteendet. Den här funktionen är fortfarande i förhandsversion. För att tvinga bort en datadiskuppdatering tillBeDetached till "true" tillsammans med inställningen detachOption: "ForceDetach".

Värde Description
ForceDetach

DiskEncryptionSetParameters

Beskriver parametern för resurs-ID för kundhanterad diskkrypteringsuppsättning som kan anges för disk. Obs! Diskkrypteringsuppsättningens resurs-ID kan bara anges för hanterad disk. Mer information finns i https://aka.ms/mdssewithcmkoverview.

Name Typ Description
id

string

Resurs-ID

DiskEncryptionSettings

Beskriver en krypteringsinställning för en disk

Name Typ Description
diskEncryptionKey

KeyVaultSecretReference

Anger platsen för diskkrypteringsnyckeln, som är en Nyckelvalvshemlighet.

enabled

boolean

Anger om diskkryptering ska aktiveras på den virtuella datorn.

keyEncryptionKey

KeyVaultKeyReference

Anger platsen för nyckelkrypteringsnyckeln i Key Vault.

ImageReference

Anger information om den avbildning som ska användas. Du kan ange information om plattformsbilder, marketplace-avbildningar eller avbildningar av virtuella datorer. Det här elementet krävs när du vill använda en plattformsbild, marketplace-avbildning eller virtuell datorbild, men inte används i andra skapandeåtgärder. Obs! Bildreferensutgivare och -erbjudande kan bara anges när du skapar skalningsuppsättningen.

Name Typ Description
communityGalleryImageId

string

Angav communitygalleriets unika ID för vm-distribution. Det här kan hämtas från get-anropet för communitygalleribilden.

exactVersion

string

Anger i decimaltal vilken version av plattformsavbildningen eller Marketplace-avbildningen som används för att skapa den virtuella datorn. Det här skrivskyddade fältet skiljer sig från "version" endast om värdet som anges i fältet "version" är "senaste".

id

string

Resurs-ID

offer

string

Anger erbjudandet för plattformsbilden eller marketplace-avbildningen som används för att skapa den virtuella datorn.

publisher

string

Bildutgivaren.

sharedGalleryImageId

string

Angav det unika ID:t för den delade galleriavbildningen för vm-distribution. Detta kan hämtas från get-anropet för den delade galleribilden.

sku

string

Avbildnings-SKU:n.

version

string

Anger vilken version av plattformsbilden eller marketplace-avbildningen som används för att skapa den virtuella datorn. De tillåtna formaten är Major.Minor.Build eller "latest". Major, Minor och Build är decimaltal. Ange "senaste" för att använda den senaste versionen av en avbildning som är tillgänglig vid distributionstillfället. Även om du använder "senaste" uppdateras inte den virtuella datoravbildningen automatiskt efter distributionstiden även om en ny version blir tillgänglig. Använd inte fältet "version" för distribution av galleribilder. Galleribild bör alltid använda id-fältet för distribution, för att använda den senaste versionen av galleribilden, ange bara '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/galleries/{galleryName}/images/{imageName}' i fältet "id" utan indata från versionen.

InnerError

Inre felinformation.

Name Typ Description
errordetail

string

Det interna felmeddelandet eller undantagsdumpen.

exceptiontype

string

Typen av undantag.

KeyVaultKeyReference

Beskriver en referens till 密钥保管库 nyckel

Name Typ Description
keyUrl

string

URL:en som refererar till en nyckelkrypteringsnyckel i Key Vault.

sourceVault

SubResource

Den relativa URL:en för nyckelvalvet som innehåller nyckeln.

KeyVaultSecretReference

Beskriver en referens till Key Vault Secret

Name Typ Description
secretUrl

string

URL:en som refererar till en hemlighet i ett Nyckelvalv.

sourceVault

SubResource

Den relativa URL:en för nyckelvalvet som innehåller hemligheten.

ManagedDiskParameters

Parametrarna för en hanterad disk.

Name Typ Description
diskEncryptionSet

DiskEncryptionSetParameters

Anger resurs-ID för kundhanterad diskkrypteringsuppsättning för den hanterade disken.

id

string

Resurs-ID

securityProfile

VMDiskSecurityProfile

Anger säkerhetsprofilen för den hanterade disken.

storageAccountType

StorageAccountTypes

Anger lagringskontotypen för den hanterade disken. Obs! UltraSSD_LRS endast kan användas med datadiskar kan den inte användas med OS-disk.

OperatingSystemTypes

Med den här egenskapen kan du ange vilken typ av operativsystem som ingår i disken om du skapar en virtuell dator från användaravbildning eller en specialiserad virtuell hårddisk. Möjliga värden är: Windows,Linux.

Värde Description
Windows
Linux

OSDisk

Anger information om den operativsystemdisk som används av den virtuella datorn. Mer information om diskar finns i Om diskar och virtuella hårddiskar för virtuella Azure-datorer.

Name Typ Description
caching

CachingTypes

Anger cachelagringskraven. Möjliga värden är: Ingen,ReadOnlyReadWrite. Standardbeteendet är: Ingen för standardlagring. ReadOnly för Premium Storage.

createOption

DiskCreateOptionTypes

Anger hur den virtuella datordisken ska skapas. Möjliga värden är Bifoga: Det här värdet används när du använder en specialiserad disk för att skapa den virtuella datorn. FromImage: Det här värdet används när du använder en avbildning för att skapa den virtuella datorn. Om du använder en plattformsavbildning bör du också använda imageReference-elementet som beskrivs ovan. Om du använder en Marketplace-avbildning bör du också använda det planelement som beskrevs tidigare.

deleteOption

DiskDeleteOptionTypes

Anger om OS-disken ska tas bort eller kopplas från när den virtuella datorn tas bort. Möjliga värden är: Ta bort. Om det här värdet används tas OS-disken bort när den virtuella datorn tas bort. Lösgöra. Om det här värdet används behålls os-disken när den virtuella datorn har tagits bort. Standardvärdet är inställt på Koppla från. För en tillfällig OS-disk är standardvärdet inställt på Ta bort. Användaren kan inte ändra borttagningsalternativet för en tillfällig OS-disk.

diffDiskSettings

DiffDiskSettings

Anger tillfälliga diskinställningar för den operativsystemdisk som används av den virtuella datorn.

diskSizeGB

integer (int32)

Anger storleken på en tom datadisk i gigabyte. Det här elementet kan användas för att skriva över storleken på disken i en virtuell datorbild. Egenskapen "diskSizeGB" är antalet byte x 1024^3 för disken och värdet får inte vara större än 1023.

encryptionSettings

DiskEncryptionSettings

Anger krypteringsinställningarna för OS-disken. Lägsta API-version: 2015-06-15.

image

VirtualHardDisk

Den virtuella hårddisken för källanvändarens avbildning. Den virtuella hårddisken kopieras innan den ansluts till den virtuella datorn. Om SourceImage tillhandahålls får den virtuella målhårdenheten inte finnas.

managedDisk

ManagedDiskParameters

Parametrarna för hanterade diskar.

name

string

Disknamnet.

osType

OperatingSystemTypes

Med den här egenskapen kan du ange vilken typ av operativsystem som ingår i disken om du skapar en virtuell dator från användaravbildning eller en specialiserad virtuell hårddisk. Möjliga värden är: Windows,Linux.

vhd

VirtualHardDisk

Den virtuella hårddisken.

writeAcceleratorEnabled

boolean

Anger om writeAccelerator ska aktiveras eller inaktiveras på disken.

SecurityEncryptionTypes

Anger EncryptionType för den hanterade disken. Den är inställd på DiskWithVMGuestState för kryptering av den hanterade disken tillsammans med VMGuestState-blob, VMGuestStateOnly för kryptering av bara VMGuestState-bloben och NonPersistedTPM för att inte bevara tillståndet för inbyggd programvara i VMGuestState-bloben. Obs! Det kan endast anges för konfidentiella virtuella datorer.

Värde Description
VMGuestStateOnly
DiskWithVMGuestState
NonPersistedTPM

StorageAccountTypes

Anger lagringskontotypen för den hanterade disken. Kontotypen hanterad os-disklagring kan bara anges när du skapar skalningsuppsättningen. OBS: UltraSSD_LRS kan endast användas med datadiskar. Den kan inte användas med OS Disk. Standard_LRS använder standardhårddisk. StandardSSD_LRS använder Standard SSD. Premium_LRS använder Premium SSD. UltraSSD_LRS använder Ultra Disk. Premium_ZRS använder Premium SSD-zonredundant lagring. StandardSSD_ZRS använder zonredundant lagring av standard-SSD. Mer information om diskar som stöds för Windows Virtual Machines finns i https://docs.microsoft.com/azure/virtual-machines/windows/disks-types och, för Linux Virtual Machines, se https://docs.microsoft.com/azure/virtual-machines/linux/disks-types

Värde Description
Standard_LRS
Premium_LRS
StandardSSD_LRS
UltraSSD_LRS
Premium_ZRS
StandardSSD_ZRS
PremiumV2_LRS

StorageProfile

Anger lagringsinställningarna för de virtuella datordiskarna.

Name Typ Description
alignRegionalDisksToVMZone

boolean

Anger om de regionala diskarna ska justeras/flyttas till vm-zonen. Detta gäller endast för virtuella datorer med placeringsegenskapen inställd. Observera att den här ändringen inte kan ångras. Lägsta API-version: 2024-11-01.

dataDisks

DataDisk[]

Anger de parametrar som används för att lägga till en datadisk till en virtuell dator. Mer information om diskar finns i Om diskar och virtuella hårddiskar för virtuella Azure-datorer.

diskControllerType

DiskControllerTypes

Anger vilken typ av diskkontrollant som konfigurerats för den virtuella datorn. Obs! Den här egenskapen anges till standardtypen för diskkontrollanten om den inte anges, förutsatt att den virtuella datorn skapas med "hyperVGeneration" inställt på V2 baserat på funktionerna för operativsystemdisken och VM-storleken från den angivna lägsta API-versionen. Du måste frigöra den virtuella datorn innan du uppdaterar dess typ av diskkontrollant såvida du inte uppdaterar vm-storleken i VM-konfigurationen som implicit frigör och omallokerar den virtuella datorn. Lägsta API-version: 2022-08-01.

imageReference

ImageReference

Anger information om den avbildning som ska användas. Du kan ange information om plattformsbilder, marketplace-avbildningar eller avbildningar av virtuella datorer. Det här elementet krävs när du vill använda en plattformsbild, marketplace-avbildning eller virtuell datorbild, men inte används i andra skapandeåtgärder.

osDisk

OSDisk

Anger information om den operativsystemdisk som används av den virtuella datorn. Mer information om diskar finns i Om diskar och virtuella hårddiskar för virtuella Azure-datorer.

SubResource

Name Typ Description
id

string

Resurs-ID

VirtualHardDisk

Beskriver URI för en disk.

Name Typ Description
uri

string

Anger den virtuella hårddiskens URI.

VMDiskSecurityProfile

Anger säkerhetsprofilinställningarna för den hanterade disken. Obs! Det kan bara anges för konfidentiella virtuella datorer.

Name Typ Description
diskEncryptionSet

DiskEncryptionSetParameters

Anger resurs-ID för kundhanterad diskkrypteringsuppsättning för den hanterade disk som används för customer managed key encrypted ConfidentialVM OS Disk och VMGuest blob.

securityEncryptionType

SecurityEncryptionTypes

Anger EncryptionType för den hanterade disken. Den är inställd på DiskWithVMGuestState för kryptering av den hanterade disken tillsammans med VMGuestState-blob, VMGuestStateOnly för kryptering av bara VMGuestState-bloben och NonPersistedTPM för att inte bevara tillståndet för inbyggd programvara i VMGuestState-bloben. Obs! Det kan endast anges för konfidentiella virtuella datorer.