Freigeben über

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

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