Disk Restore Point - Get

Servizio:

Compute

Versione API:

2026-03-02

Ottenere la risorsa restorePoint del disco

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Compute/restorePointCollections/{restorePointCollectionName}/restorePoints/{vmRestorePointName}/diskRestorePoints/{diskRestorePointName}?api-version=2026-03-02

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
diskRestorePointName	path	True	string	Nome di DiskRestorePoint
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
restorePointCollectionName	path	True	string	Nome dell'insieme di punti di ripristino a cui appartiene il punto di ripristino del disco.
subscriptionId	path	True	string minLength: 1	ID della sottoscrizione di destinazione.
vmRestorePointName	path	True	string	Nome del punto di ripristino della macchina virtuale a cui appartiene il punto di ripristino del disco del disco.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	DiskRestorePoint	L'operazione di Azure è stata completata correttamente.
Other Status Codes	CloudError	Risposta di errore imprevista.

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	impersonare il tuo account utente

Esempio

get a ConfidentialVM incremental disk restorePoint resource with confidentialVMVersion.

get a disk restorePoint resource with InstantAccess snapshotAccessState.

get an incremental disk restorePoint resource.

get an incremental disk restorePoint when source resource is from a different region

get a ConfidentialVM incremental disk restorePoint resource with confidentialVMVersion.

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/myConfidentialDisk_c4bc27e0-ccf6-494e-a740-af34de775527?api-version=2026-03-02

Risposta di esempio

Codice di stato:

200

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/myConfidentialDisk_c4bc27e0-ccf6-494e-a740-af34de775527",
  "name": "myConfidentialDisk_c4bc27e0-ccf6-494e-a740-af34de775527",
  "properties": {
    "timeCreated": "2026-03-02T04:41:35.079872+00:00",
    "sourceResourceId": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/myConfidentialDisk",
    "osType": "Windows",
    "hyperVGeneration": "V2",
    "familyId": "f22e934b-c768-447f-8c44-ada4b40224ec",
    "sourceUniqueId": "d633885d-d102-4481-901e-5b2413d1a7be",
    "networkAccessPolicy": "AllowAll",
    "publicNetworkAccess": "Disabled",
    "securityProfile": {
      "securityType": "ConfidentialVM_DiskEncryptedWithPlatformKey",
      "confidentialVMVersion": "V2"
    },
    "logicalSectorSize": 4096
  }
}

get a disk restorePoint resource with InstantAccess snapshotAccessState.

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/TestDisk45ceb03433006d1baee_5c1528-43e2-4c77-9c55-a78bf5a5fc88?api-version=2026-03-02

Risposta di esempio

Codice di stato:

200

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/TestDisk45ceb03433006d1baee_5c1528-43e2-4c77-9c55-a78bf5a5fc88",
  "name": "TestDisk45ceb03433006d1baee_5c1528-43e2-4c77-9c55-a78bf5a5fc88",
  "properties": {
    "timeCreated": "2026-03-02T04:41:35.079872+00:00",
    "sourceResourceId": "/subscriptions/{subscriptionId}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/disks/TestDisk45ceb03433006d1baee",
    "osType": "Windows",
    "hyperVGeneration": "V2",
    "familyId": "f22e934b-c768-447f-8c44-ada4b40224ec",
    "sourceUniqueId": "d633885d-d102-4481-901e-5b2413d1a7be",
    "networkAccessPolicy": "AllowAll",
    "publicNetworkAccess": "Disabled",
    "completionPercent": 100,
    "logicalSectorSize": 4096,
    "snapshotAccessState": "InstantAccess"
  }
}

get an incremental disk restorePoint resource.

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745?api-version=2026-03-02

Risposta di esempio

Codice di stato:

200

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745",
  "name": "TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745",
  "properties": {
    "timeCreated": "2020-09-16T04:41:35.079872+00:00",
    "sourceResourceId": "/subscriptions/d2260d06-e00d-422f-8b63-93df551a59ae/resourceGroups/rg0680fb0c-89f1-41b4-96c0-35733a181558/providers/Microsoft.Compute/disks/TestDisk45ceb03433006d1baee0",
    "osType": "Windows",
    "hyperVGeneration": "V1",
    "familyId": "996bf3ce-b6ff-4e86-9db6-dc27ea06cea5",
    "sourceUniqueId": "48e058b1-7eea-4968-b532-10a8a1130c13",
    "networkAccessPolicy": "AllowAll",
    "publicNetworkAccess": "Disabled",
    "logicalSectorSize": 4096
  }
}

get an incremental disk restorePoint when source resource is from a different region

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745?api-version=2026-03-02

Risposta di esempio

Codice di stato:

200

{
  "id": "/subscriptions/{subscription-id}/resourceGroups/myResourceGroup/providers/Microsoft.Compute/restorePointCollections/rpc/restorePoints/vmrp/diskRestorePoints/TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745",
  "name": "TestDisk45ceb03433006d1baee0_b70cd924-3362-4a80-93c2-9415eaa12745",
  "properties": {
    "timeCreated": "2020-09-16T04:41:35.079872+00:00",
    "sourceResourceId": "/subscriptions/d2260d06-e00d-422f-8b63-93df551a59ae/resourceGroups/rg0680fb0c-89f1-41b4-96c0-35733a181558/providers/Microsoft.Compute/disks/TestDisk45ceb03433006d1baee0",
    "osType": "Windows",
    "hyperVGeneration": "V1",
    "familyId": "996bf3ce-b6ff-4e86-9db6-dc27ea06cea5",
    "sourceUniqueId": "48e058b1-7eea-4968-b532-10a8a1130c13",
    "networkAccessPolicy": "AllowAll",
    "publicNetworkAccess": "Disabled",
    "replicationState": "Succeeded",
    "completionPercent": 100,
    "sourceResourceLocation": "eastus2",
    "logicalSectorSize": 4096
  }
}

Definizioni

Nome	Descrizione
ApiError	Errore API.
ApiErrorBase	Base di errore API.
Architecture	Architettura della CPU supportata da un disco del sistema operativo.
CloudError	Risposta di errore dal servizio di calcolo.
ConfidentialVMVersion	Indica la versione della VM Confidential per la risorsa.
createdByType	Tipo di identità che ha creato la risorsa.
DiskPurchasePlan	Usato per stabilire il contesto di acquisto di qualsiasi artefatto di terze parti tramite MarketPlace.
DiskRestorePoint	Proprietà del punto di ripristino del 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.
Encryption	Impostazioni di crittografia dei dati inattivi per disco o snapshot
EncryptionType	Tipo di chiave utilizzata per crittografare i dati del disco.
HyperVGeneration	Generazione dell'hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo.
InnerError	Dettagli dell'errore interno.
NetworkAccessPolicy	Criteri per l'accesso al disco tramite rete.
OperatingSystemTypes	Tipo di sistema operativo.
PublicNetworkAccess	Criteri per controllare l'esportazione sul disco.
SnapshotAccessState	Stato dello snapshot che determina la disponibilità di accesso dello snapshot.
SupportedCapabilities	Elenco delle funzionalità supportate rese persistenti nella risorsa disco per l'uso della macchina virtuale.
SupportedSecurityOption	Si riferisce alla funzionalità di sicurezza del disco supportata per creare un avvio attendibile o una macchina virtuale riservata
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

ApiError

Oggetto

Errore API.

Nome	Tipo	Descrizione
code	string	Codice di errore.
details	ApiErrorBase[]	Dettagli dell'errore Api
innererror	InnerError	L'errore interno dell'API
message	string	Messaggio di errore.
target	string	Destinazione dell'errore specifico.

ApiErrorBase

Oggetto

Base di errore API.

Nome	Tipo	Descrizione
code	string	Codice di errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore specifico.

Architecture

Enumerazione

Architettura della CPU supportata da un disco del sistema operativo.

Valore	Descrizione
x64
Arm64

CloudError

Oggetto

Risposta di errore dal servizio di calcolo.

Nome	Tipo	Descrizione
error	ApiError	Errore API.

ConfidentialVMVersion

Enumerazione

Indica la versione della VM Confidential per la risorsa.

Valore	Descrizione
V1	V1 indica che la risorsa non possiede metadati associati alla macchina virtuale.
V2	V2 indica che la risorsa possiede un Metadata della Macchina Virtuale associati.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
User
Application
ManagedIdentity
Key

DiskPurchasePlan

Oggetto

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

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

DiskRestorePoint

Oggetto

Proprietà del punto di ripristino del disco

Nome	Tipo	Descrizione
id	string	Identificatore di risorsa completamente qualificato per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	nome della risorsa.
properties.completionPercent	number (float)	Percentuale di completamento per la copia in background del punto di ripristino del disco quando la risorsa di origine proviene da un'area diversa.
properties.diskAccessId	string	ID ARM della risorsa DiskAccess per l'uso di endpoint privati su dischi.
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.familyId	string	id della famiglia MIS dello snapshot di backup
properties.hyperVGeneration	HyperVGeneration	Generazione dell'hypervisor della macchina virtuale. Applicabile solo ai dischi del sistema operativo.
properties.logicalSectorSize	integer (int32)	Dimensioni del settore logico in byte per i punti di ripristino del disco di UltraSSD_LRS e dischi PremiumV2_LRS. I valori supportati sono 512 e 4096. 4096 è l'impostazione predefinita.
properties.networkAccessPolicy	NetworkAccessPolicy	Criteri per l'accesso al disco tramite rete.
properties.osType	OperatingSystemTypes	Tipo di sistema operativo.
properties.publicNetworkAccess	PublicNetworkAccess	Criteri per controllare l'esportazione sul disco.
properties.purchasePlan	DiskPurchasePlan	Informazioni sul piano di acquisto per l'immagine da cui è stato creato il disco del sistema operativo.
properties.replicationState	string	Stato di replica del punto di ripristino del disco quando la risorsa di origine proviene da un'area diversa.
properties.securityProfile	DiskSecurityProfile	Contiene le informazioni relative alla sicurezza per la risorsa.
properties.snapshotAccessState	SnapshotAccessState	Stato dello snapshot che determina la disponibilità di accesso dello snapshot.
properties.sourceResourceId	string	ARM ID del disco di origine o del punto di ripristino del disco di origine.
properties.sourceResourceLocation	string	Posizione del disco di origine o del punto di ripristino del disco di origine quando la risorsa di origine proviene da un'area diversa.
properties.sourceUniqueId	string	ID di incarnazione univoco del disco di origine
properties.supportedCapabilities	SupportedCapabilities	Elenco delle funzionalità supportate per l'immagine da cui è stato creato il disco del sistema operativo.
properties.supportsHibernation	boolean	Indica che il sistema operativo in un disco supporta l'ibernazione.
properties.timeCreated	string (date-time)	Il timestamp della creazione di restorePoint
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

DiskSecurityProfile

Oggetto

Contiene le informazioni relative alla sicurezza per la risorsa.

Nome	Tipo	Descrizione
confidentialVMVersion	ConfidentialVMVersion	Indica la versione della VM Confidential per la risorsa.
secureVMDiskEncryptionSetId	string	ResourceId del set di crittografia del disco associato a Confidential VM supported disk encrypted with customer managed key
securityType	DiskSecurityTypes	Specifica il Tipo di sicurezza della macchina virtuale. Applicabile solo per i dischi del sistema operativo.

DiskSecurityTypes

Enumerazione

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

Valore	Descrizione
TrustedLaunch	Avvio attendibile offre funzionalità di sicurezza come l'avvio protetto e il virtual Trusted Platform Module (vTPM)
ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey	Indica il disco di macchina virtuale riservato con solo lo stato guest della macchina virtuale crittografato
ConfidentialVM_DiskEncryptedWithPlatformKey	Indica un disco di macchina virtuale riservato con disco del sistema operativo e stato guest della macchina virtuale crittografato con una chiave gestita dalla piattaforma
ConfidentialVM_DiskEncryptedWithCustomerKey	Indica un disco di macchina virtuale riservato con disco del sistema operativo e stato guest della macchina virtuale crittografato con una chiave gestita dal cliente
ConfidentialVM_NonPersistedTPM	Indica un disco di macchina virtuale riservato con un vTPM temporaneo. Lo stato vTPM non viene salvato in modo permanente tra i riavvii della macchina virtuale.

Encryption

Oggetto

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.

EncryptionType

Enumerazione

Tipo di chiave utilizzata per crittografare i dati del disco.

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

HyperVGeneration

Enumerazione

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

Valore	Descrizione
V1
V2

InnerError

Oggetto

Dettagli dell'errore interno.

Nome	Tipo	Descrizione
errordetail	string	Messaggio di errore interno o dump di eccezione.
exceptiontype	string	Tipo di eccezione.

NetworkAccessPolicy

Enumerazione

Criteri per l'accesso al disco tramite rete.

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

OperatingSystemTypes

Enumerazione

Tipo di sistema operativo.

Valore	Descrizione
Windows
Linux

PublicNetworkAccess

Enumerazione

Criteri per controllare l'esportazione sul disco.

Valore	Descrizione
Enabled	È possibile generare un URI di firma di accesso condiviso per accedere pubblicamente ai dati sottostanti del disco 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.
Disabled	Non è possibile accedere pubblicamente ai dati sottostanti del disco 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.

SnapshotAccessState

Enumerazione

Stato dello snapshot che determina la disponibilità di accesso dello snapshot.

Valore	Descrizione
Unknown	Valore predefinito.
Pending	L'istantanea non può essere utilizzata per il ripristino, la copia o il download offline.
Available	L'istantanea può essere utilizzata per il ripristino, la copia in un'area diversa e il download offline.
InstantAccess	Lo snapshot può essere utilizzato per ripristinare dischi con prestazioni veloci, ma non può essere copiato o scaricato.
AvailableWithInstantAccess	L'istantanea può essere utilizzata per ripristinare dischi con prestazioni veloci, copiati e scaricati.

SupportedCapabilities

Oggetto

Elenco delle funzionalità supportate rese persistenti 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.
supportedSecurityOption	SupportedSecurityOption	Si riferisce alla funzionalità di sicurezza del disco supportata per creare un avvio attendibile o una macchina virtuale riservata

SupportedSecurityOption

Enumerazione

Si riferisce alla funzionalità di sicurezza del disco supportata per creare un avvio attendibile o una macchina virtuale riservata

Valore	Descrizione
TrustedLaunchSupported	Il disco supporta la creazione di macchine virtuali di avvio attendibile.
TrustedLaunchAndConfidentialVMSupported	Il disco supporta la creazione di macchine virtuali di avvio attendibile e riservate.

systemData

Oggetto

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.