Disks - Get

Dienst:

Compute

API-Version:

2023-10-02

Ruft Informationen zu einem Datenträger ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/disks/{diskName}?api-version=2023-10-02

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
diskName	path	True	string	Der Name des verwalteten Datenträgers, der erstellt wird. Der Name kann nicht geändert werden, nachdem der Datenträger erstellt wurde. Unterstützte Zeichen für den Namen sind a-z, A-Z, 0-9, _ und -. Die maximale Namenslänge ist 80 Zeichen.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe.
subscriptionId	path	True	string	Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.
api-version	query	True	string	Client-API-Version.

Antworten

Name	Typ	Beschreibung
200 OK	Disk	OK

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

Get information about a managed disk.

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myManagedDisk?api-version=2023-10-02

Java

/**
 * Samples for Disks GetByResourceGroup.
 */
public final class Main {
    /*
     * x-ms-original-file:
     * specification/compute/resource-manager/Microsoft.Compute/DiskRP/stable/2023-10-02/examples/diskExamples/Disk_Get.
     * json
     */
    /**
     * Sample code: Get information about a managed disk.
     * 
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void getInformationAboutAManagedDisk(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.virtualMachines().manager().serviceClient().getDisks().getByResourceGroupWithResponse("myResourceGroup",
            "myManagedDisk", com.azure.core.util.Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Go

package armcompute_test

import (
	"context"
	"log"

	"github.com/Azure/azure-sdk-for-go/sdk/azidentity"
	"github.com/Azure/azure-sdk-for-go/sdk/resourcemanager/compute/armcompute/v6"
)

// Generated from example definition: https://github.com/Azure/azure-rest-api-specs/blob/81a4ee5a83ae38620c0e1404793caffe005d26e4/specification/compute/resource-manager/Microsoft.Compute/DiskRP/stable/2023-10-02/examples/diskExamples/Disk_Get.json
func ExampleDisksClient_Get() {
	cred, err := azidentity.NewDefaultAzureCredential(nil)
	if err != nil {
		log.Fatalf("failed to obtain a credential: %v", err)
	}
	ctx := context.Background()
	clientFactory, err := armcompute.NewClientFactory("<subscription-id>", cred, nil)
	if err != nil {
		log.Fatalf("failed to create client: %v", err)
	}
	res, err := clientFactory.NewDisksClient().Get(ctx, "myResourceGroup", "myManagedDisk", nil)
	if err != nil {
		log.Fatalf("failed to finish the request: %v", err)
	}
	// You could use response here. We use blank identifier for just demo purposes.
	_ = res
	// If the HTTP response code is 200 as defined in example definition, your response structure would look as follows. Please pay attention that all the values in the output are fake values for just demo purposes.
	// res.Disk = armcompute.Disk{
	// 	Name: to.Ptr("myManagedDisk"),
	// 	Type: to.Ptr("Microsoft.Compute/disks"),
	// 	ID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myManagedDisk"),
	// 	Location: to.Ptr("westus"),
	// 	Tags: map[string]*string{
	// 		"department": to.Ptr("Development"),
	// 		"project": to.Ptr("ManagedDisks"),
	// 	},
	// 	ManagedBy: to.Ptr("/subscriptions/123caaa-123v-v211-a49f-f88ccac5bf88/resourceGroups/ResourceGroupName/providers/Microsoft.Compute/virtualMachines/TestVM414689371c88843d65ec"),
	// 	Properties: &armcompute.DiskProperties{
	// 		LastOwnershipUpdateTime: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2016-12-28T04:41:35.079Z"); return t}()),
	// 		CreationData: &armcompute.CreationData{
	// 			CreateOption: to.Ptr(armcompute.DiskCreateOptionFromImage),
	// 			ImageReference: &armcompute.ImageDiskReference{
	// 				ID: to.Ptr("/Subscriptions/{subscription-id}/Providers/Microsoft.Compute/Locations/westus/Publishers/test_test_pmc2pc1/ArtifactTypes/VMImage/Offers/marketplace_vm_test/Skus/test_sku/Versions/1.0.0"),
	// 			},
	// 		},
	// 		DiskSizeGB: to.Ptr[int32](10),
	// 		Encryption: &armcompute.Encryption{
	// 			Type: to.Ptr(armcompute.EncryptionTypeEncryptionAtRestWithPlatformKey),
	// 		},
	// 		EncryptionSettingsCollection: &armcompute.EncryptionSettingsCollection{
	// 			Enabled: to.Ptr(true),
	// 			EncryptionSettings: []*armcompute.EncryptionSettingsElement{
	// 				{
	// 					DiskEncryptionKey: &armcompute.KeyVaultAndSecretReference{
	// 						SecretURL: to.Ptr("https://myvmvault.vault-int.azure-int.net/secrets/{secret}"),
	// 						SourceVault: &armcompute.SourceVault{
	// 							ID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myVMVault"),
	// 						},
	// 					},
	// 					KeyEncryptionKey: &armcompute.KeyVaultAndKeyReference{
	// 						KeyURL: to.Ptr("https://myvmvault.vault-int.azure-int.net/keys/{key}"),
	// 						SourceVault: &armcompute.SourceVault{
	// 							ID: to.Ptr("/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myVMVault"),
	// 						},
	// 					},
	// 			}},
	// 		},
	// 		HyperVGeneration: to.Ptr(armcompute.HyperVGenerationV1),
	// 		OSType: to.Ptr(armcompute.OperatingSystemTypesWindows),
	// 		ProvisioningState: to.Ptr("Succeeded"),
	// 		PurchasePlan: &armcompute.DiskPurchasePlan{
	// 			Name: to.Ptr("test_sku"),
	// 			Product: to.Ptr("marketplace_vm_test"),
	// 			Publisher: to.Ptr("test_test_pmc2pc1"),
	// 		},
	// 		SecurityProfile: &armcompute.DiskSecurityProfile{
	// 			SecurityType: to.Ptr(armcompute.DiskSecurityTypesTrustedLaunch),
	// 		},
	// 		SupportedCapabilities: &armcompute.SupportedCapabilities{
	// 			AcceleratedNetwork: to.Ptr(true),
	// 		},
	// 		SupportsHibernation: to.Ptr(true),
	// 		TimeCreated: to.Ptr(func() time.Time { t, _ := time.Parse(time.RFC3339Nano, "2016-12-28T04:41:35.079Z"); return t}()),
	// 	},
	// 	SKU: &armcompute.DiskSKU{
	// 		Name: to.Ptr(armcompute.DiskStorageAccountTypesStandardLRS),
	// 	},
	// }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

JavaScript

const { ComputeManagementClient } = require("@azure/arm-compute");
const { DefaultAzureCredential } = require("@azure/identity");

/**
 * This sample demonstrates how to Gets information about a disk.
 *
 * @summary Gets information about a disk.
 * x-ms-original-file: specification/compute/resource-manager/Microsoft.Compute/DiskRP/stable/2023-10-02/examples/diskExamples/Disk_Get.json
 */
async function getInformationAboutAManagedDisk() {
  const subscriptionId = process.env["COMPUTE_SUBSCRIPTION_ID"] || "{subscription-id}";
  const resourceGroupName = process.env["COMPUTE_RESOURCE_GROUP"] || "myResourceGroup";
  const diskName = "myManagedDisk";
  const credential = new DefaultAzureCredential();
  const client = new ComputeManagementClient(credential, subscriptionId);
  const result = await client.disks.get(resourceGroupName, diskName);
  console.log(result);
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

dotnet

using Azure;
using Azure.ResourceManager;
using System;
using System.Threading.Tasks;
using Azure.Core;
using Azure.Identity;
using Azure.ResourceManager.Compute.Models;
using Azure.ResourceManager.Resources;
using Azure.ResourceManager.Compute;

// Generated from example definition: specification/compute/resource-manager/Microsoft.Compute/DiskRP/stable/2023-10-02/examples/diskExamples/Disk_Get.json
// this example is just showing the usage of "Disks_Get" operation, for the dependent resources, they will have to be created separately.

// get your azure access token, for more details of how Azure SDK get your access token, please refer to https://learn.microsoft.com/en-us/dotnet/azure/sdk/authentication?tabs=command-line
TokenCredential cred = new DefaultAzureCredential();
// authenticate your client
ArmClient client = new ArmClient(cred);

// this example assumes you already have this ManagedDiskResource created on azure
// for more information of creating ManagedDiskResource, please refer to the document of ManagedDiskResource
string subscriptionId = "{subscription-id}";
string resourceGroupName = "myResourceGroup";
string diskName = "myManagedDisk";
ResourceIdentifier managedDiskResourceId = ManagedDiskResource.CreateResourceIdentifier(subscriptionId, resourceGroupName, diskName);
ManagedDiskResource managedDisk = client.GetManagedDiskResource(managedDiskResourceId);

// invoke the operation
ManagedDiskResource result = await managedDisk.GetAsync();

// the variable result is a resource, you could call other operations on this instance as well
// but just for demo, we get its data from this resource instance
ManagedDiskData resourceData = result.Data;
// for demo we just print out the id
Console.WriteLine($"Succeeded on id: {resourceData.Id}");

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Beispiel für eine Antwort

Statuscode:

200

{
  "managedBy": "/subscriptions/123caaa-123v-v211-a49f-f88ccac5bf88/resourceGroups/ResourceGroupName/providers/Microsoft.Compute/virtualMachines/TestVM414689371c88843d65ec",
  "sku": {
    "name": "Standard_LRS"
  },
  "properties": {
    "osType": "Windows",
    "hyperVGeneration": "V1",
    "purchasePlan": {
      "name": "test_sku",
      "publisher": "test_test_pmc2pc1",
      "product": "marketplace_vm_test"
    },
    "supportedCapabilities": {
      "acceleratedNetwork": true
    },
    "supportsHibernation": true,
    "securityProfile": {
      "securityType": "TrustedLaunch"
    },
    "creationData": {
      "createOption": "FromImage",
      "imageReference": {
        "id": "/Subscriptions/{subscription-id}/Providers/Microsoft.Compute/Locations/westus/Publishers/test_test_pmc2pc1/ArtifactTypes/VMImage/Offers/marketplace_vm_test/Skus/test_sku/Versions/1.0.0"
      }
    },
    "diskSizeGB": 10,
    "encryptionSettingsCollection": {
      "enabled": true,
      "encryptionSettings": [
        {
          "diskEncryptionKey": {
            "sourceVault": {
              "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myVMVault"
            },
            "secretUrl": "https://myvmvault.vault-int.azure-int.net/secrets/{secret}"
          },
          "keyEncryptionKey": {
            "sourceVault": {
              "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.KeyVault/vaults/myVMVault"
            },
            "keyUrl": "https://myvmvault.vault-int.azure-int.net/keys/{key}"
          }
        }
      ]
    },
    "encryption": {
      "type": "EncryptionAtRestWithPlatformKey"
    },
    "LastOwnershipUpdateTime": "2016-12-28T04:41:35.079872+00:00",
    "timeCreated": "2016-12-28T04:41:35.079872+00:00",
    "provisioningState": "Succeeded"
  },
  "type": "Microsoft.Compute/disks",
  "location": "westus",
  "tags": {
    "department": "Development",
    "project": "ManagedDisks"
  },
  "id": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myManagedDisk",
  "name": "myManagedDisk"
}

Definitionen

Name	Beschreibung
Architecture	CPU-Architektur, die von einem Betriebssystemdatenträger unterstützt wird.
CreationData	Daten, die beim Erstellen eines Datenträgers verwendet werden.
DataAccessAuthMode	Zusätzliche Authentifizierungsanforderungen beim Exportieren oder Hochladen auf einen Datenträger oder Momentaufnahme.
Disk	Datenträgerressource.
DiskCreateOption	Dadurch werden die möglichen Quellen für die Erstellung eines Datenträgers aufgelistet.
DiskSecurityProfile	Enthält die sicherheitsbezogenen Informationen für die Ressource.
DiskSecurityTypes	Gibt den SecurityType des virtuellen Computers an. Gilt nur für Betriebssystemdatenträger.
DiskSku	Der SKU-Name der Datenträger. Kann Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS oder PremiumV2_LRS sein.
DiskState	Dadurch wird der mögliche Zustand des Datenträgers aufgelistet.
DiskStorageAccountTypes	Der SKU-Name.
Encryption	Verschlüsselung ruhender Einstellungen für Datenträger oder Momentaufnahme
EncryptionSettingsCollection	Verschlüsselungseinstellungen für Datenträger oder Momentaufnahme
EncryptionSettingsElement	Verschlüsselungseinstellungen für ein Datenträgervolume.
EncryptionType	Der Typ des Schlüssels, der zum Verschlüsseln der Daten des Datenträgers verwendet wird.
ExtendedLocation	Der komplexe Typ des erweiterten Standorts.
ExtendedLocationTypes	Der Typ des erweiterten Speicherorts.
HyperVGeneration	Die Hypervisorgeneration des virtuellen Computers. Gilt nur für Betriebssystemdatenträger.
ImageDiskReference	Das Quellimage, das zum Erstellen des Datenträgers verwendet wird.
KeyVaultAndKeyReference	Key Vault Schlüssel-URL und Tresor-ID von KeK ist KeK optional, und wenn angegeben, wird zum Entpacken des encryptionKey verwendet.
KeyVaultAndSecretReference	Key Vault Geheime URL und Tresor-ID des Verschlüsselungsschlüssels
NetworkAccessPolicy	Richtlinie für den Zugriff auf den Datenträger über das Netzwerk.
OperatingSystemTypes	Der Betriebssystemtyp.
PropertyUpdatesInProgress	Eigenschaften des Datenträgers, für den das Update aussteht.
ProvisionedBandwidthCopyOption	Wenn dieses Feld für eine Momentaufnahme festgelegt ist und createOption auf CopyStart festgelegt ist, wird die Momentaufnahme schneller kopiert.
PublicNetworkAccess	Richtlinie zum Steuern des Exports auf dem Datenträger.
PurchasePlan	Wird zum Einrichten des Kaufkontexts eines beliebigen Artefakts von 3rd Party über MarketPlace verwendet.
ShareInfoElement
SourceVault	Die Tresor-ID ist eine Azure Resource Manager-Ressourcen-ID im Format /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}
SupportedCapabilities	Liste der unterstützten Funktionen, die für die VM-Verwendung auf der Datenträgerressource beibehalten wurden.

Architecture

CPU-Architektur, die von einem Betriebssystemdatenträger unterstützt wird.

Name	Typ	Beschreibung
Arm64	string
x64	string

CreationData

Daten, die beim Erstellen eines Datenträgers verwendet werden.

Name	Typ	Beschreibung
createOption	DiskCreateOption	Dadurch werden die möglichen Quellen für die Erstellung eines Datenträgers aufgelistet.
elasticSanResourceId	string	Erforderlich, wenn createOption copyFromSanSnapshot ist. Dies ist die ARM-ID des Momentaufnahme des Quellvolumes für elastische Volumes.
galleryImageReference	ImageDiskReference	Erforderlich, wenn Sie aus einem Katalogimage erstellen. Die id/sharedGalleryImageId/communityGalleryImageId des ImageDiskReference ist die ARM-ID der version des freigegebenen Galleyimages, von der aus ein Datenträger erstellt werden soll.
imageReference	ImageDiskReference	Datenträgerquelleninformationen für PIR- oder Benutzerimages.
logicalSectorSize	integer	Logische Sektorgröße in Bytes für Ultra-Datenträger. Unterstützte Werte: 512 und 4.096. 4.096 ist der Standardwert.
performancePlus	boolean	Legen Sie dieses Flag auf true fest, um eine Steigerung des Leistungsziels des bereitgestellten Datenträgers zu erhalten. Weitere Informationen finden Sie hier zum jeweiligen Leistungsziel. Dieses Flag kann nur zum Zeitpunkt der Datenträgererstellung festgelegt werden und kann nach der Aktivierung nicht mehr deaktiviert werden.
provisionedBandwidthCopySpeed	ProvisionedBandwidthCopyOption	Wenn dieses Feld für eine Momentaufnahme festgelegt ist und createOption auf CopyStart festgelegt ist, wird die Momentaufnahme schneller kopiert.
securityDataUri	string	Wenn createOption ImportSecure ist, ist dies der URI eines Blobs, das in den VM-Gaststatus importiert werden soll.
sourceResourceId	string	Wenn createOption kopieren ist, ist dies die ARM-ID des Quell-Momentaufnahme oder Datenträgers.
sourceUniqueId	string	Wenn dieses Feld festgelegt ist, ist dies die eindeutige ID, die die Quelle dieser Ressource identifiziert.
sourceUri	string	Wenn createOption import ist, ist dies der URI eines Blobs, das in einen verwalteten Datenträger importiert werden soll.
storageAccountId	string	Erforderlich, wenn createOption Import ist. Der Azure Resource Manager Bezeichner des Speicherkontos, das das Blob enthält, das als Datenträger importiert werden soll.
uploadSizeBytes	integer	Wenn createOption Upload ist, ist dies die Größe des Inhalts des Uploads einschließlich der VHD-Fußzeile. Dieser Wert sollte zwischen 20972032 (20 MiB + 512 Bytes für die VHD-Fußzeile) und 35183298347520 Bytes (32 TiB + 512 Bytes für die VHD-Fußzeile) sein.

DataAccessAuthMode

Zusätzliche Authentifizierungsanforderungen beim Exportieren oder Hochladen auf einen Datenträger oder Momentaufnahme.

Name	Typ	Beschreibung
AzureActiveDirectory	string	Bei Verwendung der Export-/Upload-URL überprüft das System, ob der Benutzer über eine Identität in Azure Active Directory und über die erforderlichen Berechtigungen zum Exportieren/Hochladen der Daten verfügt. Weitere Informationen finden Sie unter „aka.ms/DisksAzureADAuth“.
None	string	Beim Zugriff auf die Export-/Upload-URL wird keine zusätzliche Authentifizierung durchgeführt.

Disk

Datenträgerressource.

Name	Typ	Beschreibung
extendedLocation	ExtendedLocation	Der erweiterte Speicherort, an dem der Datenträger erstellt wird. Der erweiterte Speicherort kann nicht geändert werden.
id	string	Ressourcen-ID
location	string	Ressourcenspeicherort
managedBy	string	Ein relativer URI, der die ID des virtuellen Computers enthält, auf dem der Datenträger angefügt ist.
managedByExtended	string[]	Liste der relativen URIs, die die IDs der VMs enthalten, auf denen der Datenträger angefügt ist. maxShares sollte für Datenträger auf einen Wert größer als 1 festgelegt werden, damit sie an mehrere VMs angefügt werden können.
name	string	Ressourcenname
properties.LastOwnershipUpdateTime	string	Die UTC-Zeit, zu der der Besitzstatus des Datenträgers zuletzt geändert wurde, d. h. der Zeitpunkt, zu dem der Datenträger zuletzt angefügt oder von einer VM getrennt wurde, oder der Zeitpunkt, zu dem die VM, an die der Datenträger angefügt wurde, zugeordnet oder gestartet wurde.
properties.burstingEnabled	boolean	Legen Sie true fest, um bursting über das bereitgestellte Leistungsziel des Datenträgers hinaus zu ermöglichen. Bursting ist standardmäßig deaktiviert. Gilt nicht für Ultra-Datenträger.
properties.burstingEnabledTime	string	Der letzte Zeitpunkt, zu dem Bursting zuletzt auf einem Datenträger aktiviert wurde.
properties.completionPercent	number	Prozentsatz abgeschlossen für die Hintergrundkopie, wenn eine Ressource über den CopyStart-Vorgang erstellt wird.
properties.creationData	CreationData	Informationen zur Datenträgerquelle. CreationData-Informationen können nicht geändert werden, nachdem der Datenträger erstellt wurde.
properties.dataAccessAuthMode	DataAccessAuthMode	Zusätzliche Authentifizierungsanforderungen beim Exportieren oder Hochladen auf einen Datenträger oder Momentaufnahme.
properties.diskAccessId	string	ARM-ID der DiskAccess-Ressource für die Verwendung privater Endpunkte auf Datenträgern.
properties.diskIOPSReadOnly	integer	Die Gesamtzahl der IOPS, die für alle VMs zulässig sind, die den freigegebenen Datenträger als ReadOnly einbinden. Ein Vorgang kann zwischen 4.000 und 256.000 Bytes übertragen.
properties.diskIOPSReadWrite	integer	Die Anzahl der für diesen Datenträger zulässigen IOPS; nur für UltraSSD-Datenträger einstellbar. Ein Vorgang kann zwischen 4.000 und 256.000 Bytes übertragen.
properties.diskMBpsReadOnly	integer	Der Gesamtdurchsatz (MBps), der für alle VMs zulässig ist, die den freigegebenen Datenträger als ReadOnly einbinden. MBps bedeutet Millionen von Bytes pro Sekunde – MB verwendet hier die ISO-Notation von 10.
properties.diskMBpsReadWrite	integer	Die für diesen Datenträger zulässige Bandbreite; nur für UltraSSD-Datenträger einstellbar. MBps bedeutet Millionen von Bytes pro Sekunde – MB verwendet hier die ISO-Notation von 10.
properties.diskSizeBytes	integer	Die Größe des Datenträgers in Bytes. Dieses Feld ist schreibgeschützt.
properties.diskSizeGB	integer	Wenn creationData.createOption leer ist, ist dieses Feld obligatorisch und gibt die Größe des zu erstellenden Datenträgers an. Wenn dieses Feld für Updates oder die Erstellung mit anderen Optionen vorhanden ist, gibt es eine Größenänderung an. Größenänderungen sind nur zulässig, wenn der Datenträger nicht an eine ausgeführte VM angefügt ist, und können die Größe des Datenträgers nur erhöhen.
properties.diskState	DiskState	Der Zustand des Datenträgers.
properties.encryption	Encryption	Die Verschlüsselungseigenschaft kann verwendet werden, um ruhende Daten mit kundenseitig verwalteten Schlüsseln oder plattformseitig verwalteten Schlüsseln zu verschlüsseln.
properties.encryptionSettingsCollection	EncryptionSettingsCollection	Die Sammlung von Verschlüsselungseinstellungen, die für Azure Disk Encryption verwendet wird, kann mehrere Verschlüsselungseinstellungen pro Datenträger oder Momentaufnahme enthalten.
properties.hyperVGeneration	HyperVGeneration	Die Hypervisorgeneration des virtuellen Computers. Gilt nur für Betriebssystemdatenträger.
properties.maxShares	integer	Die maximale Anzahl von VMs, die gleichzeitig an den Datenträger angefügt werden können. Der Wert größer als eins gibt einen Datenträger an, der gleichzeitig auf mehreren VMs bereitgestellt werden kann.
properties.networkAccessPolicy	NetworkAccessPolicy	Richtlinie für den Zugriff auf den Datenträger über das Netzwerk.
properties.optimizedForFrequentAttach	boolean	Durch Festlegen dieser Eigenschaft auf true wird die Zuverlässigkeit und Leistung von Datenträgern verbessert, die häufig (mehr als 5 Mal pro Tag) von einem virtuellen Computer getrennt und an einen anderen angefügt werden. Diese Eigenschaft sollte nicht für Datenträger festgelegt werden, die nicht getrennt und häufig angefügt werden, da sie dazu führt, dass die Datenträger nicht an der Fehlerdomäne des virtuellen Computers ausgerichtet sind.
properties.osType	OperatingSystemTypes	Der Betriebssystemtyp.
properties.propertyUpdatesInProgress	PropertyUpdatesInProgress	Eigenschaften des Datenträgers, für den das Update aussteht.
properties.provisioningState	string	Der Datenträgerbereitstellungsstatus.
properties.publicNetworkAccess	PublicNetworkAccess	Richtlinie zum Steuern des Exports auf dem Datenträger.
properties.purchasePlan	PurchasePlan	Kaufplaninformationen für das Image, aus dem der Betriebssystemdatenträger erstellt wurde. Z.B. - {name: 2019-Datacenter, Herausgeber: MicrosoftWindowsServer, Produkt: WindowsServer}
properties.securityProfile	DiskSecurityProfile	Enthält die sicherheitsbezogenen Informationen für die Ressource.
properties.shareInfo	ShareInfoElement[]	Details zur Liste aller VMs, auf denen der Datenträger angefügt ist. maxShares sollte für Datenträger auf einen Wert größer als 1 festgelegt werden, damit sie an mehrere VMs angefügt werden können.
properties.supportedCapabilities	SupportedCapabilities	Liste der unterstützten Funktionen für das Image, aus dem der Betriebssystemdatenträger erstellt wurde.
properties.supportsHibernation	boolean	Gibt an, dass das Betriebssystem auf einem Datenträger den Ruhezustand unterstützt.
properties.tier	string	Leistungsebene des Datenträgers (z. B. P4, S10) wie hier beschrieben: https://azure.microsoft.com/en-us/pricing/details/managed-disks/. Gilt nicht für Ultra-Datenträger.
properties.timeCreated	string	Der Zeitpunkt, zu dem der Datenträger erstellt wurde.
properties.uniqueId	string	Eindeutige GUId, die die Ressource identifiziert.
sku	DiskSku	Der SKU-Name der Datenträger. Kann Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS oder PremiumV2_LRS sein.
tags	object	Ressourcentags
type	string	Ressourcentyp
zones	string[]	Die Liste der logischen Zonen für Datenträger.

DiskCreateOption

Dadurch werden die möglichen Quellen für die Erstellung eines Datenträgers aufgelistet.

Name	Typ	Beschreibung
Attach	string	Der Datenträger wird an einen virtuellen Computer angefügt.
Copy	string	Erstellen Sie einen neuen Datenträger oder Momentaufnahme, indem Sie von einem Datenträger oder Momentaufnahme kopieren, der von der angegebenen sourceResourceId angegeben wird.
CopyFromSanSnapshot	string	Erstellen Sie einen neuen Datenträger, indem Sie aus elastic san volume Momentaufnahme
CopyStart	string	Erstellen Sie einen neuen Datenträger mithilfe eines tiefgehenden Kopierprozesses, bei dem die Ressourcenerstellung erst als abgeschlossen gilt, nachdem alle Daten aus der Quelle kopiert wurden.
Empty	string	Erstellen Sie einen leeren Datenträger mit einer von diskSizeGB angegebenen Größe.
FromImage	string	Erstellen Sie einen neuen Datenträger aus einem Plattformimage, das durch das angegebene imageReference oder galleryImageReference angegeben wird.
Import	string	Erstellen Sie einen Datenträger, indem Sie aus einem Blob importieren, das von einem sourceUri in einem durch storageAccountId angegebenen Speicherkonto angegeben wird.
ImportSecure	string	Ähnlich wie die Option "Create importieren". Erstellen Sie einen neuen vm-vertrauenswürdigen Startcomputer oder einen vertraulichen VM-unterstützten Datenträger, indem Sie zusätzliches Blob für den vm-Gaststatus importieren, der durch securityDataUri im Speicherkonto angegeben wird, das durch storageAccountId angegeben wird.
Restore	string	Erstellen Sie einen neuen Datenträger, indem Sie aus einem Sicherungswiederherstellungspunkt kopieren.
Upload	string	Erstellen Sie einen neuen Datenträger, indem Sie ein Schreibtoken abrufen und verwenden, um den Inhalt des Datenträgers direkt hochzuladen.
UploadPreparedSecure	string	Ähnlich wie bei der Option "Create hochladen". Erstellen einer neuen vm-vertrauenswürdigen oder vertraulichen VM, die unterstützt wird, und Hochladen mithilfe des Schreibtokens im Datenträger- und VM-Gastzustand

DiskSecurityProfile

Enthält die sicherheitsbezogenen Informationen für die Ressource.

Name	Typ	Beschreibung
secureVMDiskEncryptionSetId	string	ResourceId der Datenträgerverschlüsselungsgruppe, die mit einem vom Kunden verwalteten Schlüssel verschlüsselten vertraulichen VM-Datenträgern zugeordnet ist
securityType	DiskSecurityTypes	Gibt den SecurityType des virtuellen Computers an. Gilt nur für Betriebssystemdatenträger.

DiskSecurityTypes

Gibt den SecurityType des virtuellen Computers an. Gilt nur für Betriebssystemdatenträger.

Name	Typ	Beschreibung
ConfidentialVM_DiskEncryptedWithCustomerKey	string	Gibt einen vertraulichen VM-Datenträger mit Betriebssystemdatenträger und VM-Gaststatus an, der mit einem vom Kunden verwalteten Schlüssel verschlüsselt ist.
ConfidentialVM_DiskEncryptedWithPlatformKey	string	Gibt einen vertraulichen VM-Datenträger mit Betriebssystemdatenträger und VM-Gaststatus an, der mit einem plattformseitig verwalteten Schlüssel verschlüsselt ist.
ConfidentialVM_NonPersistedTPM	string	Gibt einen vertraulichen VM-Datenträger mit einem kurzlebigen vTPM an. Der vTPM-Zustand wird nicht über VM-Neustarts hinweg beibehalten.
ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey	string	Gibt einen vertraulichen VM-Datenträger mit nur verschlüsseltem VM-Gaststatus an.
TrustedLaunch	string	Der vertrauenswürdige Start bietet Sicherheitsfeatures wie den sicheren Start und das virtuelle Trusted Platform Module (vTPM).

DiskSku

Der SKU-Name der Datenträger. Kann Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS oder PremiumV2_LRS sein.

Name	Typ	Beschreibung
name	DiskStorageAccountTypes	Der sku-Name.
tier	string	Die sku-Ebene.

DiskState

Dadurch wird der mögliche Zustand des Datenträgers aufgelistet.

Name	Typ	Beschreibung
ActiveSAS	string	Dem Datenträger ist derzeit ein Aktiver SAS-URI zugeordnet.
ActiveSASFrozen	string	Der Datenträger wird an eine VM im Ruhezustand angefügt und verfügt über einen aktiven SAS-URI.
ActiveUpload	string	Ein Datenträger wird für den Upload erstellt, und es wurde ein Schreibtoken für den Upload darauf ausgestellt.
Attached	string	Der Datenträger ist derzeit an eine ausgeführte VM angefügt.
Frozen	string	Der Datenträger wird an einen virtuellen Computer angefügt, der sich im Ruhezustand befindet.
ReadyToUpload	string	Ein Datenträger kann durch Hochladen erstellt werden, indem ein Schreibtoken angefordert wird.
Reserved	string	Der Datenträger wird an einen virtuellen Computer angefügt, der die Zuordnung aufgehoben hat.
Unattached	string	Der Datenträger wird nicht verwendet und kann an einen virtuellen Computer angefügt werden.

DiskStorageAccountTypes

Der SKU-Name.

Name	Typ	Beschreibung
PremiumV2_LRS	string	Lokal redundanter Speicher für SSD Premium v2. Am besten geeignet für Produktionsworkloads und leistungsabhängige Workloads, die konsistent geringe Latenz sowie hohe IOPS und Durchsatz erfordern.
Premium_LRS	string	Lokal redundanter SSD Premium-Speicher. Am besten für Produktions- und leistungsabhängige Workloads geeignet.
Premium_ZRS	string	Zonenredundanter SSD Premium-Speicher. Am besten geeignet für Produktionsworkloads, die Speicherresilienz bei Zonenausfällen benötigen.
StandardSSD_LRS	string	Lokal redundanter SSD Standard-Speicher. Am besten für Webserver, wenig genutzte Unternehmensanwendungen und Enticklung/Testen geeignet.
StandardSSD_ZRS	string	Zonenredundanter Ssd-Standardspeicher. Am besten geeignet für Webserver, leicht verwendete Unternehmensanwendungen und Dev/Test, die Speicherresilienz bei Zonenausfällen benötigen.
Standard_LRS	string	Lokal redundanter HDD Standard-Speicher. Am besten für Sicherungen, nicht kritischen und seltenen Zugriff geeignet.
UltraSSD_LRS	string	Lokal redundanter Ssd-Speicher ultra. Am besten geeignet für E/A-intensive Workloads wie SAP HANA, Datenbanken der obersten Ebene (z. B. SQL, Oracle) und andere transaktionsintensive Workloads.

Encryption

Verschlüsselung ruhender Einstellungen für Datenträger oder Momentaufnahme

Name	Typ	Beschreibung
diskEncryptionSetId	string	ResourceId des Datenträgerverschlüsselungssatzes, der zum Aktivieren der Verschlüsselung ruhender Daten verwendet werden soll.
type	EncryptionType	Der Typ des Schlüssels, der zum Verschlüsseln der Daten des Datenträgers verwendet wird.

EncryptionSettingsCollection

Verschlüsselungseinstellungen für Datenträger oder Momentaufnahme

Name	Typ	Beschreibung
enabled	boolean	Legen Sie dieses Flag auf true fest, und geben Sie DiskEncryptionKey und optional KeyEncryptionKey an, um die Verschlüsselung zu aktivieren. Legen Sie dieses Flag auf false fest, und entfernen Sie DiskEncryptionKey und KeyEncryptionKey, um die Verschlüsselung zu deaktivieren. Wenn EncryptionSettings im Anforderungsobjekt NULL ist, bleiben die vorhandenen Einstellungen unverändert.
encryptionSettings	EncryptionSettingsElement[]	Eine Sammlung von Verschlüsselungseinstellungen, eine für jedes Datenträgervolume.
encryptionSettingsVersion	string	Beschreibt, welche Art der Verschlüsselung für die Datenträger verwendet wird. Nachdem dieses Feld festgelegt wurde, kann es nicht mehr überschrieben werden. "1.0" entspricht Azure Disk Encryption mit der AAD-App.'1.1' entspricht Azure Disk Encryption.

EncryptionSettingsElement

Verschlüsselungseinstellungen für ein Datenträgervolume.

Name	Typ	Beschreibung
diskEncryptionKey	KeyVaultAndSecretReference	Key Vault Geheime URL und Tresor-ID des Datenträgerverschlüsselungsschlüssels
keyEncryptionKey	KeyVaultAndKeyReference	Key Vault Schlüssel-URL und Tresor-ID des Schlüsselverschlüsselungsschlüssels. KeyEncryptionKey ist optional, und wenn angegeben, wird zum Entpacken des Datenträgerverschlüsselungsschlüssels verwendet.

EncryptionType

Der Typ des Schlüssels, der zum Verschlüsseln der Daten des Datenträgers verwendet wird.

Name	Typ	Beschreibung
EncryptionAtRestWithCustomerKey	string	Der Datenträger wird im Ruhezustand mit einem vom Kunden verwalteten Schlüssel verschlüsselt, der von einem Kunden geändert und widerrufen werden kann.
EncryptionAtRestWithPlatformAndCustomerKeys	string	Der Datenträger wird im Ruhezustand mit zwei Verschlüsselungsebenen verschlüsselt. Einer der Schlüssel ist vom Kunden verwaltet, und der andere Schlüssel ist plattformseitig verwaltet.
EncryptionAtRestWithPlatformKey	string	Der Datenträger wird im Ruhezustand mit dem von der Plattform verwalteten Schlüssel verschlüsselt. Dies ist der Standardverschlüsselungstyp. Dies ist kein gültiger Verschlüsselungstyp für Datenträgerverschlüsselungsgruppen.

ExtendedLocation

Der komplexe Typ des erweiterten Standorts.

Name	Typ	Beschreibung
name	string	Der Name des erweiterten Speicherorts.
type	ExtendedLocationTypes	Der Typ des erweiterten Speicherorts.

ExtendedLocationTypes

Der Typ des erweiterten Speicherorts.

Name	Typ	Beschreibung
EdgeZone	string

HyperVGeneration

Die Hypervisorgeneration des virtuellen Computers. Gilt nur für Betriebssystemdatenträger.

Name	Typ	Beschreibung
V1	string
V2	string

ImageDiskReference

Das Quellimage, das zum Erstellen des Datenträgers verwendet wird.

Name	Typ	Beschreibung
communityGalleryImageId	string	Ein relativer URI, der einen Azure Compute Gallery-Imageverweis der Community enthält.
id	string	Ein relativer URI, der entweder ein Plattformimagerepository, ein Benutzerimage oder eine Azure Compute Gallery-Imagereferenz enthält.
lun	integer	Wenn der Datenträger aus dem Datenträger eines Images erstellt wird, ist dies ein Index, der angibt, welcher der Datenträger im Image verwendet werden soll. Für Betriebssystemdatenträger ist dieses Feld NULL.
sharedGalleryImageId	string	Ein relativer URI, der einen direkten freigegebenen Azure Compute Gallery-Imageverweis enthält.

KeyVaultAndKeyReference

Key Vault Schlüssel-URL und Tresor-ID von KeK ist KeK optional, und wenn angegeben, wird zum Entpacken des encryptionKey verwendet.

Name	Typ	Beschreibung
keyUrl	string	URL, die auf einen Schlüssel oder Geheimen in KeyVault verweist
sourceVault	SourceVault	Ressourcen-ID des KeyVault mit dem Schlüssel oder Geheimnis

KeyVaultAndSecretReference

Key Vault Geheime URL und Tresor-ID des Verschlüsselungsschlüssels

Name	Typ	Beschreibung
secretUrl	string	URL, die auf einen Schlüssel oder Geheimen in KeyVault verweist
sourceVault	SourceVault	Ressourcen-ID des KeyVault mit dem Schlüssel oder Geheimnis

NetworkAccessPolicy

Richtlinie für den Zugriff auf den Datenträger über das Netzwerk.

Name	Typ	Beschreibung
AllowAll	string	Der Datenträger kann aus einem beliebigen Netzwerk exportiert oder hochgeladen werden.
AllowPrivate	string	Der Datenträger kann mithilfe der privaten Endpunkte einer DiskAccess-Ressource exportiert oder in hochgeladen werden.
DenyAll	string	Der Datenträger kann nicht exportiert werden.

OperatingSystemTypes

Der Betriebssystemtyp.

Name	Typ	Beschreibung
Linux	string
Windows	string

PropertyUpdatesInProgress

Eigenschaften des Datenträgers, für den das Update aussteht.

Name	Typ	Beschreibung
targetTier	string	Die Zielleistungsebene des Datenträgers, wenn ein Tarifänderungsvorgang ausgeführt wird.

ProvisionedBandwidthCopyOption

Wenn dieses Feld für eine Momentaufnahme festgelegt ist und createOption auf CopyStart festgelegt ist, wird die Momentaufnahme schneller kopiert.

Name	Typ	Beschreibung
Enhanced	string
None	string

PublicNetworkAccess

Richtlinie zum Steuern des Exports auf dem Datenträger.

Name	Typ	Beschreibung
Disabled	string	Sie können nicht öffentlich im Internet auf die zugrunde liegenden Daten des Datenträgers zugreifen, selbst wenn NetworkAccessPolicy auf AllowAll festgelegt ist. Sie können über den SAS-URI nur über Ihr vertrauenswürdiges Azure-VNET auf die Daten zugreifen, wenn NetworkAccessPolicy auf AllowPrivate festgelegt ist.
Enabled	string	Sie können einen SAS-URI generieren, um öffentlich im Internet auf die zugrunde liegenden Daten des Datenträgers zuzugreifen, wenn NetworkAccessPolicy auf AllowAll festgelegt ist. Sie können über den SAS-URI nur über Ihr vertrauenswürdiges Azure-VNET auf die Daten zugreifen, wenn NetworkAccessPolicy auf AllowPrivate festgelegt ist.

PurchasePlan

Wird zum Einrichten des Kaufkontexts eines beliebigen Artefakts von 3rd Party über MarketPlace verwendet.

Name	Typ	Beschreibung
name	string	Die Plan-ID.
product	string	Gibt das Produkt des Images aus dem Marketplace an. Dies ist der gleiche Wert wie Offer unter dem imageReference-Element.
promotionCode	string	Der Angebotsaufstufungscode.
publisher	string	Die Herausgeber-ID.

ShareInfoElement

Name	Typ	Beschreibung
vmUri	string	Ein relativer URI, der die ID des virtuellen Computers enthält, an den der Datenträger angefügt ist.

SourceVault

Die Tresor-ID ist eine Azure Resource Manager-Ressourcen-ID im Format /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}

Name	Typ	Beschreibung
id	string	Ressourcen-ID

SupportedCapabilities

Liste der unterstützten Funktionen, die für die VM-Verwendung auf der Datenträgerressource beibehalten wurden.

Name	Typ	Beschreibung
acceleratedNetwork	boolean	True, wenn das Image, aus dem der Betriebssystemdatenträger erstellt wird, beschleunigtes Netzwerk unterstützt.
architecture	Architecture	CPU-Architektur, die von einem Betriebssystemdatenträger unterstützt wird.
diskControllerTypes	string	Die Datenträgercontroller, die ein Betriebssystemdatenträger unterstützt. Wenn festgelegt, kann es SCSI oder SCSI, NVME oder NVME, SCSI sein.