Disk Restore Point - Get

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=2023-10-02

URI-Parameter

Name In Erforderlich Typ Beschreibung
diskRestorePointName
path True

string

Der Name des erstellten Datenträgerwiederherstellungspunkts.

resourceGroupName
path True

string

Der Name der Ressourcengruppe.

restorePointCollectionName
path True

string

Der Name der Wiederherstellungspunktsammlung, zu der der Datenträgerwiederherstellungspunkt gehört.

subscriptionId
path True

string

Abonnementanmeldeinformationen, die das Microsoft Azure-Abonnement eindeutig identifizieren. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

vmRestorePointName
path True

string

Der Name des VM-Wiederherstellungspunkts, zu dem der Datenträgerwiederherstellungspunkt gehört.

api-version
query True

string

Client-API-Version.

Antworten

Name Typ Beschreibung
200 OK

DiskRestorePoint

OK

Other Status Codes

CloudError

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

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

Get an incremental disk restorePoint resource.

Sample Request

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=2023-10-02

Sample Response

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

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

Sample Request

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=2023-10-02

Sample Response

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

Definitionen

Name Beschreibung
ApiError

API-Fehler.

ApiErrorBase

API-Fehlerbasis.

Architecture

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

CloudError

Eine Fehlerantwort des Computediensts.

DiskRestorePoint

Eigenschaften des Datenträgerwiederherstellungspunkts

DiskSecurityProfile

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

DiskSecurityTypes

Gibt den SecurityType des virtuellen Computers an. Gilt nur für Betriebssystemdatenträger.

Encryption

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

EncryptionType

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

HyperVGeneration

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

InnerError

Details zu inneren Fehlern.

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.

PurchasePlan

Wird verwendet, um den Kaufkontext eines beliebigen Drittanbieterartefakts über MarketPlace festzulegen.

SupportedCapabilities

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

ApiError

API-Fehler.

Name Typ Beschreibung
code

string

Der Fehlercode.

details

ApiErrorBase[]

Details zu API-Fehlern

innererror

InnerError

Innerer API-Fehler

message

string

Die Fehlermeldung.

target

string

Das Ziel des bestimmten Fehlers.

ApiErrorBase

API-Fehlerbasis.

Name Typ Beschreibung
code

string

Der Fehlercode.

message

string

Die Fehlermeldung.

target

string

Das Ziel des bestimmten Fehlers.

Architecture

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

Name Typ Beschreibung
Arm64

string

x64

string

CloudError

Eine Fehlerantwort des Computediensts.

Name Typ Beschreibung
error

ApiError

API-Fehler.

DiskRestorePoint

Eigenschaften des Datenträgerwiederherstellungspunkts

Name Typ Beschreibung
id

string

Ressourcen-ID

name

string

Ressourcenname

properties.completionPercent

number

Prozentsatz abgeschlossen für die Hintergrundkopie des Datenträgerwiederherstellungspunkts, wenn die Quellressource aus einer anderen Region stammt.

properties.diskAccessId

string

ARM-ID der DiskAccess-Ressource für die Verwendung privater Endpunkte auf Datenträgern.

properties.encryption

Encryption

Die Verschlüsselungseigenschaft kann verwendet werden, um ruhende Daten mit kundenseitig oder plattformseitig verwalteten Schlüsseln zu verschlüsseln.

properties.familyId

string

ID der MIS-Familie der hinteren Momentaufnahme

properties.hyperVGeneration

HyperVGeneration

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

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

PurchasePlan

Kaufplaninformationen für das Image, aus 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.sourceResourceId

string

Arm-ID des Quelldatenträgers oder Quelldatenträgerwiederherstellungspunkts.

properties.sourceResourceLocation

string

Speicherort des Quelldatenträgers oder des Wiederherstellungspunkts des Quelldatenträgers, wenn die Quellressource aus einer anderen Region stammt.

properties.sourceUniqueId

string

eindeutige Inkarnations-ID des Quelldatenträgers

properties.supportedCapabilities

SupportedCapabilities

Liste der unterstützten Funktionen für das Image, aus 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

Der Zeitstempel der RestorePoint-Erstellung

type

string

Ressourcentyp

DiskSecurityProfile

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

Name Typ Beschreibung
secureVMDiskEncryptionSetId

string

ResourceId der Datenträgerverschlüsselungsgruppe, die mit einem vom Kunden verwalteten Schlüssel verschlüsselten vertraulichen VM-Datenträgern zugeordnet ist

securityType

DiskSecurityTypes

Gibt den SecurityType des virtuellen Computers an. Gilt nur für Betriebssystemdatenträger.

DiskSecurityTypes

Gibt den SecurityType des virtuellen Computers an. Gilt nur für Betriebssystemdatenträger.

Name Typ Beschreibung
ConfidentialVM_DiskEncryptedWithCustomerKey

string

Gibt einen vertraulichen VM-Datenträger mit Betriebssystemdatenträger und VM-Gaststatus an, der mit einem vom Kunden verwalteten Schlüssel verschlüsselt ist.

ConfidentialVM_DiskEncryptedWithPlatformKey

string

Gibt einen vertraulichen VM-Datenträger mit Betriebssystemdatenträger und VM-Gaststatus an, der mit einem plattformseitig verwalteten Schlüssel verschlüsselt ist.

ConfidentialVM_NonPersistedTPM

string

Gibt einen vertraulichen VM-Datenträger mit einer kurzlebigen vTPM an. Der vTPM-Zustand wird nicht über VM-Neustarts hinweg beibehalten.

ConfidentialVM_VMGuestStateOnlyEncryptedWithPlatformKey

string

Gibt einen vertraulichen VM-Datenträger mit nur verschlüsseltem VM-Gaststatus an.

TrustedLaunch

string

Der vertrauenswürdige Start bietet Sicherheitsfeatures wie den sicheren Start und das virtuelle Trusted Platform Module (vTPM).

Encryption

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

Name Typ Beschreibung
diskEncryptionSetId

string

ResourceId des Datenträgerverschlüsselungssatzes, der zum Aktivieren der Verschlüsselung ruhender Daten verwendet werden soll.

type

EncryptionType

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

EncryptionType

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

Name Typ Beschreibung
EncryptionAtRestWithCustomerKey

string

Der Datenträger wird im Ruhezustand mit einem vom Kunden verwalteten Schlüssel verschlüsselt, der von einem Kunden geändert und widerrufen werden kann.

EncryptionAtRestWithPlatformAndCustomerKeys

string

Der Datenträger wird im Ruhezustand mit zwei Verschlüsselungsebenen verschlüsselt. Einer der Schlüssel ist vom Kunden verwaltet, und der andere Schlüssel ist plattformseitig verwaltet.

EncryptionAtRestWithPlatformKey

string

Der Datenträger wird im Ruhezustand mit dem von der Plattform verwalteten Schlüssel verschlüsselt. Dies ist der Standardverschlüsselungstyp. Dies ist kein gültiger Verschlüsselungstyp für Datenträgerverschlüsselungsgruppen.

HyperVGeneration

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

Name Typ Beschreibung
V1

string

V2

string

InnerError

Details zu inneren Fehlern.

Name Typ Beschreibung
errordetail

string

Die interne Fehlermeldung oder das Ausnahmeabbild.

exceptiontype

string

Der Ausnahmetyp.

NetworkAccessPolicy

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

Name Typ Beschreibung
AllowAll

string

Der Datenträger kann aus einem beliebigen Netzwerk exportiert oder hochgeladen werden.

AllowPrivate

string

Der Datenträger kann mithilfe der privaten Endpunkte einer DiskAccess-Ressource exportiert oder in hochgeladen werden.

DenyAll

string

Der Datenträger kann nicht exportiert werden.

OperatingSystemTypes

Der Betriebssystemtyp.

Name Typ Beschreibung
Linux

string

Windows

string

PublicNetworkAccess

Richtlinie zum Steuern des Exports auf dem Datenträger.

Name Typ Beschreibung
Disabled

string

Sie können nicht öffentlich im Internet auf die zugrunde liegenden Daten des Datenträgers zugreifen, selbst 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.

Enabled

string

Sie können einen SAS-URI generieren, um öffentlich im Internet auf die zugrunde liegenden Daten des Datenträgers 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.

PurchasePlan

Wird verwendet, um den Kaufkontext eines beliebigen Drittanbieterartefakts über MarketPlace festzulegen.

Name Typ Beschreibung
name

string

Die Plan-ID.

product

string

Gibt das Produkt des Images aus dem Marketplace an. Dies ist der gleiche Wert wie Offer unter dem imageReference-Element.

promotionCode

string

Der Angebotsprostufungscode.

publisher

string

Die Herausgeber-ID.

SupportedCapabilities

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

Name Typ Beschreibung
acceleratedNetwork

boolean

True, wenn das Image, aus dem der Betriebssystemdatenträger erstellt wird, den beschleunigten Netzwerkbetrieb unterstützt.

architecture

Architecture

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

diskControllerTypes

string

Die Datenträgercontroller, die von einem Betriebssystemdatenträger unterstützt werden. Wenn festgelegt, kann es SCSI oder SCSI, NVME oder NVME, SCSI sein.