Managed Database Restore Details - Get

Dienst:

SQL Database

API-Version:

2023-08-01

Ruft Details zur Wiederherstellung der verwalteten Datenbank ab.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/restoreDetails/Default?api-version=2023-08-01

URI-Parameter

Name	In	Erforderlich	Typ	Beschreibung
databaseName	path	True	string	Der Name der Datenbank.
managedInstanceName	path	True	string	Der Name der verwalteten Instanz.
resourceGroupName	path	True	string	Der Name der Ressourcengruppe, die die Ressource enthält. Sie können diesen Wert aus der Azure Resource Manager-API oder dem Portal abrufen.
restoreDetailsName	path	True	RestoreDetailsName	Der Name der abzurufenden Wiederherstellungsdetails.
subscriptionId	path	True	string	Die Abonnement-ID, die ein Azure-Abonnement identifiziert.
api-version	query	True	string	Die API-Version, die für die Anforderung verwendet werden soll.

Antworten

Name	Typ	Beschreibung
200 OK	ManagedDatabaseRestoreDetailsResult	Wiederherstellungsdetails wurden erfolgreich abgerufen.
Other Status Codes	ErrorResponse	Fehlerantworten: *** 400 RestoreDetailsNotAvailableOrExpired – Angeforderte Wiederherstellungsdetails sind nicht verfügbar oder abgelaufen. 400 TimeoutDuringRestore – Beim Versuch, eine Verbindung mit dem Wiederherstellungsziel herzustellen, wurde ein Timeout gefunden. 400 AutoCompleteMissingLastBackupName – AutoVervollständigen-Wiederherstellungsanforderung muss den parameter lastBackupName angegeben haben. 400 MissingThumbprint - Das Serverzertifikat kann nicht gefunden werden. 400 BlobStorageServerFailure – Blob Storage Server-Fehler aufgetreten. 400 BackupSetNotFound – Es wurden keine Sicherungen gefunden, um die Datenbank wiederherzustellen. Wenden Sie sich an den Support, um die Datenbank wiederherzustellen. 400 FullBackupNotFound – Vollständige Sicherung kann nicht gefunden werden. 400 RestoreFromStripedBackupsNotEnabled – Das Wiederherstellen von striped Backups wird nicht unterstützt. 400 BrokenRestorePlanNoFullBackup – Der Wiederherstellungsplan ist unterbrochen, da keine vollständige Sicherung vorhanden ist. 400 BrokenRestorePlanWrongLogBackupLSN – Der Wiederherstellungsplan ist unterbrochen, da firstLsn der aktuellen Protokollsicherung nicht <= lastLsn der nächsten Protokollsicherung ist. 400 BrokenRestorePlanWrongDiffBackupLSN – Der Wiederherstellungsplan ist unterbrochen, da firstLsn of diff backup nicht >= firstLsn of full backup. 400 BrokenRestorePlanGapInLogBackups – Der Wiederherstellungsplan ist unterbrochen, da firstLsn der aktuellen Protokollsicherung nicht den letztenLsn der vorigen Protokollsicherung entspricht. 400 TargetServerDoesNotExist – Der Zielserver {0} ist nicht vorhanden oder ist noch nicht bereit. Überprüfen Sie, ob sie vorhanden ist, und wiederholen Sie die Wiederherstellungsanforderung. 400 TargetServerRestoreNotAllowed – Der Zielserver {0} befindet sich derzeit nicht in einem Zustand, in dem eine Wiederherstellung gestartet werden kann. 400 XtpInitializedDuringRestore – Speicheroptimierte Dateigruppe muss leer sein, um auf der Ebene "Allgemeiner Zweck" der verwalteten SQL-Datenbankinstanz wiederhergestellt zu werden. 400 FullBackupMissingChecksum – Vorausgesetzt, vollständige Sicherung fehlt prüfsumme. 400 FullBackupDamaged - Bereitgestellte vollständige Sicherung ist beschädigt. 400 MissingStripeInBackupSet – Bereitgestellter Sicherungssatz verfügt über mindestens einen fehlenden Stripes. 400 BackupsFromMultipleDatabasesDetectedInTheContainerWhileRestoreInProgress – Es gibt Sicherungen aus mehreren Datenbanken im Containerordner. Stellen Sie sicher, dass der Containerordner Sicherungen aus einer einzelnen Datenbank enthält.{0} 400 BrokenRestorePlanWrongDiffBaseGUID – Der Wiederherstellungsplan ist unterbrochen, da DifferentialBaseGuid der Diff-Sicherung nicht mit BackupSetGuid der vollständigen Sicherung übereinstimmt. 400 CorruptedPagesInBackupSet – Vorgang wurde abgebrochen, da RESTORE eine oder mehrere beschädigte Seiten im Sicherungssatz erkannt hat. 400 ManagedIdentityIssueDetectedWhileRestoreInProgress – Verwaltete Identität ist nicht ordnungsgemäß eingerichtet. Überprüfen Sie dies, und versuchen Sie es erneut. 400 CorruptedPagesListMaintenance – Der Vorgang wurde abgebrochen, da beim Verarbeiten der Sicherung ohne Prüfsumme ein interner Fehler aufgetreten ist. 400 StorageBrokenIssueDetectedWhileInProgress – Speicherverbindung ist unterbrochen. Automatisches Wiederholen... 400 PartiallyContainedDatabaseUnsupported – "Sicherung für eine teilweise enthaltene Datenbank wird nicht unterstützt." 400 RequiredBackupIsNotLastRestored – Die Migration kann nicht abgeschlossen werden, da der angegebene Sicherungsdateiname nicht der Name der letzten wiederhergestellten Sicherungsdatei ist. 400 ManagedInstanceStorageLimitHit – Die verwaltete Instanz hat ihren Speichergrenzwert erreicht. 400 IncompatiblePhysicalLayoutTooFewDataFiles – Datenbanksicherung enthält inkompatibles physisches Layout. Es wurden keine Datendateien in der Sicherung gefunden. 400 IncompatiblePhysicalLayoutNonOnlineDataFilesExist – Datenbanksicherung enthält inkompatibles physisches Layout. Nicht online verfügbare Datendateien sind vorhanden. 400 IncompatiblePhysicalLayoutWrongNumberOfLogFiles – Datenbanksicherung enthält inkompatibles physisches Layout. Mehrere Protokolldateien werden nicht unterstützt. 400 IncompatiblePhysicalLayoutNonOnlineLogFilesExist – Datenbanksicherung enthält inkompatibles physisches Layout. Nicht online verfügbare Protokolldateien sind vorhanden. 400 IncompatiblePhysicalLayoutTooManyNonDataLogFiles – Datenbanksicherung enthält inkompatibles physisches Layout. Zu viele Nicht-Daten-/Protokolldateien. 400 ExternalBackupAlreadySignaledToComplete – Die Wiederherstellungsanforderung wurde bereits als abgeschlossen signalisiert. 400 ExternalBackupRestoreHasNotBeenStarted – Die Wiederherstellungsanforderung kann nur abgeschlossen werden, nachdem die Wiederherstellung gestartet wurde. 400 ExternalBackupUpgradeInProgress – Die Wiederherstellungsanforderung kann nicht abgeschlossen werden, da das Upgrade ausgeführt wird. 400 IncompatiblePhysicalLayoutTooManyXTPFiles – Datenbanksicherung enthält inkompatibles physisches Layout. Mehrere Dateien in der Dateigruppe gefunden, die MEMORY_OPTIMIZED_DATA enthält. 400 BlobStorageFailure – Blob-Speicherfehler ist aufgetreten. 400 BackupsFromMultipleDatabasesDetectedInTheContainerFromTheStart - Es gibt Sicherungen aus mehreren Datenbanken im Containerordner. Stellen Sie sicher, dass der Containerordner Sicherungen aus einer einzelnen Datenbank enthält.{0} 400 ManagedIdentityIssueDetectedFromTheStart – Verwaltete Identität ist nicht ordnungsgemäß eingerichtet. Überprüfen Sie dies, und versuchen Sie es erneut. 400 StorageBrokenIssueDetectedAtTheStart – Speicherverbindung ist unterbrochen. Überprüfen Sie dies, und versuchen Sie es erneut. 400 StorageBrokenIssueDetectedTerminateRetries – Die Speicherverbindung ist noch unterbrochen. Überprüfen Sie dies, und versuchen Sie es erneut. 400 BackupSetBroken – Sicherungssatz ist unterbrochen. 400 SqlRestoreError – Fehler beim Wiederherstellen der Sicherung ist nicht zu wiederholen. 400 ManagedDatabaseNotInRestoringState – Verwaltete Datenbank befindet sich nicht im Zustand "Wiederherstellen".

Beispiele

Managed database restore details.

Beispielanforderung

HTTP

GET https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/testdb/restoreDetails/Default?api-version=2023-08-01

Beispiel für eine Antwort

Statuscode:

200

{
  "properties": {
    "type": "LRSRestore",
    "status": "Restoring",
    "lastUploadedFileName": "RestoreDetailsFullBlownExampleLog11.bak",
    "lastUploadedFileTime": "2022-03-01T07:54:21Z",
    "lastRestoredFileName": "RestoreDetailsFullBlownExampleLog9_1.bak",
    "lastRestoredFileTime": "2022-05-09T12:27:20.4936305Z",
    "percentCompleted": 53,
    "currentRestoredSizeMB": 25,
    "currentRestorePlanSizeMB": 47,
    "currentBackupType": "Log",
    "currentRestoringFileName": "RestoreDetailsFullBlownExampleLog10.bak",
    "numberOfFilesDetected": 25,
    "numberOfFilesQueued": 1,
    "numberOfFilesSkipped": 8,
    "numberOfFilesRestoring": 1,
    "numberOfFilesRestored": 14,
    "numberOfFilesUnrestorable": 1,
    "fullBackupSets": [
      {
        "status": "Skipped",
        "firstStripeName": "RestoreDetailsFullBlownExampleFull2.bak",
        "numberOfStripes": 1,
        "backupSizeMB": 2
      },
      {
        "status": "Restored",
        "firstStripeName": "RestoreDetailsFullBlownExampleFull3_1.bak",
        "numberOfStripes": 3,
        "backupSizeMB": 3,
        "restoreStartedTimestampUtc": "2022-05-09T12:15:40.3143263Z",
        "restoreFinishedTimestampUtc": "2022-05-09T12:18:41.3785089Z"
      }
    ],
    "diffBackupSets": [
      {
        "status": "Skipped",
        "firstStripeName": "RestoreDetailsFullBlownExampleDiff2.bak",
        "numberOfStripes": 1,
        "backupSizeMB": 0
      },
      {
        "status": "Restored",
        "firstStripeName": "RestoreDetailsFullBlownExampleDiff3_1.bak",
        "numberOfStripes": 3,
        "backupSizeMB": 1,
        "restoreStartedTimestampUtc": "2022-05-09T12:19:40.5455092Z",
        "restoreFinishedTimestampUtc": "2022-05-09T12:20:21.3667454Z"
      }
    ],
    "logBackupSets": [
      {
        "status": "Skipped",
        "firstStripeName": "RestoreDetailsFullBlownExampleLog2.bak",
        "numberOfStripes": 1,
        "backupSizeMB": 0
      },
      {
        "status": "Skipped",
        "firstStripeName": "RestoreDetailsFullBlownExampleLog3.bak",
        "numberOfStripes": 1,
        "backupSizeMB": 8
      },
      {
        "status": "Skipped",
        "firstStripeName": "RestoreDetailsFullBlownExampleLog4.bak",
        "numberOfStripes": 1,
        "backupSizeMB": 11
      },
      {
        "status": "Restored",
        "firstStripeName": "RestoreDetailsFullBlownExampleLog5.bak",
        "numberOfStripes": 1,
        "backupSizeMB": 7,
        "restoreStartedTimestampUtc": "2022-05-09T12:21:01.7717453Z",
        "restoreFinishedTimestampUtc": "2022-05-09T12:21:54.7557851Z"
      },
      {
        "status": "Restored",
        "firstStripeName": "RestoreDetailsFullBlownExampleLog6.bak",
        "numberOfStripes": 1,
        "backupSizeMB": 3,
        "restoreStartedTimestampUtc": "2022-05-09T12:22:41.8784062Z",
        "restoreFinishedTimestampUtc": "2022-05-09T12:23:03.709407Z"
      },
      {
        "status": "Restored",
        "firstStripeName": "RestoreDetailsFullBlownExampleLog7.bak",
        "numberOfStripes": 1,
        "backupSizeMB": 4,
        "restoreStartedTimestampUtc": "2022-05-09T12:23:36.6264066Z",
        "restoreFinishedTimestampUtc": "2022-05-09T12:23:52.9274047Z"
      },
      {
        "status": "Restored",
        "firstStripeName": "RestoreDetailsFullBlownExampleLog8.bak",
        "numberOfStripes": 1,
        "backupSizeMB": 3,
        "restoreStartedTimestampUtc": "2022-05-09T12:24:25.899407Z",
        "restoreFinishedTimestampUtc": "2022-05-09T12:24:37.9954063Z"
      },
      {
        "status": "Restored",
        "firstStripeName": "RestoreDetailsFullBlownExampleLog9_1.bak",
        "numberOfStripes": 4,
        "backupSizeMB": 4,
        "restoreStartedTimestampUtc": "2022-05-09T12:25:10.8804065Z",
        "restoreFinishedTimestampUtc": "2022-05-09T12:25:27.808409Z"
      },
      {
        "status": "Restoring",
        "firstStripeName": "RestoreDetailsFullBlownExampleLog10.bak",
        "numberOfStripes": 1,
        "backupSizeMB": 15,
        "restoreStartedTimestampUtc": "2022-05-09T12:26:00.7813103Z"
      },
      {
        "status": "Queued",
        "firstStripeName": "RestoreDetailsFullBlownExampleLog11.bak",
        "numberOfStripes": 1,
        "backupSizeMB": 7
      }
    ],
    "unrestorableFiles": [
      {
        "name": "ImageFile.JPG"
      }
    ]
  },
  "id": "/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/Default-SQL-SouthEastAsia/providers/Microsoft.Sql/managedInstances/managedInstance/databases/testdb/restoreDetails/current",
  "name": "current",
  "type": "Microsoft.Sql/managedInstances/databases/restoreDetails"
}

Definitionen

Name	Beschreibung
ErrorAdditionalInfo	Der Ressourcenverwaltungsfehler zusätzliche Informationen.
ErrorDetail	Das Fehlerdetails.
ErrorResponse	Fehlerantwort
ManagedDatabaseRestoreDetailsBackupSetProperties	Die Wiederherstellungsdetails der Sicherungssatzeigenschaften der verwalteten Datenbank.
ManagedDatabaseRestoreDetailsResult	Details zur Wiederherstellung einer verwalteten Datenbank.
ManagedDatabaseRestoreDetailsUnrestorableFileProperties	Die Wiederherstellungsdetails der verwalteten Datenbank sind nicht veränderbare Dateieigenschaften.
RestoreDetailsName	Der Name der abzurufenden Wiederherstellungsdetails.

ErrorAdditionalInfo

Objekt

Der Ressourcenverwaltungsfehler zusätzliche Informationen.

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

ErrorDetail

Objekt

Das Fehlerdetails.

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

ErrorResponse

Objekt

Fehlerantwort

Name	Typ	Beschreibung
error	ErrorDetail	Das Fehlerobjekt.

ManagedDatabaseRestoreDetailsBackupSetProperties

Objekt

Die Wiederherstellungsdetails der Sicherungssatzeigenschaften der verwalteten Datenbank.

Name	Typ	Beschreibung
backupSizeMB	integer (int32)	Sicherungsgröße.
firstStripeName	string	Name des ersten Streifens.
numberOfStripes	integer (int32)	Anzahl der Streifen.
restoreFinishedTimestampUtc	string (date-time)	Zuletzt wiederhergestellte Dateizeit.
restoreStartedTimestampUtc	string (date-time)	Zuletzt wiederhergestellte Dateizeit.
status	string	Sicherungssatzstatus.

ManagedDatabaseRestoreDetailsResult

Objekt

Details zur Wiederherstellung einer verwalteten Datenbank.

Name	Typ	Beschreibung
id	string	Ressourcen-ID.
name	string	Ressourcenname.
properties.blockReason	string	Der Grund, warum die Wiederherstellung im Zustand "Blockiert" ist.
properties.currentBackupType	string	Aktueller Sicherungstyp.
properties.currentRestorePlanSizeMB	integer (int32)	Größe des aktuellen Wiederherstellungsplans MB.
properties.currentRestoredSizeMB	integer (int32)	Aktuelle wiederhergestellte Größe MB.
properties.currentRestoringFileName	string	Aktueller Wiederherstellungsdateiname.
properties.diffBackupSets	ManagedDatabaseRestoreDetailsBackupSetProperties[]	Diff-Sicherungssätze.
properties.fullBackupSets	ManagedDatabaseRestoreDetailsBackupSetProperties[]	Vollständige Sicherungssätze.
properties.lastRestoredFileName	string	Zuletzt wiederhergestellter Dateiname.
properties.lastRestoredFileTime	string (date-time)	Zuletzt wiederhergestellte Dateizeit.
properties.lastUploadedFileName	string	Zuletzt hochgeladener Dateiname.
properties.lastUploadedFileTime	string (date-time)	Zuletzt hochgeladene Dateizeit.
properties.logBackupSets	ManagedDatabaseRestoreDetailsBackupSetProperties[]	Protokollsicherungssätze.
properties.numberOfFilesDetected	integer (int32)	Anzahl der erkannten Dateien.
properties.numberOfFilesQueued	integer (int32)	Anzahl der Dateien in der Warteschlange.
properties.numberOfFilesRestored	integer (int32)	Anzahl der wiederhergestellten Dateien.
properties.numberOfFilesRestoring	integer (int32)	Anzahl der Wiederherstellungsdateien.
properties.numberOfFilesSkipped	integer (int32)	Die Anzahl der übersprungenen Dateien.
properties.numberOfFilesUnrestorable	integer (int32)	Anzahl der nicht mehr zu bearbeitbaren Dateien.
properties.percentCompleted	integer (int32)	Prozent abgeschlossen.
properties.status	string	Status wiederherstellen.
properties.type	string	Wiederherstellen des Typs.
properties.unrestorableFiles	ManagedDatabaseRestoreDetailsUnrestorableFileProperties[]	Nicht bearbeitbare Dateien.
type	string	Ressourcentyp.

ManagedDatabaseRestoreDetailsUnrestorableFileProperties

Objekt

Die Wiederherstellungsdetails der verwalteten Datenbank sind nicht veränderbare Dateieigenschaften.

Name	Typ	Beschreibung
name	string	Dateiname.

RestoreDetailsName

Enumeration

Der Name der abzurufenden Wiederherstellungsdetails.

Wert	Beschreibung
Default