Fetch Cross Region Restore Job - Get

Dienst:: Data Protection

API-Version:: 2025-07-01

Ruft den regionsübergreifenden Wiederherstellungsauftrag ab.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataProtection/locations/{location}/fetchCrossRegionRestoreJob?api-version=2025-07-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
location	path	True	string minLength: 1	Der Name der Azure-Region.
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.
api-version	query	True	string minLength: 1	Die API-Version, die für diesen Vorgang verwendet werden soll.

Anforderungstext

Name	Erforderlich	Typ
jobId	True	string
sourceBackupVaultId	True	string
sourceRegion	True	string

Antworten

Name	Typ	Beschreibung
200 OK	AzureBackupJobResource	Details zu einem regionsübergreifenden Wiederherstellungsauftrag
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

Get Cross Region Restore Job

Beispielanforderung

HTTP

POST https://management.azure.com/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/BugBash1/providers/Microsoft.DataProtection/locations/west us/fetchCrossRegionRestoreJob?api-version=2025-07-01

{
  "sourceRegion": "east us",
  "sourceBackupVaultId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/BugBash1/providers/Microsoft.DataProtection/backupVaults/BugBashVaultForCCYv11",
  "jobId": "3c60cb49-63e8-4b21-b9bd-26277b3fdfae"
}

Beispiel für eine Antwort

Statuscode:: 200

{
  "properties": {
    "activityID": "c4344fb4-7c11-43a4-8307-7ae7c7fb09b9",
    "subscriptionId": "62b829ee-7936-40c9-a1c9-47a93f9f3965",
    "backupInstanceId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/BugBash1/providers/Microsoft.DataProtection/backupVaults/BugBashVaultForCCYv11/backupInstances/28460a9d-707a-45f3-ace6-b16284c2900e",
    "policyId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/BugBash1/providers/Microsoft.DataProtection/backupVaults/BugBashVaultForCCYv11/backupPolicies/jakavetdailypolicy",
    "dataSourceId": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/DppPostgresTestingCcy/providers/Microsoft.DBforPostgreSQL/servers/mabtestingccybasicv11/databases/bugbashdb2",
    "vaultName": "BugBashVaultForCCYv11",
    "backupInstanceFriendlyName": "mabtestingccybasicv11\\bugbashdb2",
    "policyName": "jakavetdailypolicy",
    "sourceResourceGroup": "DppPostgresTestingCcy",
    "dataSourceSetName": "mabtestingccybasicv11",
    "dataSourceName": "bugbashdb2",
    "progressEnabled": false,
    "sourceSubscriptionID": "62b829ee-7936-40c9-a1c9-47a93f9f3965",
    "startTime": "2021-03-17T03:00:03.7604146Z",
    "dataSourceType": "Microsoft.DBforPostgreSQL/servers/databases",
    "operationCategory": "Backup",
    "operation": "Backup",
    "status": "Started",
    "isUserTriggered": false,
    "supportedActions": [],
    "duration": "00:00:00",
    "dataSourceLocation": "east us",
    "extendedInfo": {
      "subTasks": [
        {
          "taskId": 1,
          "taskName": "Trigger Backup",
          "taskStatus": "Started"
        }
      ],
      "additionalDetails": {
        "RetentionTag": "Default",
        "PolicyRuleName": "BackupWeekly",
        "TaskId": "c4344fb4-7c11-43a4-8307-7ae7c7fb09b9"
      }
    }
  },
  "id": "/subscriptions/62b829ee-7936-40c9-a1c9-47a93f9f3965/resourceGroups/BugBash1/providers/Microsoft.DataProtection/Backupvaults/BugBashVaultForCCYv11/backupJobs/3c60cb49-63e8-4b21-b9bd-26277b3fdfae",
  "name": "3c60cb49-63e8-4b21-b9bd-26277b3fdfae",
  "type": "Microsoft.DataProtection/Backupvaults/backupJobs"
}

Definitionen

Name	Beschreibung
AzureBackupJob	AzureBackup-Auftragsklasse
AzureBackupJobResource	AzureBackup-Auftragsressourcenklasse
CloudError	CloudFehler
createdByType	Der Identitätstyp, der die Ressource erstellt hat.
CrossRegionRestoreJobRequest	Details des abzurufenden CRR-Auftrags
Error	Die Fehlerantwort für die Ressourcenverwaltung.
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
InnerError	InnerError
JobExtendedInfo	Erweiterte Informationen zum Auftrag
JobSubTask	Details der Unteraufgabe "Auftrag"
RestoreJobRecoveryPointDetails
systemData	Metadaten zur Erstellung und letzten Änderung der Ressource.
UserFacingError	Fehlerobjekt, das von Layern verwendet wird, die Zugriff auf lokalisierte Inhalte haben und dies an den Benutzer weitergeben
UserFacingWarningDetail	Warnungsobjekt, das von Ebenen verwendet wird, die Zugriff auf lokalisierte Inhalte haben und diese an den Benutzer weitergeben

AzureBackupJob

Objekt

AzureBackup-Auftragsklasse

Name	Typ	Beschreibung
activityID	string	Auftragsaktivitäts-ID
backupInstanceFriendlyName	string	Name der Sicherungsinstanz
backupInstanceId	string	ARM-ID der Sicherungsinstanz
dataSourceId	string	ARM-ID der Datenquelle
dataSourceLocation	string	Speicherort der Datenquelle
dataSourceName	string	Benutzerfreundlicher Name der Datenquelle
dataSourceSetName	string	Datenquellensatzname der Datenquelle
dataSourceType	string	Datentyp der Datenquelle
destinationDataStoreName	string
duration	string	Gesamtlaufzeit des Auftrags. Die Angabe erfolgt im ISO 8601-Format.
endTime	string (date-time)	EndTime des Auftrags(in UTC)
errorDetails	UserFacingError[]	Eine Liste, in der die Fehler im Zusammenhang mit dem Auftrag beschrieben werden
etag	string
extendedInfo	JobExtendedInfo	Erweiterte Informationen zum Auftrag
isUserTriggered	boolean	Gibt an, ob der Auftrag adhoc(true) oder geplant(false) ist.
operation	string	Er gibt den Typ des Auftrags an, d. h. Backup:full/log/diff ; Wiederherstellen:ALR/OLR; Tiering:Backup/Archive ; Verwaltung:ConfigureProtection/UnConfigure
operationCategory	string	Er gibt den Typ des Auftrags an, d. h. Sicherung/Wiederherstellung/Tiering/Verwaltung
policyId	string	ARM-ID der Richtlinie
policyName	string	Name der Richtlinie
progressEnabled	boolean	Gibt an, ob der Status für den Auftrag aktiviert ist.
progressUrl	string	URL, die den Fortschritt des Auftrags enthält
rehydrationPriority	string	Priorität, die für die Rehydratation verwendet werden soll
restoreType	string	Er gibt den Untertyp des Vorgangs an, d. h. im Falle der Wiederherstellung kann es ALR/OLR sein.
sourceDataStoreName	string
sourceResourceGroup	string	Ressourcengruppenname der Datenquelle
sourceSubscriptionID	string	SubscriptionId, die der DataSource entspricht
startTime	string (date-time)	StartTime des Auftrags(in UTC)
status	string	Status des Auftrags wie "InProgress/Completed/Failed/Cancelled/CompletedWithWarnings/Cancelling/Paused"
subscriptionId	string	Abonnement-ID des entsprechenden Sicherungstresors
supportedActions	string[]	Liste der unterstützten Aktionen
vaultName	string	Name des Tresors

AzureBackupJobResource

Objekt

AzureBackup-Auftragsressourcenklasse

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	AzureBackupJob	AzureBackupJobResource-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/...

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

CrossRegionRestoreJobRequest

Objekt

Details des abzurufenden CRR-Auftrags

Name	Typ	Beschreibung
jobId	string
sourceBackupVaultId	string
sourceRegion	string

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.

InnerError

Objekt

InnerError

Name	Typ	Beschreibung
additionalInfo	object	Alle Schlüsselwertpaare, die dem Client zur Verfügung gestellt werden können, um weitere ausführliche Informationen zu erhalten.
code	string	Eindeutiger Code für diesen Fehler
embeddedInnerError	InnerError	InnerError Untergeordneter innerer Fehler, um die Schachtelung zuzulassen.

JobExtendedInfo

Objekt

Erweiterte Informationen zum Auftrag

Name	Typ	Beschreibung
additionalDetails	object	Zusätzliche Details des Auftrags
backupInstanceState	string	Status der Sicherungsinstanz
dataTransferredInBytes	number (double)	Anzahl der übertragenen Bytes
recoveryDestination	string	Ziel, an dem die Wiederherstellung abgeschlossen ist
sourceRecoverPoint	RestoreJobRecoveryPointDetails	Details des Quellwiederherstellungspunkts
subTasks	JobSubTask[]	Liste der Unteraufgaben des Auftrags
targetRecoverPoint	RestoreJobRecoveryPointDetails	Details des Zielwiederherstellungspunkts
warningDetails	UserFacingWarningDetail[]	Eine Liste, in der die Warnungen im Zusammenhang mit dem Auftrag beschrieben werden

JobSubTask

Objekt

Details der Unteraufgabe "Auftrag"

Name	Typ	Beschreibung
additionalDetails	object	Weitere Details zu Unteraufgaben
taskId	integer (int32)	Vorgangs-ID des Untervorgangs
taskName	string	Name des Untervorgangs
taskProgress	string	Fortschritt des Untervorgangs
taskStatus	string	Status des Untervorgangs

RestoreJobRecoveryPointDetails

Objekt

Name	Typ	Beschreibung
recoveryPointID	string
recoveryPointTime	string (date-time)

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.

UserFacingError

Objekt

Fehlerobjekt, das von Layern verwendet wird, die Zugriff auf lokalisierte Inhalte haben und dies an den Benutzer weitergeben

Name	Typ	Beschreibung
code	string	Eindeutiger Code für diesen Fehler
details	UserFacingError[]	Weitere verwandte Fehler
innerError	InnerError	InnerError Innerer Fehler
isRetryable	boolean	Gibt an, ob der Vorgang erneut ausgeführt werden kann oder nicht.
isUserError	boolean	Gibt an, ob der Vorgang auf einen Benutzerfehler oder Dienstfehler zurückzuführen ist.
message	string
properties	object	Alle Schlüsselwertpaare, die innerhalb des Fehlerobjekts eingefügt werden können
recommendedAction	string[]	RecommendedAction lokalisiert.
target	string	Das Ziel des Fehlers.

UserFacingWarningDetail

Objekt

Warnungsobjekt, das von Ebenen verwendet wird, die Zugriff auf lokalisierte Inhalte haben und diese an den Benutzer weitergeben

Name	Typ	Beschreibung
resourceName	string	Name der Ressource, für die warnung ausgelöst wird.
warning	UserFacingError	Fehlerdetails für die Warnung.

Freigeben über

Fetch Cross Region Restore Job - Get

URI-Parameter

Anforderungstext

Antworten

Sicherheit

azure_auth

Bereiche

Beispiele

Get Cross Region Restore Job

Beispielanforderung

Beispiel für eine Antwort

Definitionen

AzureBackupJob

AzureBackupJobResource

CloudError

createdByType

CrossRegionRestoreJobRequest

Error

ErrorAdditionalInfo

InnerError

JobExtendedInfo

JobSubTask

RestoreJobRecoveryPointDetails

systemData

UserFacingError

UserFacingWarningDetail