Disk Restore Point - Get

Dienst:

Compute

API-Version:

2026-03-02

Abrufen der DatenträgerwiederherstellungPoint-Ressource

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

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
diskRestorePointName	path	True	string	Der Name des DiskRestorePoint
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
restorePointCollectionName	path	True	string	Der Name der Wiederherstellungspunktsammlung, zu der der Datenträgerwiederherstellungspunkt gehört.
subscriptionId	path	True	string minLength: 1	Die ID des Zielabonnements.
vmRestorePointName	path	True	string	Der Name des VM-Wiederherstellungspunkts, zu dem der Wiederherstellungspunkt des Datenträgers gehört.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	DiskRestorePoint	Der Azure-Vorgang wurde erfolgreich abgeschlossen.
Other Status Codes	CloudError	Unerwartete Fehlerantwort.

Sicherheit

azure_auth

Azure Active Directory OAuth2 Flow.

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name	Beschreibung
user_impersonation	Sich als Ihr Benutzerkonto ausgeben

Beispiele

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.

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

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.

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

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.

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

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

Beispielanforderung

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

Beispiel für eine Antwort

Statuscode:

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

Definitionen

Name	Beschreibung
ApiError	API-Fehler.
ApiErrorBase	API-Fehlerbasis.
Architecture	Cpu-Architektur, die von einem Betriebssystemdatenträger unterstützt wird.
CloudError	Eine Fehlerantwort vom Compute-Dienst.
ConfidentialVMVersion	Gibt die Version der Confidential VM für die Ressource an.
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
DiskPurchasePlan	Wird zum Einrichten des Kaufkontexts eines Drittanbieterartefaktes über MarketPlace verwendet.
DiskRestorePoint	Eigenschaften des Datenträgerwiederherstellungspunkts
DiskSecurityProfile	Enthält die sicherheitsbezogenen Informationen für die Ressource.
DiskSecurityTypes	Gibt den SecurityType der VM an. Gilt nur für Betriebssystemdatenträger.
Encryption	Verschlüsselung ruhender Einstellungen für Datenträger oder Momentaufnahme
EncryptionType	Der Schlüsseltyp, der zum Verschlüsseln der Daten des Datenträgers verwendet wird.
HyperVGeneration	Die Hypervisorgenerierung des virtuellen Computers. Gilt nur für Betriebssystemdatenträger.
InnerError	Innere Fehlerdetails.
NetworkAccessPolicy	Richtlinie für den Zugriff auf den Datenträger über das Netzwerk.
OperatingSystemTypes	Der Betriebssystemtyp.
PublicNetworkAccess	Richtlinie zum Steuern des Exports auf dem Datenträger.
SnapshotAccessState	Der Status des Snapshots, der die Zugriffsverfügbarkeit des Snapshots bestimmt.
SupportedCapabilities	Liste der unterstützten Funktionen, die auf der Datenträgerressource für die VM-Verwendung beibehalten werden.
SupportedSecurityOption	Bezieht sich auf die Sicherheitsfunktion des Datenträgers, die zum Erstellen eines vertrauenswürdigen Starts oder einer vertraulichen VM unterstützt wird
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

ApiError

Objekt

API-Fehler.

Name	Typ	Beschreibung
code	string	Der Fehlercode.
details	ApiErrorBase[]	Die Details zum API-Fehler
innererror	InnerError	Der innere API-Fehler
message	string	Die Fehlermeldung.
target	string	Das Ziel des bestimmten Fehlers.

ApiErrorBase

Objekt

API-Fehlerbasis.

Name	Typ	Beschreibung
code	string	Der Fehlercode.
message	string	Die Fehlermeldung.
target	string	Das Ziel des bestimmten Fehlers.

Architecture

Enumeration

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

Wert	Beschreibung
x64
Arm64

CloudError

Objekt

Eine Fehlerantwort vom Compute-Dienst.

Name	Typ	Beschreibung
error	ApiError	API-Fehler.

ConfidentialVMVersion

Enumeration

Gibt die Version der Confidential VM für die Ressource an.

Wert	Beschreibung
V1	V1 zeigt an, dass die Ressource keine zugehörige Virtual Machine Metadata besitzt.
V2	V2 gibt an, dass die Ressource eine zugehörige Virtual Machine Metadata besitzt.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
User
Application
ManagedIdentity
Key

DiskPurchasePlan

Objekt

Wird zum Einrichten des Kaufkontexts eines Drittanbieterartefaktes über MarketPlace verwendet.

Name	Typ	Beschreibung
name	string	Die Plan-ID.
product	string	Gibt das Produkt des Bilds vom Marketplace an. Dies ist derselbe Wert wie Offer unter dem imageReference-Element.
promotionCode	string	Der Angebotsaktionscode.
publisher	string	Die Herausgeber-ID.

DiskRestorePoint

Objekt

Eigenschaften des Datenträgerwiederherstellungspunkts

Name	Typ	Beschreibung
id	string	Vollqualifizierte Ressourcen-ID für die Ressource. Beispiel: /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Der Name der Ressource
properties.completionPercent	number (float)	Prozentsatz abgeschlossen für die Hintergrundkopie des Datenträgerwiederherstellungspunkts, wenn die Quellressource aus einem anderen Bereich stammt.
properties.diskAccessId	string	ARM-ID der DiskAccess-Ressource für die Verwendung privater Endpunkte auf Datenträgern.
properties.encryption	Encryption	Verschlüsselungseigenschaft kann verwendet werden, um ruhende Daten mit vom Kunden verwalteten Schlüsseln oder plattformverwalteten Schlüsseln zu verschlüsseln.
properties.familyId	string	ID der MIS-Familie des Sicherungssnapshots
properties.hyperVGeneration	HyperVGeneration	Die Hypervisorgenerierung des virtuellen Computers. Gilt nur für Betriebssystemdatenträger.
properties.logicalSectorSize	integer (int32)	Logische Sektorgröße in Byte für Datenträgerwiederherstellungspunkte von UltraSSD_LRS und PremiumV2_LRS Datenträgern. Unterstützte Werte sind 512 und 4096. 4096 ist die Standardeinstellung.
properties.networkAccessPolicy	NetworkAccessPolicy	Richtlinie für den Zugriff auf den Datenträger über das Netzwerk.
properties.osType	OperatingSystemTypes	Der Betriebssystemtyp.
properties.publicNetworkAccess	PublicNetworkAccess	Richtlinie zum Steuern des Exports auf dem Datenträger.
properties.purchasePlan	DiskPurchasePlan	Kaufplaninformationen für das Image, von dem der Betriebssystemdatenträger erstellt wurde.
properties.replicationState	string	Replikationsstatus des Datenträgerwiederherstellungspunkts, wenn die Quellressource aus einer anderen Region stammt.
properties.securityProfile	DiskSecurityProfile	Enthält die sicherheitsbezogenen Informationen für die Ressource.
properties.snapshotAccessState	SnapshotAccessState	Der Status des Snapshots, der die Zugriffsverfügbarkeit des Snapshots bestimmt.
properties.sourceResourceId	string	Arm-ID des Quelldatenträgers oder quelldatenträgerwiederherstellungspunkts.
properties.sourceResourceLocation	string	Speicherort des Quelldatenträgers oder quelldatenträgerwiederherstellungspunkts, wenn die Quellressource aus einer anderen Region stammt.
properties.sourceUniqueId	string	Eindeutige Inkarnations-ID der Quellfestplatte
properties.supportedCapabilities	SupportedCapabilities	Liste der unterstützten Funktionen für das Image, von dem der Betriebssystemdatenträger erstellt wurde.
properties.supportsHibernation	boolean	Gibt an, dass das Betriebssystem auf einem Datenträger den Ruhezustand unterstützt.
properties.timeCreated	string (date-time)	Der Zeitstempel der restorePoint-Erstellung
systemData	systemData	Azure Resource Manager-Metadaten, die createdBy- und modifiedBy-Informationen enthalten.
type	string	Der Typ der Ressource. Z. B. "Microsoft.Compute/virtualMachines" oder "Microsoft.Storage/storageAccounts"

DiskSecurityProfile

Objekt

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

Name	Typ	Beschreibung
confidentialVMVersion	ConfidentialVMVersion	Gibt die Version der Confidential VM für die Ressource an.
secureVMDiskEncryptionSetId	string	ResourceId des Datenträgerverschlüsselungssatzes, der mit dem vom Kunden verwalteten Schlüssel verschlüsselten vertraulichen virtuellen Computer verknüpft ist
securityType	DiskSecurityTypes	Gibt den SecurityType der VM an. Gilt nur für Betriebssystemdatenträger.

DiskSecurityTypes

Enumeration

Gibt den SecurityType der VM an. Gilt nur für Betriebssystemdatenträger.

Wert	Beschreibung
TrustedLaunch	Trusted Launch bietet Sicherheitsfeatures wie sicherer Start und virtuelles Trusted Platform Module (vTPM)
ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey	Gibt den datenträger vertraulichen virtuellen Computer an, auf dem nur der Gastzustand des virtuellen Computers verschlüsselt ist.
ConfidentialVM_DiskEncryptedWithPlatformKey	Gibt den datenträger vertraulichen virtuellen Computer mit verschlüsseltem Gaststatus des Betriebssystems und des virtuellen Computers mit einem plattformverwalteten Schlüssel an.
ConfidentialVM_DiskEncryptedWithCustomerKey	Gibt den datenträger vertraulichen virtuellen Computer mit verschlüsseltem Gaststatus des Betriebssystems und des virtuellen Computers mit einem vom Kunden verwalteten Schlüssel an.
ConfidentialVM_NonPersistedTPM	Gibt den datenträger vertraulichen virtuellen Computer mit einem kurzlebigen vTPM an. Der vTPM-Zustand wird nicht über VM-Neustarts hinweg beibehalten.

Encryption

Objekt

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

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

EncryptionType

Enumeration

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

Wert	Beschreibung
EncryptionAtRestWithPlatformKey	Der Ruhedatenträger wird mit verwaltetem Plattformschlüssel verschlüsselt. Es ist der Standardverschlüsselungstyp. Dies ist kein gültiger Verschlüsselungstyp für Datenträgerverschlüsselungssätze.
EncryptionAtRestWithCustomerKey	Der Ruhedatenträger wird mit dem vom Kunden verwalteten Schlüssel verschlüsselt, der von einem Kunden geändert und widerrufen werden kann.
EncryptionAtRestWithPlatformAndCustomerKeys	Der Datenträger wird im Ruhezustand mit 2 Verschlüsselungsebenen verschlüsselt. Einer der Schlüssel ist vom Kunden verwaltet, und der andere Schlüssel wird plattformverwaltet.

HyperVGeneration

Enumeration

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

Wert	Beschreibung
V1
V2

InnerError

Objekt

Innere Fehlerdetails.

Name	Typ	Beschreibung
errordetail	string	Die interne Fehlermeldung oder der Ausnahmedump.
exceptiontype	string	Der Ausnahmetyp.

NetworkAccessPolicy

Enumeration

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

Wert	Beschreibung
AllowAll	Der Datenträger kann aus einem beliebigen Netzwerk exportiert oder hochgeladen werden.
AllowPrivate	Der Datenträger kann exportiert oder in die privaten Endpunkte einer DiskAccess-Ressource hochgeladen werden.
DenyAll	Der Datenträger kann nicht exportiert werden.

OperatingSystemTypes

Enumeration

Der Betriebssystemtyp.

Wert	Beschreibung
Windows
Linux

PublicNetworkAccess

Enumeration

Richtlinie zum Steuern des Exports auf dem Datenträger.

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

SnapshotAccessState

Enumeration

Der Status des Snapshots, der die Zugriffsverfügbarkeit des Snapshots bestimmt.

Wert	Beschreibung
Unknown	Standardwert.
Pending	Der Snapshot kann nicht zum Wiederherstellen, Kopieren oder Herunterladen in den Offline-Modus verwendet werden.
Available	Der Snapshot kann zum Wiederherstellen, Kopieren in eine andere Region und zum Herunterladen in den Offlinemodus verwendet werden.
InstantAccess	Der Snapshot kann für die Wiederherstellung von Festplatten mit hoher Leistung verwendet werden, kann jedoch nicht kopiert oder heruntergeladen werden.
AvailableWithInstantAccess	Der Snapshot kann zum Wiederherstellen von Festplatten mit hoher Leistung verwendet werden, die kopiert und heruntergeladen werden.

SupportedCapabilities

Objekt

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

Name	Typ	Beschreibung
acceleratedNetwork	boolean	True, wenn das Image, von dem der Betriebssystemdatenträger erstellt wird, beschleunigte Netzwerke unterstützt.
architecture	Architecture	Cpu-Architektur, die von einem Betriebssystemdatenträger unterstützt wird.
diskControllerTypes	string	Die Datenträgercontroller, die ein Betriebssystemdatenträger unterstützt. Bei Festlegung kann es sich um SCSI oder SCSI, NVME oder NVME, SCSI, sein.
supportedSecurityOption	SupportedSecurityOption	Bezieht sich auf die Sicherheitsfunktion des Datenträgers, die zum Erstellen eines vertrauenswürdigen Starts oder einer vertraulichen VM unterstützt wird

SupportedSecurityOption

Enumeration

Bezieht sich auf die Sicherheitsfunktion des Datenträgers, die zum Erstellen eines vertrauenswürdigen Starts oder einer vertraulichen VM unterstützt wird

Wert	Beschreibung
TrustedLaunchSupported	Der Datenträger unterstützt das Erstellen von vertrauenswürdigen Start-VMs.
TrustedLaunchAndConfidentialVMSupported	Der Datenträger unterstützt das Erstellen von vertrauenswürdigen und vertraulichen VMs.

systemData

Objekt

Metadaten zur Erstellung und letzten Änderung der Ressource.

Name	Typ	Beschreibung
createdAt	string (date-time)	Der Zeitstempel der Ressourcenerstellung (UTC).
createdBy	string	Die Identität, die die Ressource erstellt hat.
createdByType	createdByType	Der Identitätstyp, der die Ressource erstellt hat.
lastModifiedAt	string (date-time)	Der Zeitstempel der letzten Änderung der Ressource (UTC)
lastModifiedBy	string	Die Identität, die die Ressource zuletzt geändert hat.
lastModifiedByType	createdByType	Der Identitätstyp, der die Ressource zuletzt geändert hat.