Disks - Get

Referentie

Service:: Compute

API-versie:: 2023-10-02

Hiermee haalt u informatie over een schijf op.

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

URI-parameters

Name	In	Vereist	Type	Description
diskName	path	True	string	De naam van de beheerde schijf die wordt gemaakt. De naam kan niet worden gewijzigd nadat de schijf is gemaakt. Ondersteunde tekens voor de naam zijn a-z, A-Z, 0-9, _ en -. De maximale naamlengte is 80 tekens.
resourceGroupName	path	True	string	De naam van de resourcegroep.
subscriptionId	path	True	string	Abonnementsreferenties die het Microsoft Azure-abonnement uniek identificeren. De abonnements-id maakt deel uit van de URI voor elke serviceoproep.
api-version	query	True	string	Client-API-versie.

Antwoorden

Name	Type	Description
200 OK	Disk	OK

Beveiliging

azure_auth

Azure Active Directory OAuth2-stroom

Type: oauth2
Stroom: implicit
Autorisatie-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiken

Name	Description
user_impersonation	Uw gebruikersaccount imiteren

Voorbeelden

Get information about a managed disk.

Voorbeeldaanvraag

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


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

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

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

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

Voorbeeldrespons

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

Definities

Name	Description
Architecture	CPU-architectuur die wordt ondersteund door een besturingssysteemschijf.
CreationData	Gegevens die worden gebruikt bij het maken van een schijf.
DataAccessAuthMode	Aanvullende verificatievereisten bij het exporteren of uploaden naar een schijf of momentopname.
Disk	Schijfresource.
DiskCreateOption	Hiermee worden de mogelijke bronnen van het maken van een schijf opgesomd.
DiskSecurityProfile	Bevat de beveiligingsgerelateerde informatie voor de resource.
DiskSecurityTypes	Hiermee geeft u het SecurityType van de VIRTUELE machine. Alleen van toepassing op besturingssysteemschijven.
DiskSku	De SKU-naam van de schijven. Kan Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS of PremiumV2_LRS zijn.
DiskState	Hiermee wordt de mogelijke status van de schijf opgesomd.
DiskStorageAccountTypes	De SKU-naam.
Encryption	Versleuteling-at-rest-instellingen voor schijf of momentopname
EncryptionSettingsCollection	Versleutelingsinstellingen voor schijf of momentopname
EncryptionSettingsElement	Versleutelingsinstellingen voor één schijfvolume.
EncryptionType	Het type sleutel dat wordt gebruikt om de gegevens van de schijf te versleutelen.
ExtendedLocation	Het complexe type van de uitgebreide locatie.
ExtendedLocationTypes	Het type van de uitgebreide locatie.
HyperVGeneration	De hypervisorgeneratie van de virtuele machine. Alleen van toepassing op besturingssysteemschijven.
ImageDiskReference	De broninstallatiekopieën die worden gebruikt voor het maken van de schijf.
KeyVaultAndKeyReference	Key Vault-sleutel-URL en kluis-id van KeK, KeK is optioneel en wanneer opgegeven wordt gebruikt om de encryptionKey uit te pakken
KeyVaultAndSecretReference	Key Vault Geheime URL en kluis-id van de versleutelingssleutel
NetworkAccessPolicy	Beleid voor toegang tot de schijf via het netwerk.
OperatingSystemTypes	Het type besturingssysteem.
PropertyUpdatesInProgress	Eigenschappen van de schijf waarvoor de update in behandeling is.
ProvisionedBandwidthCopyOption	Als dit veld is ingesteld op een momentopname en createOption CopyStart is, wordt de momentopname met een snellere snelheid gekopieerd.
PublicNetworkAccess	Beleid voor het beheren van export op de schijf.
PurchasePlan	Wordt gebruikt voor het tot stand brengen van de aankoopcontext van elk artefact van derden via MarketPlace.
ShareInfoElement
SourceVault	De kluis-id is een Azure Resource Manager-resource-id in het formulier /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}
SupportedCapabilities	Lijst met ondersteunde mogelijkheden die behouden blijven op de schijfresource voor vm-gebruik.

Architecture

Inventarisatie

CPU-architectuur die wordt ondersteund door een besturingssysteemschijf.

Waarde	Description
Arm64
x64

CreationData

Object

Gegevens die worden gebruikt bij het maken van een schijf.

Name	Type	Description
createOption	DiskCreateOption	Hiermee worden de mogelijke bronnen van het maken van een schijf opgesomd.
elasticSanResourceId	string	Vereist als createOption CopyFromSanSnapshot is. Dit is de ARM-id van de momentopname van het elastische san-volume van de bron.
galleryImageReference	ImageDiskReference	Vereist als u een galerie-installatiekopieën maakt. De id/sharedGalleryImageId/communityGalleryImageId van de ImageDiskReference is de ARM-id van de versie van de gedeelde kombuisinstallatiekopie waaruit een schijf moet worden gemaakt.
imageReference	ImageDiskReference	Schijfbroninformatie voor PIR- of gebruikersinstallatiekopieën.
logicalSectorSize	integer (int32)	Grootte van logische sector in bytes voor Ultra-schijven. Ondersteunde waarden zijn 512 ad 4096. 4096 is de standaardwaarde.
performancePlus	boolean	Stel deze vlag in op True om een boost te krijgen op het prestatiedoel van de schijf die is geïmplementeerd, zie hier over het respectieve prestatiedoel. Deze vlag kan alleen worden ingesteld op de aanmaaktijd van de schijf en kan niet worden uitgeschakeld nadat deze is ingeschakeld.
provisionedBandwidthCopySpeed	ProvisionedBandwidthCopyOption	Als dit veld is ingesteld op een momentopname en createOption CopyStart is, wordt de momentopname met een snellere snelheid gekopieerd.
securityDataUri	string	Als createOption ImportSecure is, is dit de URI van een blob die moet worden geïmporteerd in de gaststatus van de VM.
sourceResourceId	string	Als createOption Copy is, is dit de ARM-id van de bronmomentopname of schijf.
sourceUniqueId	string	Als dit veld is ingesteld, is dit de unieke id waarmee de bron van deze resource wordt geïdentificeerd.
sourceUri	string	Als createOption import is, is dit de URI van een blob die moet worden geïmporteerd in een beheerde schijf.
storageAccountId	string	Vereist als createOption import is. De Azure Resource Manager-id van het opslagaccount met de blob die moet worden geïmporteerd als een schijf.
uploadSizeBytes	integer (int64)	Als createOption Upload is, is dit de grootte van de inhoud van de upload, inclusief de VHD-voettekst. Deze waarde moet tussen 20972032 (20 MiB + 512 bytes voor de VHD-voettekst) en 35183298347520 bytes (32 TiB + 512 bytes voor de VHD-voettekst).

DataAccessAuthMode

Inventarisatie

Aanvullende verificatievereisten bij het exporteren of uploaden naar een schijf of momentopname.

Waarde	Description
AzureActiveDirectory	Wanneer de URL voor exporteren/uploaden wordt gebruikt, controleert het systeem of de gebruiker een identiteit heeft in Azure Active Directory en de benodigde machtigingen heeft om de gegevens te exporteren/uploaden. Raadpleeg aka.ms/DisksAzureADAuth.
None	Er wordt geen extra verificatie uitgevoerd bij het openen van de EXPORT-/upload-URL.

Disk

Object

Schijfresource.

Name	Type	Description
extendedLocation	ExtendedLocation	De uitgebreide locatie waar de schijf wordt gemaakt. De uitgebreide locatie kan niet worden gewijzigd.
id	string	Resource-id
location	string	Resourcelocatie
managedBy	string	Een relatieve URI met de id van de virtuele machine waaraan de schijf is gekoppeld.
managedByExtended	string[]	Lijst met relatieve URI's met de id's van de VM's waaraan de schijf is gekoppeld. maxShares moeten worden ingesteld op een waarde die groter is dan één voor schijven, zodat deze kunnen worden gekoppeld aan meerdere VM's.
name	string	Resourcenaam
properties.LastOwnershipUpdateTime	string (date-time)	De UTC-tijd waarop de eigendomsstatus van de schijf voor het laatst is gewijzigd, bijvoorbeeld het tijdstip waarop de schijf voor het laatst is gekoppeld of losgekoppeld van een VIRTUELE machine of het tijdstip waarop de virtuele machine waarop de schijf is gekoppeld, is opgeheven of gestart.
properties.burstingEnabled	boolean	Stel in op True om bursting mogelijk te maken buiten het ingerichte prestatiedoel van de schijf. Bursting is standaard uitgeschakeld. Is niet van toepassing op Ultra-schijven.
properties.burstingEnabledTime	string (date-time)	De laatste tijd waarop bursting voor het laatst is ingeschakeld op een schijf.
properties.completionPercent	number	Percentage voltooid voor de achtergrondkopie wanneer een resource wordt gemaakt via de kopieerbewerking.
properties.creationData	CreationData	Informatie over de schijfbron. CreationData-gegevens kunnen niet worden gewijzigd nadat de schijf is gemaakt.
properties.dataAccessAuthMode	DataAccessAuthMode	Aanvullende verificatievereisten bij het exporteren of uploaden naar een schijf of momentopname.
properties.diskAccessId	string	ARM-id van de DiskAccess-resource voor het gebruik van privé-eindpunten op schijven.
properties.diskIOPSReadOnly	integer (int64)	Het totale aantal IOPS dat wordt toegestaan voor alle VM's die de gedeelde schijf koppelen als ReadOnly. Eén bewerking kan worden overgedragen tussen 4k en 256k bytes.
properties.diskIOPSReadWrite	integer (int64)	Het aantal IOPS dat is toegestaan voor deze schijf; alleen instelbaar voor UltraSSD-schijven. Eén bewerking kan worden overgedragen tussen 4k en 256k bytes.
properties.diskMBpsReadOnly	integer (int64)	De totale doorvoer (MBps) die wordt toegestaan voor alle VM's die de gedeelde schijf koppelen als ReadOnly. MBps betekent miljoenen bytes per seconde- MB maakt hier gebruik van de ISO-notatie, van bevoegdheden van 10.
properties.diskMBpsReadWrite	integer (int64)	De bandbreedte die voor deze schijf is toegestaan; alleen instelbaar voor UltraSSD-schijven. MBps betekent miljoenen bytes per seconde- MB maakt hier gebruik van de ISO-notatie, van bevoegdheden van 10.
properties.diskSizeBytes	integer (int64)	De grootte van de schijf in bytes. Dit veld heeft het kenmerk Alleen-lezen.
properties.diskSizeGB	integer (int32)	Als creationData.createOption leeg is, is dit veld verplicht en wordt de grootte van de schijf aangegeven die moet worden gemaakt. Als dit veld aanwezig is voor updates of het maken met andere opties, wordt het formaat aangegeven. Grootten zijn alleen toegestaan als de schijf niet is gekoppeld aan een actieve VM en alleen de grootte van de schijf kan vergroten.
properties.diskState	DiskState	De status van de schijf.
properties.encryption	Encryption	Versleutelingseigenschap kan worden gebruikt voor het versleutelen van data-at-rest met door de klant beheerde sleutels of door het platform beheerde sleutels.
properties.encryptionSettingsCollection	EncryptionSettingsCollection	Verzameling versleutelingsinstellingen die worden gebruikt voor Azure Disk Encryption, kan meerdere versleutelingsinstellingen per schijf of momentopname bevatten.
properties.hyperVGeneration	HyperVGeneration	De hypervisorgeneratie van de virtuele machine. Alleen van toepassing op besturingssysteemschijven.
properties.maxShares	integer (int32)	Het maximum aantal virtuele machines dat tegelijkertijd aan de schijf kan worden gekoppeld. De waarde groter dan één geeft een schijf aan die tegelijkertijd op meerdere VM's kan worden gekoppeld.
properties.networkAccessPolicy	NetworkAccessPolicy	Beleid voor toegang tot de schijf via het netwerk.
properties.optimizedForFrequentAttach	boolean	Als u deze eigenschap instelt op waar, verbetert u de betrouwbaarheid en prestaties van gegevensschijven die vaak (meer dan 5 keer per dag) worden uitgevoerd door los te koppelen van de ene virtuele machine en gekoppeld aan een andere. Deze eigenschap mag niet worden ingesteld voor schijven die niet vaak zijn losgekoppeld en gekoppeld, omdat de schijven niet overeenkomen met het foutdomein van de virtuele machine.
properties.osType	OperatingSystemTypes	Het type besturingssysteem.
properties.propertyUpdatesInProgress	PropertyUpdatesInProgress	Eigenschappen van de schijf waarvoor de update in behandeling is.
properties.provisioningState	string	De inrichtingsstatus van de schijf.
properties.publicNetworkAccess	PublicNetworkAccess	Beleid voor het beheren van export op de schijf.
properties.purchasePlan	PurchasePlan	Aankoopplangegevens voor de installatiekopieën van waaruit de besturingssysteemschijf is gemaakt. Bijvoorbeeld - {name: 2019-Datacenter, uitgever: MicrosoftWindowsServer, product: WindowsServer}
properties.securityProfile	DiskSecurityProfile	Bevat de beveiligingsgerelateerde informatie voor de resource.
properties.shareInfo	ShareInfoElement[]	Details van de lijst met alle VM's waaraan de schijf is gekoppeld. maxShares moeten worden ingesteld op een waarde die groter is dan één voor schijven, zodat deze kunnen worden gekoppeld aan meerdere VM's.
properties.supportedCapabilities	SupportedCapabilities	Lijst met ondersteunde mogelijkheden voor de installatiekopieën waaruit de besturingssysteemschijf is gemaakt.
properties.supportsHibernation	boolean	Geeft aan dat het besturingssysteem op een schijf de sluimerstand ondersteunt.
properties.tier	string	Prestatielaag van de schijf (bijvoorbeeld P4, S10) zoals hier wordt beschreven: https://azure.microsoft.com/en-us/pricing/details/managed-disks/. Is niet van toepassing op Ultra-schijven.
properties.timeCreated	string (date-time)	Het tijdstip waarop de schijf is gemaakt.
properties.uniqueId	string	Unieke GUID die de resource identificeert.
sku	DiskSku	De SKU-naam van de schijven. Kan Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS of PremiumV2_LRS zijn.
tags	object	Resourcetags
type	string	Type hulpbron
zones	string[]	De lijst met logische zones voor Schijf.

DiskCreateOption

Inventarisatie

Hiermee worden de mogelijke bronnen van het maken van een schijf opgesomd.

Waarde	Description
Attach	De schijf wordt gekoppeld aan een virtuele machine.
Copy	Maak een nieuwe schijf of momentopname door te kopiëren van een schijf of momentopname die is opgegeven door de opgegeven sourceResourceId.
CopyFromSanSnapshot	Een nieuwe schijf maken door een momentopname van elastisch san-volume te exporteren
CopyStart	Maak een nieuwe schijf met behulp van een diep kopieerproces, waarbij het maken van de resource pas als voltooid wordt beschouwd nadat alle gegevens uit de bron zijn gekopieerd.
Empty	Maak een lege gegevensschijf van een grootte die is opgegeven door diskSizeGB.
FromImage	Maak een nieuwe schijf op basis van een platforminstallatiekopie die is opgegeven door de opgegeven imageReference of galleryImageReference.
Import	Maak een schijf door een blob te importeren die is opgegeven door een sourceUri in een opslagaccount dat is opgegeven door storageAccountId.
ImportSecure	Vergelijkbaar met de optie Maken importeren. Maak een nieuwe schijf met vertrouwde start-VM of vertrouwelijke VM door extra blob te importeren voor de vm-gaststatus die is opgegeven door securityDataUri in het opslagaccount dat is opgegeven door storageAccountId
Restore	Maak een nieuwe schijf door een back-upherstelpunt te kopiëren.
Upload	Maak een nieuwe schijf door een schrijftoken te verkrijgen en deze te gebruiken om de inhoud van de schijf rechtstreeks te uploaden.
UploadPreparedSecure	Vergelijkbaar met de optie Voor het maken van uploaden. Een nieuwe schijf met vertrouwde start-VM of vertrouwelijke VM maken en uploaden met schrijftoken in zowel schijf- als VM-gaststatus

DiskSecurityProfile

Object

Bevat de beveiligingsgerelateerde informatie voor de resource.

Name	Type	Description
secureVMDiskEncryptionSetId	string	ResourceId van de schijfversleutelingsset die is gekoppeld aan de schijf die is versleuteld met een door de klant beheerde sleutel
securityType	DiskSecurityTypes	Hiermee geeft u het SecurityType van de VIRTUELE machine. Alleen van toepassing op besturingssysteemschijven.

DiskSecurityTypes

Inventarisatie

Hiermee geeft u het SecurityType van de VIRTUELE machine. Alleen van toepassing op besturingssysteemschijven.

Waarde	Description
ConfidentialVM_DiskEncryptedWithCustomerKey	Geeft de vertrouwelijke VM-schijf aan met de gaststatus van het besturingssysteem en de gaststatus van de VM die is versleuteld met een door de klant beheerde sleutel
ConfidentialVM_DiskEncryptedWithPlatformKey	Geeft een vertrouwelijke VM-schijf aan met de gaststatus van het besturingssysteem en de gaststatus van de VM die is versleuteld met een door het platform beheerde sleutel
ConfidentialVM_NonPersistedTPM	Geeft een vertrouwelijke VM-schijf aan met een tijdelijke vTPM. De vTPM-status blijft niet behouden tijdens het opnieuw opstarten van de virtuele machine.
ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey	Geeft een vertrouwelijke VM-schijf aan met alleen de status van de VM-gast versleuteld
TrustedLaunch	Trusted Launch biedt beveiligingsfuncties zoals beveiligd opstarten en virtuele Trusted Platform Module (vTPM)

DiskSku

Object

De SKU-naam van de schijven. Kan Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS of PremiumV2_LRS zijn.

Name	Type	Description
name	DiskStorageAccountTypes	De SKU-naam.
tier	string	De sKU-laag.

DiskState

Inventarisatie

Hiermee wordt de mogelijke status van de schijf opgesomd.

Waarde	Description
ActiveSAS	Er is momenteel een actieve SAS-URI aan de schijf gekoppeld.
ActiveSASFrozen	De schijf is gekoppeld aan een virtuele machine in de slaapstand en heeft een actieve SAS-URI die eraan is gekoppeld.
ActiveUpload	Er wordt een schijf gemaakt voor uploaden en er is een schrijftoken uitgegeven om ernaar te uploaden.
Attached	De schijf is momenteel gekoppeld aan een actieve VM.
Frozen	De schijf is gekoppeld aan een virtuele machine die in de slaapstand staat.
ReadyToUpload	Een schijf kan worden gemaakt door te uploaden door een schrijftoken aan te vragen.
Reserved	De schijf is gekoppeld aan een gestopte, niet-toegewezen VM.
Unattached	De schijf wordt niet gebruikt en kan worden gekoppeld aan een virtuele machine.

DiskStorageAccountTypes

Inventarisatie

De SKU-naam.

Waarde	Description
PremiumV2_LRS	Premium SSD v2 lokaal redundante opslag. Het meest geschikt voor productie- en prestatiegevoelige workloads die consistent lage latentie en hoge IOPS en doorvoer vereisen.
Premium_LRS	Premium SSD lokaal redundante opslag. Geschikt voor productie- en prestatiegevoelige workloads.
Premium_ZRS	Premium SSD zone redundante opslag. Het beste voor de productieworkloads die opslagtolerantie nodig hebben tegen zonefouten.
StandardSSD_LRS	Standard SSD lokaal redundante opslag. Het meest geschikt voor webservers, licht gebruikte bedrijfstoepassingen en dev/test.
StandardSSD_ZRS	Standaard- SSD-zone-redundante opslag. Het meest geschikt voor webservers, licht gebruikte bedrijfstoepassingen en dev/test die opslagtolerantie nodig hebben tegen zonefouten.
Standard_LRS	Standard HDD lokaal redundante opslag. Het meest geschikt voor back-up, niet-kritieke en onregelmatige toegang.
UltraSSD_LRS	Ultra SSD lokaal redundante opslag. Het meest geschikt voor IO-intensieve workloads, zoals SAP HANA, databases in de hoogste laag (bijvoorbeeld SQL, Oracle) en andere werkbelastingen met veel transacties.

Encryption

Object

Versleuteling-at-rest-instellingen voor schijf of momentopname

Name	Type	Description
diskEncryptionSetId	string	ResourceId van de schijfversleutelingsset die moet worden gebruikt voor het inschakelen van versleuteling at rest.
type	EncryptionType	Het type sleutel dat wordt gebruikt om de gegevens van de schijf te versleutelen.

EncryptionSettingsCollection

Object

Versleutelingsinstellingen voor schijf of momentopname

Name	Type	Description
enabled	boolean	Stel deze vlag in op true en geef DiskEncryptionKey en optionele KeyEncryptionKey op om versleuteling in te schakelen. Stel deze vlag in op false en verwijder DiskEncryptionKey en KeyEncryptionKey om versleuteling uit te schakelen. Als EncryptionSettings null is in het aanvraagobject, blijven de bestaande instellingen ongewijzigd.
encryptionSettings	EncryptionSettingsElement[]	Een verzameling versleutelingsinstellingen, één voor elk schijfvolume.
encryptionSettingsVersion	string	Beschrijft welk type versleuteling wordt gebruikt voor de schijven. Zodra dit veld is ingesteld, kan het niet worden overschreven. '1.0' komt overeen met Azure Disk Encryption met de AAD-app.'1.1' komt overeen met Azure Disk Encryption.

EncryptionSettingsElement

Object

Versleutelingsinstellingen voor één schijfvolume.

Name	Type	Description
diskEncryptionKey	KeyVaultAndSecretReference	Key Vault Geheime URL en kluis-id van de schijfversleutelingssleutel
keyEncryptionKey	KeyVaultAndKeyReference	Key Vault-sleutel-URL en kluis-id van de sleutelversleutelingssleutel. KeyEncryptionKey is optioneel en wanneer deze wordt opgegeven, wordt gebruikt om de schijfversleutelingssleutel uit te pakken.

EncryptionType

Inventarisatie

Het type sleutel dat wordt gebruikt om de gegevens van de schijf te versleutelen.

Waarde	Description
EncryptionAtRestWithCustomerKey	De schijf wordt in rust versleuteld met de door de klant beheerde sleutel die kan worden gewijzigd en ingetrokken door een klant.
EncryptionAtRestWithPlatformAndCustomerKeys	Schijf wordt in rust versleuteld met 2 lagen versleuteling. Een van de sleutels wordt door de klant beheerd en de andere sleutel wordt beheerd door platform.
EncryptionAtRestWithPlatformKey	Schijf wordt at-rest versleuteld met door platform beheerde sleutel. Dit is het standaardversleutelingstype. Dit is geen geldig versleutelingstype voor schijfversleutelingssets.

ExtendedLocation

Object

Het complexe type van de uitgebreide locatie.

Name	Type	Description
name	string	De naam van de uitgebreide locatie.
type	ExtendedLocationTypes	Het type van de uitgebreide locatie.

ExtendedLocationTypes

Inventarisatie

Het type van de uitgebreide locatie.

Waarde	Description
EdgeZone

HyperVGeneration

Inventarisatie

De hypervisorgeneratie van de virtuele machine. Alleen van toepassing op besturingssysteemschijven.

Waarde	Description
V1
V2

ImageDiskReference

Object

De broninstallatiekopieën die worden gebruikt voor het maken van de schijf.

Name	Type	Description
communityGalleryImageId	string	Een relatieve URI met een azure Compute Gallery-installatiekopiereferentie voor de community.
id	string	Een relatieve URI met een opslagplaats voor platforminstallatiekopieën, een gebruikersinstallatiekopie of een azure Compute Gallery-installatiekopie.
lun	integer (int32)	Als de schijf wordt gemaakt op basis van de gegevensschijf van een installatiekopieën, is dit een index die aangeeft welke van de gegevensschijven in de installatiekopieën moeten worden gebruikt. Voor besturingssysteemschijven is dit veld null.
sharedGalleryImageId	string	Een relatieve URI met een direct gedeelde Azure Compute Gallery-installatiekopiereferentie.

KeyVaultAndKeyReference

Object

Key Vault-sleutel-URL en kluis-id van KeK, KeK is optioneel en wanneer opgegeven wordt gebruikt om de encryptionKey uit te pakken

Name	Type	Description
keyUrl	string	URL die verwijst naar een sleutel of geheim in KeyVault
sourceVault	SourceVault	Resource-id van de KeyVault die de sleutel of het geheim bevat

KeyVaultAndSecretReference

Object

Key Vault Geheime URL en kluis-id van de versleutelingssleutel

Name	Type	Description
secretUrl	string	URL die verwijst naar een sleutel of geheim in KeyVault
sourceVault	SourceVault	Resource-id van de KeyVault die de sleutel of het geheim bevat

NetworkAccessPolicy

Inventarisatie

Beleid voor toegang tot de schijf via het netwerk.

Waarde	Description
AllowAll	De schijf kan vanuit elk netwerk worden geëxporteerd of geüpload naar.
AllowPrivate	De schijf kan worden geëxporteerd of geüpload naar het gebruik van de privé-eindpunten van een DiskAccess-resource.
DenyAll	De schijf kan niet worden geëxporteerd.

OperatingSystemTypes

Inventarisatie

Het type besturingssysteem.

Waarde	Description
Linux
Windows

PropertyUpdatesInProgress

Object

Eigenschappen van de schijf waarvoor de update in behandeling is.

Name	Type	Description
targetTier	string	De doelprestatielaag van de schijf als er een wijzigingsbewerking voor de laag wordt uitgevoerd.

ProvisionedBandwidthCopyOption

Inventarisatie

Als dit veld is ingesteld op een momentopname en createOption CopyStart is, wordt de momentopname met een snellere snelheid gekopieerd.

Waarde	Description
Enhanced
None

PublicNetworkAccess

Inventarisatie

Beleid voor het beheren van export op de schijf.

Waarde	Description
Disabled	U hebt geen toegang tot de onderliggende gegevens van de schijf openbaar op internet, zelfs niet wanneer NetworkAccessPolicy is ingesteld op AllowAll. U kunt de gegevens alleen openen via de SAS-URI vanuit uw vertrouwde Azure VNET wanneer NetworkAccessPolicy is ingesteld op AllowPrivate.
Enabled	U kunt een SAS-URI genereren voor toegang tot de onderliggende gegevens van de schijf openbaar op internet wanneer NetworkAccessPolicy is ingesteld op AllowAll. U kunt de gegevens alleen openen via de SAS-URI vanuit uw vertrouwde Azure VNET wanneer NetworkAccessPolicy is ingesteld op AllowPrivate.

PurchasePlan

Object

Wordt gebruikt voor het tot stand brengen van de aankoopcontext van elk artefact van derden via MarketPlace.

Name	Type	Description
name	string	De plan-id.
product	string	Hiermee geeft u het product van de installatiekopieën van de marketplace. Dit is dezelfde waarde als Offer onder het element imageReference.
promotionCode	string	De aanbiedingspromotiecode.
publisher	string	De uitgever-id.

ShareInfoElement

Object

Name	Type	Description
vmUri	string	Een relatieve URI met de id van de virtuele machine waaraan de schijf is gekoppeld.

SourceVault

Object

De kluis-id is een Azure Resource Manager-resource-id in het formulier /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}

Name	Type	Description
id	string	Resource-id

SupportedCapabilities

Object

Lijst met ondersteunde mogelijkheden die behouden blijven op de schijfresource voor vm-gebruik.

Name	Type	Description
acceleratedNetwork	boolean	Is waar als de installatiekopieën van waaruit de besturingssysteemschijf wordt gemaakt, ondersteuning bieden voor versneld netwerken.
architecture	Architecture	CPU-architectuur die wordt ondersteund door een besturingssysteemschijf.
diskControllerTypes	string	De schijfcontrollers die een besturingssysteemschijf ondersteunt. Als deze is ingesteld, kan dit SCSI of SCSI, NVME of NVME, SCSI zijn.

Delen via

Disks - Get

URI-parameters

Antwoorden

Beveiliging

azure_auth

Bereiken

Voorbeelden

Get information about a managed disk.

Voorbeeldaanvraag

Voorbeeldrespons

Definities

Architecture

CreationData

DataAccessAuthMode

Disk

DiskCreateOption

DiskSecurityProfile

DiskSecurityTypes

DiskSku

DiskState

DiskStorageAccountTypes

Encryption

EncryptionSettingsCollection

EncryptionSettingsElement

EncryptionType

ExtendedLocation

ExtendedLocationTypes

HyperVGeneration

ImageDiskReference

KeyVaultAndKeyReference

KeyVaultAndSecretReference

NetworkAccessPolicy

OperatingSystemTypes

PropertyUpdatesInProgress

ProvisionedBandwidthCopyOption

PublicNetworkAccess

PurchasePlan

ShareInfoElement

SourceVault

SupportedCapabilities

Aanvullende resources