Disks - Get

Riferimento

Servizio:: Compute

Versione API:: 2023-10-02

Ottiene informazioni su un disco.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
diskName	path	True	string	Nome del disco gestito creato. Non è possibile modificare il nome dopo la creazione del disco. I caratteri supportati per il nome sono a-z, A-Z, 0-9, _ e -. La lunghezza massima del nome è di 80 caratteri.
resourceGroupName	path	True	string	Nome del gruppo di risorse.
subscriptionId	path	True	string	Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.
api-version	query	True	string	Versione dell'API client.

Risposte

Nome	Tipo	Descrizione
200 OK	Disk	OK

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

Get information about a managed disk.

Esempio di richiesta

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://video2.skills-academy.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

Risposta di esempio

Codice di stato:: 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"
}

Definizioni

Nome	Descrizione
Architecture	Architettura della CPU supportata da un disco del sistema operativo.
CreationData	Dati usati durante la creazione di un disco.
DataAccessAuthMode	Requisiti di autenticazione aggiuntivi per l'esportazione o il caricamento in un disco o in uno snapshot.
Disk	Risorsa disco.
DiskCreateOption	In questo modo vengono enumerate le possibili origini della creazione di un disco.
DiskSecurityProfile	Contiene le informazioni relative alla sicurezza per la risorsa.
DiskSecurityTypes	Specifica il tipo di sicurezza della macchina virtuale. Applicabile solo per i dischi del sistema operativo.
DiskSku	Nome sku dischi. Può essere Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS o PremiumV2_LRS.
DiskState	In questo modo viene enumerato lo stato possibile del disco.
DiskStorageAccountTypes	Nome sku.
Encryption	Impostazioni di crittografia dei dati inattivi per disco o snapshot
EncryptionSettingsCollection	Impostazioni di crittografia per il disco o lo snapshot
EncryptionSettingsElement	Impostazioni di crittografia per un volume del disco.
EncryptionType	Tipo di chiave utilizzata per crittografare i dati del disco.
ExtendedLocation	Tipo complesso della posizione estesa.
ExtendedLocationTypes	Tipo della posizione estesa.
HyperVGeneration	Generazione di hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo.
ImageDiskReference	Immagine di origine usata per la creazione del disco.
KeyVaultAndKeyReference	Key Vault URL chiave e ID insieme di credenziali di KeK, KeK è facoltativo e, se specificato, viene usato per annullare ilrap della chiave di crittografiaKey
KeyVaultAndSecretReference	Key Vault l'URL segreto e l'ID dell'insieme di credenziali della chiave di crittografia
NetworkAccessPolicy	Criteri per l'accesso al disco tramite rete.
OperatingSystemTypes	Tipo di sistema operativo.
PropertyUpdatesInProgress	Proprietà del disco per cui l'aggiornamento è in sospeso.
ProvisionedBandwidthCopyOption	Se questo campo è impostato su uno snapshot e createOption è CopyStart, lo snapshot verrà copiato con una velocità più rapida.
PublicNetworkAccess	Criteri per il controllo dell'esportazione sul disco.
PurchasePlan	Usato per stabilire il contesto di acquisto di qualsiasi elemento di terze parti tramite MarketPlace.
ShareInfoElement
SourceVault	L'ID dell'insieme di credenziali è un ID risorsa di Azure Resource Manager nel formato /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}
SupportedCapabilities	Elenco delle funzionalità supportate mantenute nella risorsa disco per l'uso della macchina virtuale.

Architecture

Architettura della CPU supportata da un disco del sistema operativo.

Nome	Tipo	Descrizione
Arm64	string
x64	string

CreationData

Dati usati durante la creazione di un disco.

Nome	Tipo	Descrizione
createOption	DiskCreateOption	In questo modo vengono enumerate le possibili origini della creazione di un disco.
elasticSanResourceId	string	Obbligatorio se createOption è CopyFromSanSnapshot. Questo è l'ID ARM dello snapshot del volume san elastico di origine.
galleryImageReference	ImageDiskReference	Obbligatorio se si crea da un'immagine della raccolta. L'ID/sharedGalleryImageId/communityGalleryImageId dell'imageDiskReference sarà l'ID ARM della versione dell'immagine condivisa da cui creare un disco.
imageReference	ImageDiskReference	Informazioni sull'origine del disco per immagini PIR o utente.
logicalSectorSize	integer	Dimensioni del settore logico in byte per dischi Ultra. I valori supportati sono 512 ad 4096. 4096 è il valore predefinito.
performancePlus	boolean	Impostare questo flag su true per ottenere un incremento sulla destinazione delle prestazioni del disco distribuito, vedere qui sulla rispettiva destinazione delle prestazioni. Questo flag può essere impostato solo in fase di creazione del disco e non può essere disabilitato dopo l'abilitazione.
provisionedBandwidthCopySpeed	ProvisionedBandwidthCopyOption	Se questo campo è impostato su uno snapshot e createOption è CopyStart, lo snapshot verrà copiato con una velocità più rapida.
securityDataUri	string	Se createOption è ImportSecure, questo è l'URI di un BLOB da importare nello stato guest della macchina virtuale.
sourceResourceId	string	Se createOption è Copy, si tratta dell'ID ARM dello snapshot o del disco di origine.
sourceUniqueId	string	Se questo campo è impostato, questo è l'ID univoco che identifica l'origine di questa risorsa.
sourceUri	string	Se createOption è Import, questo è l'URI di un BLOB da importare in un disco gestito.
storageAccountId	string	Obbligatorio se createOption è Import. Identificatore di Azure Resource Manager dell'account di archiviazione contenente il BLOB da importare come disco.
uploadSizeBytes	integer	Se createOption è Upload, questa è la dimensione del contenuto del caricamento, incluso il piè di pagina del disco rigido virtuale. Questo valore deve essere compreso tra 20972032 (20 MiB + 512 byte per il piè di pagina del disco rigido virtuale) e 35183298347520 byte (32 TiB + 512 byte per il piè di pagina del disco rigido virtuale).

DataAccessAuthMode

Requisiti di autenticazione aggiuntivi per l'esportazione o il caricamento in un disco o in uno snapshot.

Nome	Tipo	Descrizione
AzureActiveDirectory	string	Quando si usa l'URL di esportazione/caricamento, il sistema verifica se l'utente ha un'identità in Azure Active Directory e dispone delle autorizzazioni necessarie per esportare/caricare i dati. Fare riferimento a aka.ms/DisksAzureADAuth.
None	string	Non viene eseguita alcuna autenticazione aggiuntiva quando si accede all'URL di esportazione/caricamento.

Disk

Risorsa disco.

Nome	Tipo	Descrizione
extendedLocation	ExtendedLocation	Percorso esteso in cui verrà creato il disco. Non è possibile modificare la posizione estesa.
id	string	ID risorsa
location	string	Posizione risorsa
managedBy	string	URI relativo contenente l'ID della macchina virtuale associata al disco.
managedByExtended	string[]	Elenco degli URI relativi contenenti gli ID delle macchine virtuali associate al disco. maxShares deve essere impostato su un valore maggiore di uno per i dischi per consentire il collegamento a più macchine virtuali.
name	string	Nome risorsa
properties.LastOwnershipUpdateTime	string	Ora UTC quando lo stato di proprietà del disco è stato modificato per l'ultima volta che il disco è stato collegato o scollegato da una macchina virtuale o dall'ora in cui è stata associata la macchina virtuale a cui è stato collegato il disco è stato deallocato o avviato.
properties.burstingEnabled	boolean	Impostare su true per abilitare il bursting oltre la destinazione delle prestazioni di cui è stato effettuato il provisioning del disco. Il bursting è disabilitato per impostazione predefinita. Non si applica ai dischi Ultra.
properties.burstingEnabledTime	string	Ultima volta che il bursting è stato abilitato per l'ultima volta in un disco.
properties.completionPercent	number	Percentuale completata per la copia in background quando viene creata una risorsa tramite l'operazione CopyStart.
properties.creationData	CreationData	Informazioni sull'origine del disco. Le informazioni CreateData non possono essere modificate dopo la creazione del disco.
properties.dataAccessAuthMode	DataAccessAuthMode	Requisiti di autenticazione aggiuntivi durante l'esportazione o il caricamento in un disco o uno snapshot.
properties.diskAccessId	string	ID ARM della risorsa DiskAccess per l'uso di endpoint privati nei dischi.
properties.diskIOPSReadOnly	integer	Numero totale di operazioni di I/O al secondo consentite in tutte le macchine virtuali che montano il disco condiviso come ReadOnly. Un'operazione può trasferire tra 4k e 256k byte.
properties.diskIOPSReadWrite	integer	Numero di operazioni di I/O al secondo consentite per questo disco; solo impostabile per i dischi UltraSD. Un'operazione può trasferire tra 4k e 256k byte.
properties.diskMBpsReadOnly	integer	Velocità effettiva totale (MBps) che sarà consentita in tutte le macchine virtuali che montano il disco condiviso come ReadOnly. MBps significa milioni di byte al secondo: MB usa la notazione ISO, di 10 poteri.
properties.diskMBpsReadWrite	integer	Larghezza di banda consentita per questo disco; solo impostabile per i dischi UltraSD. MBps significa milioni di byte al secondo: MB usa la notazione ISO, di 10 poteri.
properties.diskSizeBytes	integer	Dimensioni del disco in byte. Questo campo è di sola lettura.
properties.diskSizeGB	integer	Se creationData.createOption è Vuoto, questo campo è obbligatorio e indica le dimensioni del disco da creare. Se questo campo è presente per gli aggiornamenti o la creazione con altre opzioni, indica un ridimensionamento. Le ridimensionazioni sono consentite solo se il disco non è collegato a una macchina virtuale in esecuzione e può aumentare solo le dimensioni del disco.
properties.diskState	DiskState	Stato del disco.
properties.encryption	Encryption	La proprietà di crittografia può essere usata per crittografare i dati inattivi con chiavi gestite dal cliente o chiavi gestite dalla piattaforma.
properties.encryptionSettingsCollection	EncryptionSettingsCollection	La raccolta di impostazioni di crittografia usata per Crittografia dischi di Azure può contenere più impostazioni di crittografia per disco o snapshot.
properties.hyperVGeneration	HyperVGeneration	Generazione di hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo.
properties.maxShares	integer	Numero massimo di macchine virtuali che possono connettersi al disco contemporaneamente. Il valore maggiore di uno indica un disco che può essere montato su più macchine virtuali contemporaneamente.
properties.networkAccessPolicy	NetworkAccessPolicy	Criteri per l'accesso al disco tramite rete.
properties.optimizedForFrequentAttach	boolean	L'impostazione di questa proprietà su true migliora l'affidabilità e le prestazioni dei dischi dati che sono spesso (più di 5 volte al giorno) scollegate da una macchina virtuale e collegate a un'altra. Questa proprietà non deve essere impostata per i dischi non scollegati e collegati frequentemente perché i dischi non sono allineati al dominio di errore della macchina virtuale.
properties.osType	OperatingSystemTypes	Tipo di sistema operativo.
properties.propertyUpdatesInProgress	PropertyUpdatesInProgress	Proprietà del disco per cui l'aggiornamento è in sospeso.
properties.provisioningState	string	Stato di provisioning del disco.
properties.publicNetworkAccess	PublicNetworkAccess	Criteri per il controllo dell'esportazione sul disco.
properties.purchasePlan	PurchasePlan	Informazioni sul piano di acquisto per l'immagine da cui è stato creato il disco del sistema operativo. Ad esempio, {name: 2019-Datacenter, editore: MicrosoftWindowsServer, prodotto: WindowsServer}
properties.securityProfile	DiskSecurityProfile	Contiene le informazioni correlate alla sicurezza per la risorsa.
properties.shareInfo	ShareInfoElement[]	Dettagli dell'elenco di tutte le macchine virtuali associate al disco. maxShares deve essere impostato su un valore maggiore di uno per i dischi per consentire il collegamento a più macchine virtuali.
properties.supportedCapabilities	SupportedCapabilities	Elenco delle funzionalità supportate per l'immagine da cui è stato creato il disco del sistema operativo.
properties.supportsHibernation	boolean	Indica il sistema operativo in un disco che supporta l'ibernazione.
properties.tier	string	Livello di prestazioni del disco (ad esempio, P4, S10) come descritto di seguito: https://azure.microsoft.com/en-us/pricing/details/managed-disks/. Non si applica ai dischi Ultra.
properties.timeCreated	string	Ora di creazione del disco.
properties.uniqueId	string	Guid univoco che identifica la risorsa.
sku	DiskSku	Nome sku dischi. Può essere Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS o PremiumV2_LRS.
tags	object	Tag delle risorse
type	string	Tipo di risorsa
zones	string[]	Elenco di zone logiche per Disco.

DiskCreateOption

In questo modo vengono enumerate le possibili origini della creazione di un disco.

Nome	Tipo	Descrizione
Attach	string	Il disco verrà collegato a una macchina virtuale.
Copy	string	Creare un nuovo disco o uno snapshot copiando da un disco o uno snapshot specificato dall'oggetto sourceResourceId specificato.
CopyFromSanSnapshot	string	Creare un nuovo disco esportando dallo snapshot del volume san elastico
CopyStart	string	Creare un nuovo disco usando un processo di copia completa, in cui la creazione della risorsa viene considerata completa solo dopo che tutti i dati sono stati copiati dall'origine.
Empty	string	Creare un disco dati vuoto di una dimensione specificata da diskSizeGB.
FromImage	string	Creare un nuovo disco da un'immagine della piattaforma specificata dall'oggetto imageReference o galleryImageReference specificato.
Import	string	Creare un disco importando da un BLOB specificato da un sourceUri in un account di archiviazione specificato da storageAccountId.
ImportSecure	string	Analogamente all'opzione Di importazione crea. Creare una nuova macchina virtuale di avvio attendibile o un disco riservato supportato importando un BLOB aggiuntivo per lo stato guest della macchina virtuale specificato da securityDataUri nell'account di archiviazione specificato da storageAccountId
Restore	string	Creare un nuovo disco copiando da un punto di ripristino di backup.
Upload	string	Creare un nuovo disco ottenendo un token di scrittura e usandolo per caricare direttamente il contenuto del disco.
UploadPreparedSecure	string	Analogamente all'opzione Di caricamento crea. Creare una nuova macchina virtuale di avvio attendibile o un disco riservato supportato e caricarlo usando il token di scrittura nello stato guest del disco e della macchina virtuale

DiskSecurityProfile

Contiene le informazioni relative alla sicurezza per la risorsa.

Nome	Tipo	Descrizione
secureVMDiskEncryptionSetId	string	ResourceId del set di crittografia del disco associato alla macchina virtuale riservata supportata crittografata con la chiave gestita dal cliente
securityType	DiskSecurityTypes	Specifica il tipo di sicurezza della macchina virtuale. Applicabile solo per i dischi del sistema operativo.

DiskSecurityTypes

Specifica il tipo di sicurezza della macchina virtuale. Applicabile solo per i dischi del sistema operativo.

Nome	Tipo	Descrizione
ConfidentialVM_DiskEncryptedWithCustomerKey	string	Indica il disco di macchina virtuale riservato con disco del sistema operativo e lo stato guest della macchina virtuale crittografato con una chiave gestita dal cliente
ConfidentialVM_DiskEncryptedWithPlatformKey	string	Indica il disco di macchina virtuale riservato con disco del sistema operativo e lo stato guest della macchina virtuale crittografato con una chiave gestita dalla piattaforma
ConfidentialVM_NonPersistedTPM	string	Indica il disco vm riservato con una vTPM temporaneo. Lo stato vTPM non viene mantenuto tra i riavvii della macchina virtuale.
ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey	string	Indica il disco di macchina virtuale riservato con solo lo stato guest della macchina virtuale crittografato
TrustedLaunch	string	L'avvio attendibile offre funzionalità di sicurezza, ad esempio l'avvio protetto e il virtual Trusted Platform Module (vTPM)

DiskSku

Nome sku dischi. Può essere Standard_LRS, Premium_LRS, StandardSSD_LRS, UltraSSD_LRS, Premium_ZRS, StandardSSD_ZRS o PremiumV2_LRS.

Nome	Tipo	Descrizione
name	DiskStorageAccountTypes	Nome sku.
tier	string	Livello sku.

DiskState

In questo modo viene enumerato lo stato possibile del disco.

Nome	Tipo	Descrizione
ActiveSAS	string	Al disco è attualmente associato un URI di firma di accesso condiviso attivo.
ActiveSASFrozen	string	Il disco è collegato a una macchina virtuale in stato di ibernazione e ha un URI di firma di accesso condiviso attivo associato.
ActiveUpload	string	Viene creato un disco per il caricamento e viene rilasciato un token di scrittura per il caricamento.
Attached	string	Il disco è attualmente collegato a una macchina virtuale in esecuzione.
Frozen	string	Il disco è collegato a una macchina virtuale in stato di ibernazione.
ReadyToUpload	string	Un disco è pronto per essere creato caricando richiedendo un token di scrittura.
Reserved	string	Il disco è collegato a una macchina virtuale arrestata deallocata.
Unattached	string	Il disco non viene usato e può essere collegato a una macchina virtuale.

DiskStorageAccountTypes

Nome sku.

Nome	Tipo	Descrizione
PremiumV2_LRS	string	Archiviazione ssd Premium v2 con ridondanza locale. Ideale per carichi di lavoro sensibili alle prestazioni e di produzione che richiedono costantemente bassa latenza e velocità effettiva e operazioni di I/O al secondo elevate.
Premium_LRS	string	Archiviazione ssd Premium con ridondanza locale. Ideale per carichi di lavoro sensibili alla produzione e alle prestazioni.
Premium_ZRS	string	Archiviazione con ridondanza della zona SSD Premium. Ideale per i carichi di lavoro di produzione che richiedono resilienza di archiviazione in caso di errori di zona.
StandardSSD_LRS	string	Archiviazione con ridondanza locale SSD Standard. Ideale per i server Web, applicazioni aziendali usate in modo leggero e sviluppo/test.
StandardSSD_ZRS	string	Archiviazione con ridondanza della zona SSD Standard. Ideale per i server Web, applicazioni aziendali usate in modo leggero e sviluppo/test che necessitano di resilienza di archiviazione in caso di errori di zona.
Standard_LRS	string	Archiviazione hdd standard con ridondanza locale. Ideale per l'accesso di backup, non critico e poco frequente.
UltraSSD_LRS	string	Archiviazione ultra SSD con ridondanza locale. Ideale per carichi di lavoro a elevato utilizzo di I/O, ad esempio SAP HANA, database di livello superiore (ad esempio SQL, Oracle) e altri carichi di lavoro con elevato utilizzo di transazioni.

Encryption

Impostazioni di crittografia dei dati inattivi per disco o snapshot

Nome	Tipo	Descrizione
diskEncryptionSetId	string	ResourceId del set di crittografia del disco da usare per abilitare la crittografia dei dati inattivi.
type	EncryptionType	Tipo di chiave utilizzata per crittografare i dati del disco.

EncryptionSettingsCollection

Impostazioni di crittografia per il disco o lo snapshot

Nome	Tipo	Descrizione
enabled	boolean	Impostare questo flag su true e specificare DiskEncryptionKey e keyEncryptionKey facoltativo per abilitare la crittografia. Impostare questo flag su false e rimuovere DiskEncryptionKey e KeyEncryptionKey per disabilitare la crittografia. Se EncryptionSettings è Null nell'oggetto richiesta, le impostazioni esistenti rimangono invariate.
encryptionSettings	EncryptionSettingsElement[]	Raccolta di impostazioni di crittografia, una per ogni volume del disco.
encryptionSettingsVersion	string	Descrive il tipo di crittografia usato per i dischi. Dopo aver impostato questo campo, non può essere sovrascritto. '1.0' corrisponde a Crittografia dischi di Azure con l'app AAD.'1.1' corrisponde a Crittografia dischi di Azure.

EncryptionSettingsElement

Impostazioni di crittografia per un volume del disco.

Nome	Tipo	Descrizione
diskEncryptionKey	KeyVaultAndSecretReference	Key Vault l'URL segreto e l'ID dell'insieme di credenziali della chiave di crittografia del disco
keyEncryptionKey	KeyVaultAndKeyReference	Key Vault l'URL della chiave e l'ID dell'insieme di credenziali della chiave. KeyEncryptionKey è facoltativo e, se specificato, viene usato per annullare il wrapping della chiave di crittografia del disco.

EncryptionType

Tipo di chiave utilizzata per crittografare i dati del disco.

Nome	Tipo	Descrizione
EncryptionAtRestWithCustomerKey	string	Il disco viene crittografato inattivo con la chiave gestita dal cliente che può essere modificata e revocata da un cliente.
EncryptionAtRestWithPlatformAndCustomerKeys	string	Il disco viene crittografato inattivo con 2 livelli di crittografia. Una delle chiavi è Gestita dal cliente e l'altra è gestita dalla piattaforma.
EncryptionAtRestWithPlatformKey	string	Il disco viene crittografato inattivo con la chiave gestita dalla piattaforma. È il tipo di crittografia predefinito. Questo tipo di crittografia non è valido per i set di crittografia del disco.

ExtendedLocation

Tipo complesso della posizione estesa.

Nome	Tipo	Descrizione
name	string	Nome della posizione estesa.
type	ExtendedLocationTypes	Tipo della posizione estesa.

ExtendedLocationTypes

Tipo della posizione estesa.

Nome	Tipo	Descrizione
EdgeZone	string

HyperVGeneration

Generazione di hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo.

Nome	Tipo	Descrizione
V1	string
V2	string

ImageDiskReference

Immagine di origine usata per la creazione del disco.

Nome	Tipo	Descrizione
communityGalleryImageId	string	URI relativo contenente un riferimento all'immagine della raccolta di calcolo di Azure della community.
id	string	URI relativo contenente un repository di immagini della piattaforma, un'immagine utente o un riferimento all'immagine della raccolta di calcolo di Azure.
lun	integer	Se il disco viene creato dal disco dati di un'immagine, si tratta di un indice che indica quale dei dischi dati nell'immagine usare. Per i dischi del sistema operativo, questo campo è Null.
sharedGalleryImageId	string	URI relativo contenente un riferimento diretto all'immagine della raccolta di calcolo di Azure condivisa.

KeyVaultAndKeyReference

Key Vault URL chiave e ID insieme di credenziali di KeK, KeK è facoltativo e, se specificato, viene usato per annullare ilrap della chiave di crittografiaKey

Nome	Tipo	Descrizione
keyUrl	string	URL che punta a una chiave o a un segreto in KeyVault
sourceVault	SourceVault	ID risorsa di KeyVault contenente la chiave o il segreto

KeyVaultAndSecretReference

Key Vault l'URL segreto e l'ID dell'insieme di credenziali della chiave di crittografia

Nome	Tipo	Descrizione
secretUrl	string	URL che punta a una chiave o a un segreto in KeyVault
sourceVault	SourceVault	ID risorsa di KeyVault contenente la chiave o il segreto

NetworkAccessPolicy

Criteri per l'accesso al disco tramite rete.

Nome	Tipo	Descrizione
AllowAll	string	Il disco può essere esportato o caricato da qualsiasi rete.
AllowPrivate	string	Il disco può essere esportato o caricato in usando gli endpoint privati di una risorsa DiskAccess.
DenyAll	string	Impossibile esportare il disco.

OperatingSystemTypes

Tipo di sistema operativo.

Nome	Tipo	Descrizione
Linux	string
Windows	string

PropertyUpdatesInProgress

Proprietà del disco per cui l'aggiornamento è in sospeso.

Nome	Tipo	Descrizione
targetTier	string	Livello di prestazioni di destinazione del disco se è in corso un'operazione di modifica del livello.

ProvisionedBandwidthCopyOption

Se questo campo è impostato su uno snapshot e createOption è CopyStart, lo snapshot verrà copiato con una velocità più rapida.

Nome	Tipo	Descrizione
Enhanced	string
None	string

PublicNetworkAccess

Criteri per il controllo dell'esportazione sul disco.

Nome	Tipo	Descrizione
Disabled	string	Non è possibile accedere ai dati sottostanti del disco pubblicamente su Internet anche quando NetworkAccessPolicy è impostato su AllowAll. È possibile accedere ai dati tramite l'URI di firma di accesso condiviso solo dalla rete virtuale di Azure attendibile quando NetworkAccessPolicy è impostato su AllowPrivate.
Enabled	string	È possibile generare un URI di firma di accesso condiviso per accedere ai dati sottostanti del disco pubblicamente su Internet quando NetworkAccessPolicy è impostato su AllowAll. È possibile accedere ai dati tramite l'URI di firma di accesso condiviso solo dalla rete virtuale di Azure attendibile quando NetworkAccessPolicy è impostato su AllowPrivate.

PurchasePlan

Usato per stabilire il contesto di acquisto di qualsiasi elemento di terze parti tramite MarketPlace.

Nome	Tipo	Descrizione
name	string	ID piano.
product	string	Specifica il prodotto dell'immagine dal marketplace. Si tratta dello stesso valore dell'offerta nell'elemento imageReference.
promotionCode	string	Codice promozionale dell'offerta.
publisher	string	ID editore.

ShareInfoElement

Nome	Tipo	Descrizione
vmUri	string	URI relativo contenente l'ID della macchina virtuale a cui è collegato il disco.

SourceVault

L'ID dell'insieme di credenziali è un ID risorsa di Azure Resource Manager nel formato /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.KeyVault/vaults/{vaultName}

Nome	Tipo	Descrizione
id	string	ID risorsa

SupportedCapabilities

Elenco delle funzionalità supportate mantenute nella risorsa disco per l'uso della macchina virtuale.

Nome	Tipo	Descrizione
acceleratedNetwork	boolean	True se l'immagine da cui viene creato il disco del sistema operativo supporta la rete accelerata.
architecture	Architecture	Architettura della CPU supportata da un disco del sistema operativo.
diskControllerTypes	string	Controller del disco supportati da un disco del sistema operativo. Se impostato può essere SCSI o SCSI, NVME o NVME, SCSI.

Condividi tramite

Disks - Get

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

Get information about a managed disk.

Esempio di richiesta

Risposta di esempio

Definizioni

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

Risorse aggiuntive