Disks - Get

Referentie

Service:: Compute

API-versie:: 2023-10-02

Hiermee haalt u informatie op over een schijf.

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 waarmee het Microsoft Azure-abonnement uniek wordt geïdentificeerd. De abonnements-id maakt deel uit van de URI voor elke service-aanroep.
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 VM op. 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 naam van de SKU.
Encryption	Instellingen voor versleuteling at rest 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, is KeK optioneel en 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 update in behandeling is.
ProvisionedBandwidthCopyOption	Als dit veld is ingesteld op een momentopname en createOption CopyStart is, wordt de momentopname sneller gekopieerd.
PublicNetworkAccess	Beleid voor het beheren van de export op de schijf.
PurchasePlan	Wordt gebruikt voor het vaststellen van de aankoopcontext van een artefact van derden via MarketPlace.
ShareInfoElement
SourceVault	De kluis-id is een Azure Resource Manager-resource-id in de vorm /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}
SupportedCapabilities	Lijst met ondersteunde mogelijkheden die zijn behouden op de schijfresource voor vm-gebruik.

Architecture

CPU-architectuur die wordt ondersteund door een besturingssysteemschijf.

Name	Type	Description
Arm64	string
x64	string

CreationData

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 galerieinstallatiekopie maakt. De id/sharedGalleryImageId/communityGalleryImageId van de ImageDiskReference is de ARM-id van de versie van de gedeelde installatiekopie van waaruit een schijf wordt gemaakt.
imageReference	ImageDiskReference	Schijfbroninformatie voor PIR- of gebruikersinstallatiekopieën.
logicalSectorSize	integer	Logische sectorgrootte 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 voor het prestatiedoel van de geïmplementeerde schijf. Kijk hier voor het respectieve prestatiedoel. Deze vlag kan alleen worden ingesteld bij het maken 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 sneller gekopieerd.
securityDataUri	string	Als createOption ImportSecure is, is dit de URI van een blob die moet worden geïmporteerd in de VM-gaststatus.
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 die de bron van deze resource identificeert.
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 als schijf moet worden geïmporteerd.
uploadSizeBytes	integer	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) zijn.

DataAccessAuthMode

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

Name	Type	Description
AzureActiveDirectory	string	Wanneer 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	string	Er wordt geen extra verificatie uitgevoerd bij het openen van de export-/upload-URL.

Disk

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 waarop 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 moet worden ingesteld op een waarde die groter is dan één voor schijven, zodat ze aan meerdere VM's kunnen worden gekoppeld.
name	string	Resourcenaam
properties.LastOwnershipUpdateTime	string	De UTC-tijd waarop de eigendomsstatus van de schijf voor het laatst is gewijzigd, dat wil zeggen het tijdstip waarop de schijf voor het laatst is gekoppeld of losgekoppeld van een VIRTUELE machine of het tijdstip waarop de toewijzing van de VM waaraan de schijf is gekoppeld, ongedaan is gemaakt of is gestart.
properties.burstingEnabled	boolean	Stel in op true om bursting buiten het ingerichte prestatiedoel van de schijf in te schakelen. Bursting is standaard uitgeschakeld. Is niet van toepassing op Ultra-schijven.
properties.burstingEnabledTime	string	Laatste tijdstip 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 bewerking CopyStart.
properties.creationData	CreationData	Gegevens van 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	Het totale aantal IOPS dat is toegestaan voor alle VM's die de gedeelde schijf koppelen als ReadOnly. Eén bewerking kan tussen 4k en 256.000 bytes worden overgedragen.
properties.diskIOPSReadWrite	integer	Het aantal IOPS dat is toegestaan voor deze schijf; alleen instelbaar voor UltraSSD-schijven. Eén bewerking kan tussen 4k en 256.000 bytes worden overgedragen.
properties.diskMBpsReadOnly	integer	De totale doorvoer (MBps) die is 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 machten van 10.
properties.diskMBpsReadWrite	integer	De bandbreedte die is toegestaan voor deze schijf; alleen instelbaar voor UltraSSD-schijven. MBps betekent miljoenen bytes per seconde: MB maakt hier gebruik van de ISO-notatie, van machten van 10.
properties.diskSizeBytes	integer	De grootte van de schijf in bytes. Dit veld is alleen-lezen.
properties.diskSizeGB	integer	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 van andere opties, duidt dit op een formaat wijzigen. Grootten zijn alleen toegestaan als de schijf niet is gekoppeld aan een actieve VM en kan alleen de grootte van de schijf 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	De verzameling versleutelingsinstellingen die wordt 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	Het maximum aantal VM's dat tegelijkertijd aan de schijf kan worden gekoppeld. Waarde groter dan één geeft een schijf aan die op meerdere VM's tegelijk kan worden gekoppeld.
properties.networkAccessPolicy	NetworkAccessPolicy	Beleid voor toegang tot de schijf via het netwerk.
properties.optimizedForFrequentAttach	boolean	Als u deze eigenschap instelt op true, worden de betrouwbaarheid en prestaties verbeterd van gegevensschijven die vaak (meer dan 5 keer per dag) worden losgekoppeld van de ene virtuele machine en aan een andere worden gekoppeld. Deze eigenschap moet niet worden ingesteld voor schijven die niet vaak worden losgekoppeld en gekoppeld, omdat dit ervoor zorgt dat de schijven niet worden uitgelijnd 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 de 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 moet worden ingesteld op een waarde die groter is dan één voor schijven, zodat ze aan meerdere VM's kunnen worden gekoppeld.
properties.supportedCapabilities	SupportedCapabilities	Lijst met ondersteunde mogelijkheden voor de installatiekopieën op basis waarvan de besturingssysteemschijf is gemaakt.
properties.supportsHibernation	boolean	Geeft aan dat het besturingssysteem op een schijf de sluimerstand ondersteunt.
properties.tier	string	De 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	Het tijdstip waarop de schijf is gemaakt.
properties.uniqueId	string	Unieke GUID waarmee de resource wordt geïdentificeerd.
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	Resourcetype
zones	string[]	De lijst logische zone voor Schijf.

DiskCreateOption

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

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

DiskSecurityProfile

Bevat de beveiligingsgerelateerde informatie voor de resource.

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

DiskSecurityTypes

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

Name	Type	Description
ConfidentialVM_DiskEncryptedWithCustomerKey	string	Geeft een vertrouwelijke VM-schijf aan met zowel de besturingssysteemschijf als de VM-gaststatus versleuteld met een door de klant beheerde sleutel
ConfidentialVM_DiskEncryptedWithPlatformKey	string	Geeft een vertrouwelijke VM-schijf aan met zowel de besturingssysteemschijf als de VM-gaststatus versleuteld met een door het platform beheerde sleutel
ConfidentialVM_NonPersistedTPM	string	Geeft een vertrouwelijke VM-schijf met een tijdelijke vTPM aan. De vTPM-status blijft niet behouden wanneer de VM opnieuw wordt opgestart.
ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey	string	Geeft een vertrouwelijke VM-schijf aan met alleen de VM-gaststatus versleuteld
TrustedLaunch	string	Trusted Launch biedt beveiligingsfuncties zoals beveiligd opstarten en virtuele Trusted Platform Module (vTPM)

DiskSku

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

Hiermee wordt de mogelijke status van de schijf opgesomd.

Name	Type	Description
ActiveSAS	string	Aan de schijf is momenteel een actieve SAS-URI gekoppeld.
ActiveSASFrozen	string	De schijf is gekoppeld aan een VM in de sluimerstand en er is een actieve SAS-URI aan gekoppeld.
ActiveUpload	string	Er wordt een schijf gemaakt voor uploaden en er is een schrijftoken uitgegeven om ernaar te uploaden.
Attached	string	De schijf is momenteel gekoppeld aan een actieve VM.
Frozen	string	De schijf is gekoppeld aan een VM die zich in de sluimerstand bevindt.
ReadyToUpload	string	Een schijf kan worden gemaakt door te uploaden door een schrijftoken aan te vragen.
Reserved	string	De schijf is gekoppeld aan een vm waarvoor de toewijzing is gestopt.
Unattached	string	De schijf wordt niet gebruikt en kan worden gekoppeld aan een virtuele machine.

DiskStorageAccountTypes

De naam van de SKU.

Name	Type	Description
PremiumV2_LRS	string	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	string	Premium SSD lokaal redundante opslag. Het meest geschikt voor productie- en prestatiegevoelige workloads.
Premium_ZRS	string	Premium SSD zone redundante opslag. Het meest geschikt voor de productieworkloads die opslagtolerantie nodig hebben tegen zonefouten.
StandardSSD_LRS	string	Standaard SSD lokaal redundante opslag. Geschikt voor webservers, licht gebruikte bedrijfstoepassingen en ontwikkelen/testen.
StandardSSD_ZRS	string	Standard SSD zone redundante opslag. Het meest geschikt voor webservers, licht gebruikte bedrijfstoepassingen en ontwikkel-/testtoepassingen die opslagtolerantie nodig hebben tegen zonefouten.
Standard_LRS	string	Standard HDD lokaal redundante opslag. Geschikt voor back-up, niet-kritieke en onregelmatige toegang.
UltraSSD_LRS	string	Lokaal redundante ultra-SSD-opslag. Het meest geschikt voor IO-intensieve workloads zoals SAP HANA, databases van de hoogste laag (bijvoorbeeld SQL, Oracle) en andere werkbelastingen met veel transacties.

Encryption

Instellingen voor versleuteling at rest 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

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 AAD-app.'1.1' komt overeen met Azure Disk Encryption.

EncryptionSettingsElement

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 wordt gebruikt om de schijfversleutelingssleutel uit te pakken.

EncryptionType

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

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

ExtendedLocation

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

Het type van de uitgebreide locatie.

Name	Type	Description
EdgeZone	string

HyperVGeneration

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

Name	Type	Description
V1	string
V2	string

ImageDiskReference

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

Name	Type	Description
communityGalleryImageId	string	Een relatieve URI met een verwijzing naar azure Compute Gallery-installatiekopieën van de community.
id	string	Een relatieve URI die een opslagplaats voor platforminstallatiekopieën, gebruikersinstallatiekopieën of Azure Compute Gallery-installatiekopieën bevat.
lun	integer	Als de schijf is 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

Key Vault sleutel-URL en kluis-id van KeK, is KeK optioneel en 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

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

Beleid voor toegang tot de schijf via het netwerk.

Name	Type	Description
AllowAll	string	De schijf kan vanuit elk netwerk worden geëxporteerd of geüpload.
AllowPrivate	string	De schijf kan worden geëxporteerd of geüpload naar met behulp van de privé-eindpunten van een DiskAccess-resource.
DenyAll	string	De schijf kan niet worden geëxporteerd.

OperatingSystemTypes

Het type Besturingssysteem.

Name	Type	Description
Linux	string
Windows	string

PropertyUpdatesInProgress

Eigenschappen van de schijf waarvoor update in behandeling is.

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

ProvisionedBandwidthCopyOption

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

Name	Type	Description
Enhanced	string
None	string

PublicNetworkAccess

Beleid voor het beheren van de export op de schijf.

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

PurchasePlan

Wordt gebruikt voor het vaststellen van de aankoopcontext van een 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 Aanbieding onder het element imageReference.
promotionCode	string	De aanbiedingspromotiecode.
publisher	string	De uitgever-id.

ShareInfoElement

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

SourceVault

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

Name	Type	Description
id	string	Resource-id

SupportedCapabilities

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

Name	Type	Description
acceleratedNetwork	boolean	Waar als de installatiekopieën van waaruit de besturingssysteemschijf is gemaakt, versnelde netwerken ondersteunen.
architecture	Architecture	CPU-architectuur die wordt ondersteund door een besturingssysteemschijf.
diskControllerTypes	string	De schijfcontrollers die door een besturingssysteemschijf worden ondersteund. Als dit 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