Recovery Points - List

Dienst:: Data Protection

API-Version:: 2025-07-01

Gibt eine Liste der Wiederherstellungspunkte für eine Datenquelle in einem Tresor zurück.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupInstances/{backupInstanceName}/recoveryPoints?api-version=2025-07-01

Mit optionalen Parametern:

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/backupVaults/{vaultName}/backupInstances/{backupInstanceName}/recoveryPoints?api-version=2025-07-01&$filter={$filter}&$skipToken={$skipToken}

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
backupInstanceName	path	True	string	Der Name der Sicherungsinstanz.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Der Name der Ressourcengruppe. Bei dem Namen wird die Groß-/Kleinschreibung nicht beachtet.
subscriptionId	path	True	string (uuid)	Die ID des Zielabonnements. Der Wert muss eine UUID sein.
vaultName	path	True	string	Der Name des Sicherungstresors.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.
$filter	query		string	OData-Filteroptionen.
$skipToken	query		string	skipToken-Filter.

Antworten

Name	Typ	Beschreibung
200 OK	AzureBackupRecoveryPointResourceList	OKAY
Other Status Codes	CloudError	Fehlerantwort, die beschreibt, warum der Vorgang fehlgeschlagen ist.

Sicherheit

azure_auth

Azure Active Directory OAuth2-Fluss

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

Bereiche

Name	Beschreibung
user_impersonation	identitätswechseln Sie Ihr Benutzerkonto.

Beispiele

List Recovery Points in a Vault

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/000pikumar/providers/Microsoft.DataProtection/backupVaults/PratikPrivatePreviewVault1/backupInstances/testInstance1/recoveryPoints?api-version=2025-07-01

Beispiel für eine Antwort

Statuscode:: 200

{
  "value": [
    {
      "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/HelloTest/providers/Microsoft.DataProtection/backupVaults/HelloTestVault/backupInstances/653213d-c5b3-44f6-a0d9-db3c4f9d8e34/recoveryPoints/7fb2cddd-c5b3-44f6-a0d9-db3c4f9d5f25",
      "name": "7fb2cddd-c5b3-44f6-a0d9-db3c4f9d5e35",
      "type": "microsoft.dataprotection/backupvaults/backupInstances/recoveryPoints",
      "properties": {
        "objectType": "AzureBackupDiscreteRecoveryPoint",
        "recoveryPointTime": "2019-03-01T13:00:00Z",
        "recoveryPointType": "Full",
        "friendlyName": "panbha4",
        "expiryTime": "2023-03-01T13:00:00Z",
        "recoveryPointDataStoresDetails": [
          {
            "id": "0ff03512-b333-4509-a6c7-12164c8b1dce",
            "type": "Snapshot",
            "creationTime": "2019-03-01T13:00:00Z",
            "metaData": "123456"
          },
          {
            "id": "5d8cfd30-722e-4bab-85f6-4a9d01ffc6f1",
            "type": "BackupStorage",
            "creationTime": "2019-03-01T13:00:00Z",
            "metaData": "123456"
          }
        ],
        "recoveryPointState": "Completed"
      }
    },
    {
      "id": "/subscriptions/04cf684a-d41f-4550-9f70-7708a3a2283b/resourceGroups/HelloTest/providers/Microsoft.DataProtection/backupVaults/HelloTestVault/backupInstances/653213d-c5b3-44f6-a0d9-db3c4f9d8e34/recoveryPoints/7fb2cddd-c5b3-44f6-a0d9-db3c4f9d5f25",
      "name": "7fb2cddd-c5b3-44f6-a0d9-db3c4f9d5f25",
      "type": "microsoft.dataprotection/backupvaults/backupInstances/recoveryPoints",
      "properties": {
        "objectType": "AzureBackupDiscreteRecoveryPoint",
        "recoveryPointTime": "2019-03-01T13:00:00Z",
        "recoveryPointType": "Full",
        "friendlyName": "panbha4",
        "recoveryPointDataStoresDetails": [
          {
            "id": "808cfd30-722e-4bab-85f6-4a9d01ffc6f2",
            "type": "Snapshot",
            "creationTime": "2019-03-01T13:00:00Z",
            "metaData": "123456"
          },
          {
            "id": "798cfd30-722e-4bab-85f6-4a9d01ffc6f3",
            "type": "BackupStorage",
            "creationTime": "2019-03-01T13:00:00Z",
            "metaData": "123456"
          }
        ],
        "recoveryPointState": "Completed"
      }
    }
  ]
}

Definitionen

Name	Beschreibung
AzureBackupDiscreteRecoveryPoint	AzureBackupDiscreteRecoveryPoint
AzureBackupRecoveryPointResource	AzureBackupRecoveryPointRessource
AzureBackupRecoveryPointResourceList	AzureBackupRecoveryPointResourceList
CloudError	CloudFehler
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
Error	Die Fehlerantwort für die Ressourcenverwaltung.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
RecoveryPointCompletionState	Gibt die Vollständigkeit des Wiederherstellungspunkts an. Teilweise (d. h., nur einige der vorgesehenen Elemente wurden gesichert) oder abgeschlossen (d. h. ALLE beabsichtigten Elemente wurden gesichert).
RecoveryPointDataStoreDetails	RecoveryPointDataStoreDetails
RehydrationStatus
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.

AzureBackupDiscreteRecoveryPoint

Objekt

AzureBackupDiscreteRecoveryPoint

Name	Typ	Beschreibung
expiryTime	string (date-time)
friendlyName	string
objectType	string: AzureBackupDiscreteRecoveryPoint
policyName	string
policyVersion	string
recoveryPointDataStoresDetails	RecoveryPointDataStoreDetails[]	RecoveryPointDataStoreDetails Details zum RecoveryPoint-Datenspeicher
recoveryPointId	string
recoveryPointState	RecoveryPointCompletionState	Gibt die Vollständigkeit des Wiederherstellungspunkts an. Teilweise (d. h., nur einige der vorgesehenen Elemente wurden gesichert) oder abgeschlossen (d. h. ALLE beabsichtigten Elemente wurden gesichert).
recoveryPointTime	string (date-time)
recoveryPointType	string
retentionTagName	string
retentionTagVersion	string

AzureBackupRecoveryPointResource

Objekt

AzureBackupRecoveryPointRessource

Name	Typ	Beschreibung
id	string	Die Ressourcen-ID stellt den vollständigen Pfad zur Ressource dar.
name	string	Ressourcenname, der der Ressource zugeordnet ist.
properties	AzureBackupRecoveryPoint: AzureBackupDiscreteRecoveryPoint	AzureBackupRecoveryPoint AzureBackupRecoveryPointResource-Eigenschaften
systemData	systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
type	string	Der Ressourcentyp stellt den vollständigen Pfad des Formulars Namespace/ResourceType/ResourceType/...

AzureBackupRecoveryPointResourceList

Objekt

AzureBackupRecoveryPointResourceList

Name	Typ	Beschreibung
nextLink	string	Der URI zum Abrufen der nächsten Seite von Ressourcen. Call ListNext() ruft die nächste Seite von Ressourcen ab.
value	AzureBackupRecoveryPointResource[]	Liste der Ressourcen.

CloudError

Objekt

CloudFehler

Name	Typ	Beschreibung
error	Error	Die Fehlerantwort für die Ressourcenverwaltung.

createdByType

Enumeration

Der Identitätstyp, der die Ressource erstellt hat.

Wert	Beschreibung
Application
Key
ManagedIdentity
User

Error

Objekt

Die Fehlerantwort für die Ressourcenverwaltung.

Name	Typ	Beschreibung
additionalInfo	ErrorAdditionalInfo[]	Die zusätzlichen Informationen des Fehlers.
code	string	Der Fehlercode.
details	Error[]	Die Fehlerdetails.
message	string	Die Fehlermeldung.
target	string	Das Fehlerziel.

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

Name	Typ	Beschreibung
info	object	Die zusätzlichen Informationen.
type	string	Der zusätzliche Informationstyp.

RecoveryPointCompletionState

Enumeration

Gibt die Vollständigkeit des Wiederherstellungspunkts an. Teilweise (d. h., nur einige der vorgesehenen Elemente wurden gesichert) oder abgeschlossen (d. h. ALLE beabsichtigten Elemente wurden gesichert).

Wert	Beschreibung
Completed
Partial

RecoveryPointDataStoreDetails

Objekt

RecoveryPointDataStoreDetails

Name	Typ	Beschreibung
creationTime	string (date-time)
expiryTime	string (date-time)
id	string
metaData	string
rehydrationExpiryTime	string (date-time)
rehydrationStatus	RehydrationStatus
state	string
type	string
visible	boolean

RehydrationStatus

Enumeration

Wert	Beschreibung
COMPLETED
CREATE_IN_PROGRESS
DELETED
DELETE_IN_PROGRESS
FAILED

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.

Freigeben über

Recovery Points - List

URI-Parameter

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

List Recovery Points in a Vault

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AzureBackupDiscreteRecoveryPoint

AzureBackupRecoveryPointResource

AzureBackupRecoveryPointResourceList

CloudError

createdByType

Error

ErrorAdditionalInfo

RecoveryPointCompletionState

RecoveryPointDataStoreDetails

RehydrationStatus

systemData