Virtual Machines - Attach Detach Data Disks

Dienst:: Compute

API-Version:: 2025-11-01

Anfügen und Trennen von Datenträgern an/vom virtuellen Computer.

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string minLength: 1	Die ID des Zielabonnements.
vmName	path	True	string	Der Name des virtuellen Computers.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Typ	Beschreibung
dataDisksToAttach	DataDisksToAttach[]	Die Liste der verwalteten Datenträger, die angefügt werden sollen.
dataDisksToDetach	DataDisksToDetach[]	Die Liste der verwalteten Datenträger, die getrennt werden sollen.

Antworten

Name	Typ	Beschreibung
200 OK	StorageProfile	Azure-Operation erfolgreich abgeschlossen.
202 Accepted		Ressourcenvorgang akzeptiert. Header Location: string Retry-After: integer
Other Status Codes	CloudError	Unerwartete Fehlerantwort.

Name

Typ

Beschreibung

200 OK

StorageProfile

Azure-Operation erfolgreich abgeschlossen.

202 Accepted

Ressourcenvorgang akzeptiert.

Header

Location: string
Retry-After: integer

Other Status Codes

CloudError

Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Identitätswechsel ihres Benutzerkontos

Beispiele

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

VirtualMachine_AttachDetachDataDisks_MaximumSet_Gen

Beispielanforderung

HTTP

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/aaaaaaaaaaaaaaaaaaaa/attachDetachDataDisks?api-version=2025-11-01

{
  "dataDisksToAttach": [
    {
      "lun": 1,
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d",
      "diskEncryptionSet": {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
      },
      "caching": "ReadOnly",
      "deleteOption": "Delete",
      "writeAcceleratorEnabled": true
    },
    {
      "lun": 2,
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_2_disk3_7d5e664bdafa49baa780eb2d128ff38e",
      "diskEncryptionSet": {
        "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/diskEncryptionSets/{existing-diskEncryptionSet-name}"
      },
      "caching": "ReadWrite",
      "deleteOption": "Detach",
      "writeAcceleratorEnabled": false
    }
  ],
  "dataDisksToDetach": [
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x",
      "detachOption": "ForceDetach"
    },
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_4_disk4_4d4e784bdafa49baa780eb2d256ff41z",
      "detachOption": "ForceDetach"
    }
  ]
}

Beispiel für eine Antwort

Statuscode:: 200

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

Statuscode:: 202

location: https://foo.com/operationstatus

VirtualMachine_AttachDetachDataDisks_MinimumSet_Gen

Beispielanforderung

HTTP

POST https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/rgcompute/providers/Microsoft.Compute/virtualMachines/azure-vm/attachDetachDataDisks?api-version=2025-11-01

{
  "dataDisksToAttach": [
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_0_disk2_6c4f554bdafa49baa780eb2d128ff39d"
    }
  ],
  "dataDisksToDetach": [
    {
      "diskId": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/vmss3176_vmss3176_1_disk1_1a4e784bdafa49baa780eb2d128ff65x"
    }
  ]
}

Beispiel für eine Antwort

Statuscode:: 200

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

Statuscode:: 202

location: https://foo.com/operationstatus

Definitionen

Name	Beschreibung
ApiEntityReference	Der API-Entitätsverweis.
ApiError	API-Fehler.
ApiErrorBase	API-Fehlerbasis.
AttachDetachDataDisksRequest	Gibt die Eingabe zum Anfügen und Trennen einer Liste verwalteter Datenträger an.
CachingTypes	Gibt die Zwischenspeicherungsanforderungen an. Mögliche Werte sind: None,ReadOnly,ReadWrite. Die Standardwerte sind: Keine für Standardspeicher. ReadOnly für Premium-Speicher
CloudError	Eine Fehlerantwort vom Compute-Dienst.
DataDisk	Beschreibt einen Datenträger.
DataDisksToAttach	Beschreibt den anzufügenden Datenträger.
DataDisksToDetach	Beschreibt den zu lösenden Datenträger.
DiffDiskOptions	Gibt die kurzlebige Datenträgeroption für den Betriebssystemdatenträger an.
DiffDiskPlacement	Gibt die kurzlebige Datenträgerplatzierung für den Betriebssystemdatenträger an. Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um den Speicherort auszuwählen, d. h. Cachedatenträger, Ressourcendatenträger oder NVME-Speicherplatz für die Bereitstellung von Ephemeral-Betriebssystemdatenträgern. Für weitere Informationen zu den Anforderungen an die Festplattengröße von Ephemeral OS siehe bitte die Anforderungen an die Festplattengröße eines Ephemeral OS für Windows VM unter https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements und Linux VM unter https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Mindest-API-Version für NvmeDisk: 2024-03-01.
DiffDiskSettings	Beschreibt die Parameter der kurzlebigen Datenträgereinstellungen, die für den Betriebssystemdatenträger angegeben werden können. Hinweis: Die kurzlebigen Datenträgereinstellungen können nur für verwaltete Datenträger angegeben werden.
DiskControllerTypes	Gibt den Datenträgercontrollertyp an, der für den virtuellen Computer und VirtualMachineScaleSet konfiguriert ist. Diese Eigenschaft wird nur für virtuelle Maschinen unterstützt, deren Betriebssystem-Festplatte und VM-SKU Generation 2 (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2 unterstützen; bitte prüfen Sie die HyperVGenerations-Fähigkeit, die als Teil der VM-SKU-Fähigkeiten in der Antwort von Microsoft zurückgegeben wird. Die API der Compute SKUs für die Region enthält V2 (https://docs.microsoft.com/rest/api/compute/resourceskus/list). Weitere Informationen zu unterstützten Datenträgercontrollertypen finden Sie unter https://aka.ms/azure-diskcontrollertypes.
DiskCreateOptionTypes	Gibt an, wie der virtuelle Computerdatenträger erstellt werden soll. Mögliche Werte sind Attach: Dieser Wert wird verwendet, wenn Sie einen speziellen Datenträger zum Erstellen des virtuellen Computers verwenden. FromImage: Dieser Wert wird verwendet, wenn Sie ein Image zum Erstellen des virtuellen Computers verwenden. Wenn Sie ein Plattformimage verwenden, sollten Sie auch das oben beschriebene imageReference-Element verwenden. Wenn Sie ein Marketplace-Image verwenden, sollten Sie auch das zuvor beschriebene Planelement verwenden. Leer: Dieser Wert wird beim Erstellen eines leeren Datenträgers verwendet. Kopieren: Dieser Wert wird verwendet, um einen Datenträger aus einer Momentaufnahme oder einem anderen Datenträger zu erstellen. Wiederherstellen: Dieser Wert wird verwendet, um einen Datenträger aus einem Datenträgerwiederherstellungspunkt zu erstellen.
DiskDeleteOptionTypes	Gibt das Verhalten des verwalteten Datenträgers an, wenn der virtuelle Computer gelöscht wird, z. B. ob der verwaltete Datenträger gelöscht oder getrennt wird. Unterstützte Werte sind: Löschen. Wenn dieser Wert verwendet wird, wird der verwaltete Datenträger gelöscht, wenn der virtuelle Computer gelöscht wird. Abtrennen. Wenn dieser Wert verwendet wird, wird der verwaltete Datenträger beibehalten, nachdem der virtuelle Computer gelöscht wurde. Mindest-API-Version: 2021-03-01.
DiskDetachOptionTypes	Gibt das Verhalten zum Trennen eines Datenträgers an, das beim Trennen eines Datenträgers verwendet werden soll oder das sich bereits im Prozess der Trennung vom virtuellen Computer befindet. Unterstützte Werte sind: ForceDetach. detachOption: ForceDetach gilt nur für verwaltete Datenträger. Wenn ein vorheriger Trennungsversuch des Datenträgers aufgrund eines unerwarteten Fehlers vom virtuellen Computer nicht abgeschlossen wurde und der Datenträger noch nicht freigegeben wird, verwenden Sie "Force-detach" als letzte Option zum Trennen des Datenträgers vom virtuellen Computer. Bei Verwendung dieses Trennverhaltens wurden möglicherweise nicht alle Schreibvorgänge geleert. Diese Funktion befindet sich noch in der Vorschauphase. Um das Trennen eines Datenträgerupdates auf "True" zu erzwingen, zusammen mit der Einstellung "tachOption: 'ForceDetach'"
DiskEncryptionSetParameters	Beschreibt den Parameter der vom Kunden verwalteten Datenträgerverschlüsselungssatz-Ressourcen-ID, die für den Datenträger angegeben werden kann. Hinweis: Die Ressourcen-ID des Datenträgerverschlüsselungssatzes kann nur für verwaltete Datenträger angegeben werden. Weitere Informationen finden Sie https://aka.ms/mdssewithcmkoverview.
DiskEncryptionSettings	Beschreibt eine Verschlüsselungseinstellungen für einen Datenträger
ImageReference	Gibt Informationen zum zu verwendenden Bild an. Sie können Informationen zu Plattformimages, Marketplace-Images oder virtuellen Computerimages angeben. Dieses Element ist erforderlich, wenn Sie ein Plattformimage, ein Marketplace-Image oder ein virtuelles Computerimage verwenden möchten, aber nicht in anderen Erstellungsvorgängen verwendet wird. HINWEIS: Der Herausgeber und das Angebot für Bildreferenzen können nur festgelegt werden, wenn Sie den Skalierungssatz erstellen.
InnerError	Innere Fehlerdetails.
KeyVaultKeyReference	Beschreibt einen Verweis auf Key Vault Key
KeyVaultSecretReference	Beschreibt einen Verweis auf Key Vault Secret
ManagedDiskParameters	Die Parameter eines verwalteten Datenträgers.
OperatingSystemTypes	Mit dieser Eigenschaft können Sie den Typ des Betriebssystems angeben, das auf dem Datenträger enthalten ist, wenn sie einen virtuellen Computer aus einem benutzerdefinierten Image erstellen. Mögliche Werte sind: Windows,Linux.
OSDisk	Gibt Informationen zum Betriebssystemdatenträger an, der vom virtuellen Computer verwendet wird. Weitere Informationen zu Festplatten finden Sie unter Über Festplatten und VHDs für Azure virtuelle Maschinen.
SecurityEncryptionTypes	Gibt den EncryptionType des verwalteten Datenträgers an. Es ist für die Verschlüsselung des verwalteten Datenträgers auf DiskWithVMGuestStateState festgelegt, vmGuestStateOnly für die Verschlüsselung nur des VMGuestState-Blobs und NonPersistedTPM, um den Firmwarestatus im VMGuestState-Blob nicht beizubehalten. Hinweis: Sie kann nur für vertrauliche virtuelle Computer festgelegt werden.
StorageAccountTypes	Gibt den Speicherkontotyp für den verwalteten Datenträger an. Der Typ des Verwalteten Betriebssystemspeicherkontos kann nur festgelegt werden, wenn Sie den Skalierungssatz erstellen. HINWEIS: UltraSSD_LRS kann nur mit Datenträgern verwendet werden. Sie kann nicht mit Betriebssystemdatenträger verwendet werden. Standard_LRS verwendet Standard-HDD. StandardSSD_LRS verwendet Standard-SSD. Premium_LRS verwendet Premium-SSD. UltraSSD_LRS verwendet ultra disk. Premium_ZRS verwendet redundanten Premium SSD-Zonenspeicher. StandardSSD_ZRS verwendet redundanten Standard-SSD-Zonenspeicher. Für weitere Informationen zu für Windows Virtual Machines unterstützten Festplatten siehe https://docs.microsoft.com/azure/virtual-machines/windows/disks-types und für Linux-Virtual Machines https://docs.microsoft.com/azure/virtual-machines/linux/disks-types
StorageFaultDomainAlignmentType	Spezifiziert den Typ der Speicherfehlerdomäne für die Festplatte.
StorageProfile	Gibt die Speichereinstellungen für die Datenträger des virtuellen Computers an.
SubResource
VirtualHardDisk	Beschreibt den URI eines Datenträgers.
VMDiskSecurityProfile	Gibt die Sicherheitsprofileinstellungen für den verwalteten Datenträger an. Hinweis: Es kann nur für vertrauliche VMs festgelegt werden.

ApiEntityReference

Objekt

Der API-Entitätsverweis.

Name	Typ	Beschreibung
id	string	Die ARM-Ressourcen-ID in Form von /subscriptions/{SubscriptionId}/resourceGroups/{ResourceGroupName}/...

ApiError

Objekt

API-Fehler.

Name	Typ	Beschreibung
code	string	Der Fehlercode.
details	ApiErrorBase[]	Die Details zum API-Fehler
innererror	InnerError	Der innere API-Fehler
message	string	Die Fehlermeldung.
target	string	Das Ziel des bestimmten Fehlers.

ApiErrorBase

Objekt

API-Fehlerbasis.

Name	Typ	Beschreibung
code	string	Der Fehlercode.
message	string	Die Fehlermeldung.
target	string	Das Ziel des bestimmten Fehlers.

AttachDetachDataDisksRequest

Objekt

Gibt die Eingabe zum Anfügen und Trennen einer Liste verwalteter Datenträger an.

Name	Typ	Beschreibung
dataDisksToAttach	DataDisksToAttach[]	Die Liste der verwalteten Datenträger, die angefügt werden sollen.
dataDisksToDetach	DataDisksToDetach[]	Die Liste der verwalteten Datenträger, die getrennt werden sollen.

CachingTypes

Enumeration

Gibt die Zwischenspeicherungsanforderungen an. Mögliche Werte sind: None,ReadOnly,ReadWrite. Die Standardwerte sind: Keine für Standardspeicher. ReadOnly für Premium-Speicher

Wert	Beschreibung
None
ReadOnly
ReadWrite

CloudError

Objekt

Eine Fehlerantwort vom Compute-Dienst.

Name	Typ	Beschreibung
error	ApiError	API-Fehler.

DataDisk

Objekt

Beschreibt einen Datenträger.

Name	Typ	Beschreibung
caching	CachingTypes	Gibt die Zwischenspeicherungsanforderungen an. Mögliche Werte sind: None,ReadOnly,ReadWrite. Das Standardverhalten lautet: Keine für Standardspeicher. ReadOnly für Premium-Speicher.
createOption	DiskCreateOptionTypes	Gibt an, wie der virtuelle Computerdatenträger erstellt werden soll. Mögliche Werte sind Attach: Dieser Wert wird verwendet, wenn Sie einen speziellen Datenträger zum Erstellen des virtuellen Computers verwenden. FromImage: Dieser Wert wird verwendet, wenn Sie ein Image zum Erstellen des Datenträgers für virtuelle Computer verwenden. Wenn Sie ein Plattformimage verwenden, sollten Sie auch das oben beschriebene imageReference-Element verwenden. Wenn Sie ein Marketplace-Image verwenden, sollten Sie auch das zuvor beschriebene Planelement verwenden. Leer: Dieser Wert wird beim Erstellen eines leeren Datenträgers verwendet. Kopieren: Dieser Wert wird verwendet, um einen Datenträger aus einer Momentaufnahme oder einem anderen Datenträger zu erstellen. Wiederherstellen: Dieser Wert wird verwendet, um einen Datenträger aus einem Datenträgerwiederherstellungspunkt zu erstellen.
deleteOption	DiskDeleteOptionTypes	Gibt an, ob der Datenträger beim Löschen eines virtuellen Computers gelöscht oder getrennt werden soll. Mögliche Werte sind: Löschen. Wenn dieser Wert verwendet wird, wird der Datenträger beim Löschen des virtuellen Computers gelöscht. Abtrennen. Wenn dieser Wert verwendet wird, wird der Datenträger beibehalten, nachdem der virtuelle Computer gelöscht wurde. Der Standardwert ist auf Trennenfestgelegt.
detachOption	DiskDetachOptionTypes	Gibt das Verhalten zum Trennen eines Datenträgers an, das beim Trennen eines Datenträgers verwendet werden soll oder das sich bereits im Prozess der Trennung vom virtuellen Computer befindet. Unterstützte Werte: ForceDetach. detachOption: ForceDetach gilt nur für verwaltete Datenträger. Wenn ein vorheriger Trennungsversuch des Datenträgers aufgrund eines unerwarteten Fehlers vom virtuellen Computer nicht abgeschlossen wurde und der Datenträger noch nicht freigegeben wird, verwenden Sie "Force-detach" als letzte Option zum Trennen des Datenträgers vom virtuellen Computer. Bei Verwendung dieses Trennverhaltens wurden möglicherweise nicht alle Schreibvorgänge geleert. Diese Funktion befindet sich noch in der Vorschauphase. Um das Trennen eines Datenträgerupdates auf "True" zu erzwingen, zusammen mit der Einstellung "tachOption: 'ForceDetach'"
diskIOPSReadWrite	integer (int64)	Gibt die Read-Write IOPS für den verwalteten Datenträger an, wenn StorageAccountType UltraSSD_LRS ist.
diskMBpsReadWrite	integer (int64)	Gibt die Bandbreite in MB pro Sekunde für den verwalteten Datenträger an, wenn StorageAccountType auf UltraSSD_LRS festgelegt ist.
diskSizeGB	integer (int32)	Gibt die Größe eines leeren Datenträgers in Gigabyte an. Dieses Element kann verwendet werden, um die Größe des Datenträgers in einem Image eines virtuellen Computers zu überschreiben. Die Eigenschaft "diskSizeGB" ist die Anzahl der Bytes x 1024^3 für den Datenträger, und der Wert darf nicht größer als 1023 sein.
image	VirtualHardDisk	Die virtuelle Festplatte des Quellbenutzerimages. Die virtuelle Festplatte wird kopiert, bevor sie an den virtuellen Computer angefügt wird. Wenn SourceImage bereitgestellt wird, darf die virtuelle Zielfestplatte nicht vorhanden sein.
lun	integer (int32)	Gibt die logische Einheitennummer des Datenträgers an. Dieser Wert wird verwendet, um Datenträger innerhalb des virtuellen Computers zu identifizieren und muss daher für jeden an eine VM angefügten Datenträger eindeutig sein.
managedDisk	ManagedDiskParameters	Die Parameter des verwalteten Datenträgers.
name	string	Der Datenträgername.
sourceResource	ApiEntityReference	Der Quellressourcenbezeichner. Dabei kann es sich um einen Momentaufnahme- oder Datenträgerwiederherstellungspunkt zum Erstellen eines Datenträgers sein.
storageFaultDomainAlignment	StorageFaultDomainAlignmentType	Spezifiziert den Typ der Speicherfehlerdomäne für die Festplatte.
toBeDetached	boolean	Gibt an, ob der Datenträger von virtualMachine/VirtualMachineScaleset getrennt wird.
vhd	VirtualHardDisk	Die virtuelle Festplatte.
writeAcceleratorEnabled	boolean	Gibt an, ob writeAccelerator auf dem Datenträger aktiviert oder deaktiviert werden soll.

DataDisksToAttach

Objekt

Beschreibt den anzufügenden Datenträger.

Name	Typ	Beschreibung
caching	CachingTypes	Gibt die Zwischenspeicherungsanforderungen an. Mögliche Werte sind: None,ReadOnly,ReadWrite. Das Standardverhalten lautet: Keine für Standardspeicher. ReadOnly für Premium-Speicher.
deleteOption	DiskDeleteOptionTypes	Gibt an, ob der Datenträger beim Löschen eines virtuellen Computers gelöscht oder getrennt werden soll. Mögliche Werte sind: Löschen. Wenn dieser Wert verwendet wird, wird der Datenträger beim Löschen des virtuellen Computers gelöscht. Abtrennen. Wenn dieser Wert verwendet wird, wird der Datenträger beibehalten, nachdem der virtuelle Computer gelöscht wurde. Der Standardwert ist auf Trennenfestgelegt.
diskEncryptionSet	DiskEncryptionSetParameters	Gibt die vom Kunden verwaltete Datenträgerverschlüsselungssatz-Ressourcen-ID für den verwalteten Datenträger an.
diskId	string	ID des verwalteten Datenträgers.
lun	integer (int32)	Die logische Einheitennummer des Datenträgers. Dieser Wert wird verwendet, um Datenträger innerhalb des virtuellen Computers zu identifizieren und muss daher für jeden an eine VM angefügten Datenträger eindeutig sein. Wenn nicht angegeben, wird lun automatisch zugewiesen.
writeAcceleratorEnabled	boolean	Gibt an, ob writeAccelerator auf dem Datenträger aktiviert oder deaktiviert werden soll.

DataDisksToDetach

Objekt

Beschreibt den zu lösenden Datenträger.

Name	Typ	Beschreibung
detachOption	DiskDetachOptionTypes	Unterstützte Optionen zum Trennen eines Datenträgers von einem virtuellen Computer. Weitere Informationen finden Sie in der DetachOption-Objektreferenz.
diskId	string	ID des verwalteten Datenträgers.

DiffDiskOptions

Enumeration

Gibt die kurzlebige Datenträgeroption für den Betriebssystemdatenträger an.

Wert	Beschreibung
Local

DiffDiskPlacement

Enumeration

Gibt die kurzlebige Datenträgerplatzierung für den Betriebssystemdatenträger an. Diese Eigenschaft kann vom Benutzer in der Anforderung verwendet werden, um den Speicherort auszuwählen, d. h. Cachedatenträger, Ressourcendatenträger oder NVME-Speicherplatz für die Bereitstellung von Ephemeral-Betriebssystemdatenträgern. Für weitere Informationen zu den Anforderungen an die Festplattengröße von Ephemeral OS siehe bitte die Anforderungen an die Festplattengröße eines Ephemeral OS für Windows VM unter https://docs.microsoft.com/azure/virtual-machines/windows/ephemeral-os-disks#size-requirements und Linux VM unter https://docs.microsoft.com/azure/virtual-machines/linux/ephemeral-os-disks#size-requirements. Mindest-API-Version für NvmeDisk: 2024-03-01.

Wert	Beschreibung
CacheDisk
ResourceDisk
NvmeDisk

DiffDiskSettings

Objekt

Beschreibt die Parameter der kurzlebigen Datenträgereinstellungen, die für den Betriebssystemdatenträger angegeben werden können. Hinweis: Die kurzlebigen Datenträgereinstellungen können nur für verwaltete Datenträger angegeben werden.

Name	Typ	Beschreibung
enableFullCaching	boolean	Legt fest, ob für diese VM vollständige Caching aktiviert werden soll, die die Betriebssystem-Festplatte lokal auf dem Host zwischenspeichert und diese VM widerstandsfähiger gegen Speicherausfälle macht
option	DiffDiskOptions	Gibt die kurzlebigen Datenträgereinstellungen für den Betriebssystemdatenträger an.
placement	DiffDiskPlacement	Gibt die kurzlebige Datenträgerplatzierung für den Betriebssystemdatenträger an. Mögliche Werte sind: CacheDisk,ResourceDisk,NvmeDisk. Das Standardverhalten lautet: CacheDisk, wenn eine für die VM-Größe konfiguriert ist, andernfalls ResourceDisk oder NvmeDisk- verwendet wird. In der Vm-Größendokumentation für Windows-VM unter https://docs.microsoft.com/azure/virtual-machines/windows/sizes und Linux-VM unter https://docs.microsoft.com/azure/virtual-machines/linux/sizes können Sie überprüfen, welche VM-Größen einen Cachedatenträger verfügbar machen. Mindest-API-Version für NvmeDisk: 2024-03-01.

DiskControllerTypes

Enumeration

Gibt den Datenträgercontrollertyp an, der für den virtuellen Computer und VirtualMachineScaleSet konfiguriert ist. Diese Eigenschaft wird nur für virtuelle Maschinen unterstützt, deren Betriebssystem-Festplatte und VM-SKU Generation 2 (https://docs.microsoft.com/en-us/azure/virtual-machines/generation-2 unterstützen; bitte prüfen Sie die HyperVGenerations-Fähigkeit, die als Teil der VM-SKU-Fähigkeiten in der Antwort von Microsoft zurückgegeben wird. Die API der Compute SKUs für die Region enthält V2 (https://docs.microsoft.com/rest/api/compute/resourceskus/list). Weitere Informationen zu unterstützten Datenträgercontrollertypen finden Sie unter https://aka.ms/azure-diskcontrollertypes.

Wert	Beschreibung
SCSI
NVMe

DiskCreateOptionTypes

Enumeration

Gibt an, wie der virtuelle Computerdatenträger erstellt werden soll. Mögliche Werte sind Attach: Dieser Wert wird verwendet, wenn Sie einen speziellen Datenträger zum Erstellen des virtuellen Computers verwenden. FromImage: Dieser Wert wird verwendet, wenn Sie ein Image zum Erstellen des virtuellen Computers verwenden. Wenn Sie ein Plattformimage verwenden, sollten Sie auch das oben beschriebene imageReference-Element verwenden. Wenn Sie ein Marketplace-Image verwenden, sollten Sie auch das zuvor beschriebene Planelement verwenden. Leer: Dieser Wert wird beim Erstellen eines leeren Datenträgers verwendet. Kopieren: Dieser Wert wird verwendet, um einen Datenträger aus einer Momentaufnahme oder einem anderen Datenträger zu erstellen. Wiederherstellen: Dieser Wert wird verwendet, um einen Datenträger aus einem Datenträgerwiederherstellungspunkt zu erstellen.

Wert	Beschreibung
FromImage
Empty
Attach
Copy
Restore

DiskDeleteOptionTypes

Enumeration

Gibt das Verhalten des verwalteten Datenträgers an, wenn der virtuelle Computer gelöscht wird, z. B. ob der verwaltete Datenträger gelöscht oder getrennt wird. Unterstützte Werte sind: Löschen. Wenn dieser Wert verwendet wird, wird der verwaltete Datenträger gelöscht, wenn der virtuelle Computer gelöscht wird. Abtrennen. Wenn dieser Wert verwendet wird, wird der verwaltete Datenträger beibehalten, nachdem der virtuelle Computer gelöscht wurde. Mindest-API-Version: 2021-03-01.

Wert	Beschreibung
Delete
Detach

DiskDetachOptionTypes

Enumeration

Gibt das Verhalten zum Trennen eines Datenträgers an, das beim Trennen eines Datenträgers verwendet werden soll oder das sich bereits im Prozess der Trennung vom virtuellen Computer befindet. Unterstützte Werte sind: ForceDetach. detachOption: ForceDetach gilt nur für verwaltete Datenträger. Wenn ein vorheriger Trennungsversuch des Datenträgers aufgrund eines unerwarteten Fehlers vom virtuellen Computer nicht abgeschlossen wurde und der Datenträger noch nicht freigegeben wird, verwenden Sie "Force-detach" als letzte Option zum Trennen des Datenträgers vom virtuellen Computer. Bei Verwendung dieses Trennverhaltens wurden möglicherweise nicht alle Schreibvorgänge geleert. Diese Funktion befindet sich noch in der Vorschauphase. Um das Trennen eines Datenträgerupdates auf "True" zu erzwingen, zusammen mit der Einstellung "tachOption: 'ForceDetach'"

Wert	Beschreibung
ForceDetach

DiskEncryptionSetParameters

Objekt

Beschreibt den Parameter der vom Kunden verwalteten Datenträgerverschlüsselungssatz-Ressourcen-ID, die für den Datenträger angegeben werden kann. Hinweis: Die Ressourcen-ID des Datenträgerverschlüsselungssatzes kann nur für verwaltete Datenträger angegeben werden. Weitere Informationen finden Sie https://aka.ms/mdssewithcmkoverview.

Name	Typ	Beschreibung
id	string	Ressourcen-ID

DiskEncryptionSettings

Objekt

Beschreibt eine Verschlüsselungseinstellungen für einen Datenträger

Name	Typ	Beschreibung
diskEncryptionKey	KeyVaultSecretReference	Spezifiziert den Standort des Festplatten-Verschlüsselungsschlüssels, der ein Key Vault Secret ist.
enabled	boolean	Gibt an, ob die Datenträgerverschlüsselung auf dem virtuellen Computer aktiviert werden soll.
keyEncryptionKey	KeyVaultKeyReference	Spezifiziert den Standort des Schlüsselverschlüsselungsschlüssels in Key Vault.

ImageReference

Objekt

Gibt Informationen zum zu verwendenden Bild an. Sie können Informationen zu Plattformimages, Marketplace-Images oder virtuellen Computerimages angeben. Dieses Element ist erforderlich, wenn Sie ein Plattformimage, ein Marketplace-Image oder ein virtuelles Computerimage verwenden möchten, aber nicht in anderen Erstellungsvorgängen verwendet wird. HINWEIS: Der Herausgeber und das Angebot für Bildreferenzen können nur festgelegt werden, wenn Sie den Skalierungssatz erstellen.

Name	Typ	Beschreibung
communityGalleryImageId	string	Gibt die eindeutige ID des Communitykatalogimages für die Vm-Bereitstellung an. Dies kann aus dem Community gallery Image GET-Anruf abgerufen werden.
exactVersion	string	Gibt in Dezimalzahlen die Version des Plattformimages oder des Marketplace-Images an, das zum Erstellen des virtuellen Computers verwendet wird. Dieses Readonly-Feld unterscheidet sich von "version", nur wenn der im Feld "Version" angegebene Wert "latest" lautet.
id	string	Ressourcen-ID
offer	string	Gibt das Angebot des Plattformimages oder des Marketplace-Images an, das zum Erstellen des virtuellen Computers verwendet wird.
publisher	string	Der Image publisher.
sharedGalleryImageId	string	Gibt die eindeutige ID des freigegebenen Katalogimages für die Vm-Bereitstellung an. Dies kann aus dem GET-Aufruf des freigegebenen Katalogbilds abgerufen werden.
sku	string	Die Bild-SKU.
version	string	Gibt die Version des Plattformimages oder Marketplace-Images an, mit dem der virtuelle Computer erstellt wird. Die zulässigen Formate sind Major.Minor.Build oder "latest". Haupt-, Neben- und Buildwerte sind Dezimalzahlen. Geben Sie "neueste" an, um die neueste Version eines Images zu verwenden, das zur Bereitstellungszeit verfügbar ist. Auch wenn Sie "latest" verwenden, wird das VM-Image nach der Bereitstellung nicht automatisch aktualisiert, auch wenn eine neue Version verfügbar ist. Bitte verwenden Sie das Feld 'version' nicht für die Bereitstellung von Galeriebildern, das Galeriebild sollte für die Bereitstellung immer das Feld 'id' verwenden; um die 'neueste' Version des Galerie-Images zu verwenden, setzen Sie einfach '/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft. Compute/galleries/{galleryName}/images/{imageName}' im Feld 'id' ohne Versionseingabe.

InnerError

Objekt

Innere Fehlerdetails.

Name	Typ	Beschreibung
errordetail	string	Die interne Fehlermeldung oder der Ausnahmedump.
exceptiontype	string	Der Ausnahmetyp.

KeyVaultKeyReference

Objekt

Beschreibt einen Verweis auf Key Vault Key

Name	Typ	Beschreibung
keyUrl	string	Die URL, die auf einen Schlüsselverschlüsselungsschlüssel in Key Vault verweist.
sourceVault	SubResource	Die relative URL des Key Vault, der den Schlüssel enthält.

KeyVaultSecretReference

Objekt

Beschreibt einen Verweis auf Key Vault Secret

Name	Typ	Beschreibung
secretUrl	string	Die URL bezieht sich auf ein Geheimnis in einem Key Vault.
sourceVault	SubResource	Die relative URL des Key Vault, der das Geheimnis enthält.

ManagedDiskParameters

Objekt

Die Parameter eines verwalteten Datenträgers.

Name	Typ	Beschreibung
diskEncryptionSet	DiskEncryptionSetParameters	Gibt die vom Kunden verwaltete Datenträgerverschlüsselungssatz-Ressourcen-ID für den verwalteten Datenträger an.
id	string	Ressourcen-ID
securityProfile	VMDiskSecurityProfile	Gibt das Sicherheitsprofil für den verwalteten Datenträger an.
storageAccountType	StorageAccountTypes	Gibt den Speicherkontotyp für den verwalteten Datenträger an. HINWEIS: UltraSSD_LRS nur mit Datenträgern verwendet werden kann, kann sie nicht mit Betriebssystemdatenträgern verwendet werden.

OperatingSystemTypes

Enumeration

Mit dieser Eigenschaft können Sie den Typ des Betriebssystems angeben, das auf dem Datenträger enthalten ist, wenn sie einen virtuellen Computer aus einem benutzerdefinierten Image erstellen. Mögliche Werte sind: Windows,Linux.

Wert	Beschreibung
Windows
Linux

OSDisk

Objekt

Gibt Informationen zum Betriebssystemdatenträger an, der vom virtuellen Computer verwendet wird. Weitere Informationen zu Festplatten finden Sie unter Über Festplatten und VHDs für Azure virtuelle Maschinen.

Name	Typ	Beschreibung
caching	CachingTypes	Gibt die Zwischenspeicherungsanforderungen an. Mögliche Werte sind: None,ReadOnly,ReadWrite. Das Standardverhalten lautet: Keine für Standardspeicher. ReadOnly für Premium-Speicher.
createOption	DiskCreateOptionTypes	Gibt an, wie der virtuelle Computerdatenträger erstellt werden soll. Mögliche Werte sind Attach: Dieser Wert wird verwendet, wenn Sie einen speziellen Datenträger zum Erstellen des virtuellen Computers verwenden. FromImage: Dieser Wert wird verwendet, wenn Sie ein Image zum Erstellen des virtuellen Computers verwenden. Wenn Sie ein Plattformimage verwenden, sollten Sie auch das oben beschriebene imageReference-Element verwenden. Wenn Sie ein Marketplace-Image verwenden, sollten Sie auch das zuvor beschriebene Planelement verwenden.
deleteOption	DiskDeleteOptionTypes	Gibt an, ob der Betriebssystemdatenträger beim Löschen eines virtuellen Computers gelöscht oder getrennt werden soll. Mögliche Werte sind: Löschen. Wenn dieser Wert verwendet wird, wird der Betriebssystemdatenträger gelöscht, wenn der virtuelle Computer gelöscht wird. Abtrennen. Wenn dieser Wert verwendet wird, wird der Betriebssystemdatenträger nach dem Löschen des virtuellen Computers beibehalten. Der Standardwert ist auf Trennenfestgelegt. Bei einem kurzlebigen Betriebssystemdatenträger wird der Standardwert auf Deletefestgelegt. Der Benutzer kann die Löschoption für einen kurzlebigen Betriebssystemdatenträger nicht ändern.
diffDiskSettings	DiffDiskSettings	Gibt die kurzlebigen Datenträgereinstellungen für den Betriebssystemdatenträger an, der vom virtuellen Computer verwendet wird.
diskSizeGB	integer (int32)	Gibt die Größe eines leeren Datenträgers in Gigabyte an. Dieses Element kann verwendet werden, um die Größe des Datenträgers in einem Image eines virtuellen Computers zu überschreiben. Die Eigenschaft "diskSizeGB" ist die Anzahl der Bytes x 1024^3 für den Datenträger, und der Wert darf nicht größer als 1023 sein.
encryptionSettings	DiskEncryptionSettings	Gibt die Verschlüsselungseinstellungen für den Betriebssystemdatenträger an. Mindest-API-Version: 2015-06-15.
image	VirtualHardDisk	Die virtuelle Festplatte des Quellbenutzerimages. Die virtuelle Festplatte wird kopiert, bevor sie an den virtuellen Computer angefügt wird. Wenn SourceImage bereitgestellt wird, darf die virtuelle Zielfestplatte nicht vorhanden sein.
managedDisk	ManagedDiskParameters	Die Parameter des verwalteten Datenträgers.
name	string	Der Datenträgername.
osType	OperatingSystemTypes	Mit dieser Eigenschaft können Sie den Typ des Betriebssystems angeben, das auf dem Datenträger enthalten ist, wenn ein virtueller Computer über ein Benutzerimage oder eine spezielle VHD erstellt wird. Mögliche Werte sind: Windows,Linux.
storageFaultDomainAlignment	StorageFaultDomainAlignmentType	Spezifiziert den Typ der Speicherfehlerdomäne für die Festplatte.
vhd	VirtualHardDisk	Die virtuelle Festplatte.
writeAcceleratorEnabled	boolean	Gibt an, ob writeAccelerator auf dem Datenträger aktiviert oder deaktiviert werden soll.

SecurityEncryptionTypes

Enumeration

Gibt den EncryptionType des verwalteten Datenträgers an. Es ist für die Verschlüsselung des verwalteten Datenträgers auf DiskWithVMGuestStateState festgelegt, vmGuestStateOnly für die Verschlüsselung nur des VMGuestState-Blobs und NonPersistedTPM, um den Firmwarestatus im VMGuestState-Blob nicht beizubehalten. Hinweis: Sie kann nur für vertrauliche virtuelle Computer festgelegt werden.

Wert	Beschreibung
VMGuestStateOnly
DiskWithVMGuestState
NonPersistedTPM

StorageAccountTypes

Enumeration

Gibt den Speicherkontotyp für den verwalteten Datenträger an. Der Typ des Verwalteten Betriebssystemspeicherkontos kann nur festgelegt werden, wenn Sie den Skalierungssatz erstellen. HINWEIS: UltraSSD_LRS kann nur mit Datenträgern verwendet werden. Sie kann nicht mit Betriebssystemdatenträger verwendet werden. Standard_LRS verwendet Standard-HDD. StandardSSD_LRS verwendet Standard-SSD. Premium_LRS verwendet Premium-SSD. UltraSSD_LRS verwendet ultra disk. Premium_ZRS verwendet redundanten Premium SSD-Zonenspeicher. StandardSSD_ZRS verwendet redundanten Standard-SSD-Zonenspeicher. Für weitere Informationen zu für Windows Virtual Machines unterstützten Festplatten siehe https://docs.microsoft.com/azure/virtual-machines/windows/disks-types und für Linux-Virtual Machines https://docs.microsoft.com/azure/virtual-machines/linux/disks-types

Wert	Beschreibung
Standard_LRS
Premium_LRS
StandardSSD_LRS
UltraSSD_LRS
Premium_ZRS
StandardSSD_ZRS
PremiumV2_LRS

StorageFaultDomainAlignmentType

Enumeration

Spezifiziert den Typ der Speicherfehlerdomäne für die Festplatte.

Wert	Beschreibung
Aligned	Festplattenspeicher-Fehlerdomänen werden auf Compute-Fehlerdomänen abgebildet. Die Bereitstellung schlägt fehl, wenn die Festplatte nicht genügend Fehlerdomänen unterstützt.
BestEffortAligned	Versuchen Sie, Speicherfehlerdomänen auf Fehlerdomänen zu berechnen. Festplatten sind nicht ausgerichtet, wenn die Festplatte nicht genügend Fehlerdomänen unterstützt.

StorageProfile

Objekt

Gibt die Speichereinstellungen für die Datenträger des virtuellen Computers an.

Name	Typ	Beschreibung
alignRegionalDisksToVMZone	boolean	Gibt an, ob die regionalen Datenträger an die VM-Zone ausgerichtet/verschoben werden sollen. Dies gilt nur für VMs mit einem Platzierungseigenschaftssatz. Bitte beachten Sie, dass diese Änderung unumkehrbar ist. Mindest-API-Version: 2024-11-01.
dataDisks	DataDisk[]	Gibt die Parameter an, die zum Hinzufügen eines Datenträgers zu einem virtuellen Computer verwendet werden. Weitere Informationen zu Festplatten finden Sie unter Über Festplatten und VHDs für Azure virtuelle Maschinen.
diskControllerType	DiskControllerTypes	Gibt den Datenträgercontrollertyp an, der für den virtuellen Computer konfiguriert ist. Hinweis: Diese Eigenschaft wird auf den Standarddatenträgertyp festgelegt, wenn kein angegebener virtueller Computer mit "hyperVGeneration" auf V2 basierend auf den Funktionen des Betriebssystemdatenträgers und der VM-Größe aus der angegebenen Mindest-API-Version erstellt wird. Sie müssen die Zuordnung des virtuellen Computers vor dem Aktualisieren des Datenträgercontrollertyps durchführen, es sei denn, Sie aktualisieren die VM-Größe in der VM-Konfiguration, die implizit zuordnungen und die VM neu zugeordnet. Mindest-API-Version: 2022-08-01.
imageReference	ImageReference	Gibt Informationen zum zu verwendenden Bild an. Sie können Informationen zu Plattformimages, Marketplace-Images oder virtuellen Computerimages angeben. Dieses Element ist erforderlich, wenn Sie ein Plattformimage, ein Marketplace-Image oder ein virtuelles Computerimage verwenden möchten, aber nicht in anderen Erstellungsvorgängen verwendet wird.
osDisk	OSDisk	Gibt Informationen zum Betriebssystemdatenträger an, der vom virtuellen Computer verwendet wird. Weitere Informationen zu Festplatten finden Sie unter Über Festplatten und VHDs für Azure virtuelle Maschinen.

SubResource

Objekt

Name	Typ	Beschreibung
id	string	Ressourcen-ID

VirtualHardDisk

Objekt

Beschreibt den URI eines Datenträgers.

Name	Typ	Beschreibung
uri	string	Gibt den URI der virtuellen Festplatte an.

VMDiskSecurityProfile

Objekt

Gibt die Sicherheitsprofileinstellungen für den verwalteten Datenträger an. Hinweis: Es kann nur für vertrauliche VMs festgelegt werden.

Name	Typ	Beschreibung
diskEncryptionSet	DiskEncryptionSetParameters	Gibt die Vom Kunden verwaltete Datenträgerverschlüsselungssatz-Ressourcen-ID für den verwalteten Datenträger an, der für den vom Kunden verwalteten Schlüssel verschlüsselter VertraulichVM-Betriebssystemdatenträger und vmGuest-Blob verwendet wird.
securityEncryptionType	SecurityEncryptionTypes	Gibt den EncryptionType des verwalteten Datenträgers an. Es ist für die Verschlüsselung des verwalteten Datenträgers auf DiskWithVMGuestStateState festgelegt, vmGuestStateOnly für die Verschlüsselung nur des VMGuestState-Blobs und NonPersistedTPM, um den Firmwarestatus im VMGuestState-Blob nicht beizubehalten. Hinweis: Sie kann nur für vertrauliche virtuelle Computer festgelegt werden.