Sdílet prostřednictvím

Managed Database Restore Details - Get

Služba:
SQL Database
Verze rozhraní API:
2023-08-01

Získá podrobnosti o obnovení spravované databáze.

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

Parametry identifikátoru URI

Name V Vyžadováno Typ Description
databaseName
 path True

string

Název databáze.
managedInstanceName
 path True

string

Název spravované instance.
resourceGroupName
 path True

string

Název skupiny prostředků, která obsahuje prostředek. Tuto hodnotu můžete získat z rozhraní API Azure Resource Manageru nebo portálu.
restoreDetailsName
 path True

RestoreDetailsName

Název podrobností o obnovení, které se mají načíst.
subscriptionId
 path True

string

ID předplatného, které identifikuje předplatné Azure.
api-version
 query True

string

Verze rozhraní API, která se má použít pro požadavek.

Odpovědi

Name Typ Description
200 OK

ManagedDatabaseRestoreDetailsResult

Úspěšně načtené podrobnosti o obnovení.
Other Status Codes

ErrorResponse

Chybové odpovědi: ***

  • 400 RestoreDetailsNotAvailableOrExpired – Požadované podrobnosti o obnovení nejsou k dispozici nebo vypršela platnost.

  • 400 TimeoutDuringRestore – Při pokusu o připojení k cíli obnovení došlo k vypršení časového limitu.

  • 400 AutoCompleteMissingLastBackupName – Požadavek automatického dokončování obnovení musí mít zadaný parametr lastBackupName.

  • 400 MissingThumbprint – Nelze najít certifikát serveru.

  • 400 BlobStorageServerFailure – Došlo k chybě serveru úložiště objektů blob.

  • 400 BackupSetNotFound – nebyly nalezeny žádné zálohy pro obnovení databáze. Pokud chcete databázi obnovit, obraťte se na podporu.

  • 400 FullBackupNotFound – Úplné zálohování nelze najít.

  • 400 RestoreFromStripedBackupsNotEnabled – Obnovení z odstraněných záloh se nepodporuje.

  • 400 BrokenRestorePlanNoFullBackup – Plán obnovení je poškozený, protože neexistuje úplná záloha.

  • 400 BrokenRestorePlanWrongLogBackupLSN – Plán obnovení je poškozený, protože firstLsn aktuálního zálohování protokolu není <= lastLsn dalšího zálohování protokolu.

  • 400 BrokenRestorePlanWrongDiffBackupLSN – Plán obnovení je přerušený, protože plán obnovení není >= firstLsn úplného zálohování.

  • 400 BrokenRestorePlanGapInLogBackups – Plán obnovení je přerušený, protože firstLsn aktuálního zálohování protokolů se nerovná lastLsn zálohy před protokolem.

  • 400 TargetServerDoesNotExist – cílový server {0} neexistuje nebo ještě není připravený. Zkontrolujte, jestli existuje, a zkuste žádost o obnovení zopakovat.

  • 400 TargetServerRestoreNotAllowed – cílový server {0} momentálně není ve stavu, který umožňuje spuštění obnovení.

  • 400 XtpInitializedDuringRestore – Skupina souborů optimalizovaná pro paměť musí být prázdná, aby bylo možné obnovit na úrovni Pro obecné účely spravované instance SQL Database.

  • 400 FullBackupMissingChecksum – Zadané úplné zálohování chybí kontrolní součet.

  • 400 FullBackupDamaged - Poskytnuté úplné zálohování je poškozeno.

  • 400 MissingStripeInBackupSet – Zadaná sada zálohování obsahuje jeden nebo více chybějících pruhů.

  • 400 BackupsFromMultipleDatabasesDetectedInTheContainerWhileRestoreInProgress – Ve složce kontejneru jsou zálohy z více databází. Ujistěte se, že složka kontejneru obsahuje zálohy z jedné databáze.{0}

  • 400 BrokenRestorePlanWrongDiffBaseGUID – Plán obnovení je poškozený, protože rozdílovýbaseGuid rozdílového zálohování neodpovídá BackupSetGuid úplného zálohování.

  • 400 CorruptedPagesInBackupSet – Operace byla přerušena, protože funkce RESTORE zjistila jednu nebo více poškozených stránek v sadě záloh.

  • 400 ManagedIdentityIssueDetectedWhileRestoreInProgress – Spravovaná identita není správně nastavená. Ověřte a zkuste to znovu.

  • 400 CorruptedPagesListMaintenance – operace byla přerušena, protože při zpracování zálohy pořízené bez kontrolního součtu došlo k vnitřní chybě.

  • 400 StorageBrokenIssueDetectedWhileInProgress – Připojení k úložišti je přerušené. Automatické opakování...

  • 400 PartiallyContainedDatabaseUnsupported – Zálohování částečně obsažené databáze není podporováno.

  • 400 RequiredBackupIsNotLastRestored – Migraci nelze dokončit, protože zadaný název záložního souboru není název posledního obnoveného záložního souboru.

  • 400 ManagedInstanceStorageLimitHit – Spravovaná instance dosáhla limitu úložiště.

  • 400 IncompatiblePhysicalLayoutTooFewDataFiles – Zálohování databáze obsahuje nekompatibilní fyzické rozložení. V zálohování nebyly nalezeny žádné datové soubory.

  • 400 IncompatiblePhysicalLayoutNonOnlineDataFilesExist – Záloha databáze obsahuje nekompatibilní fyzické rozložení. Existují jiné než online datové soubory.

  • 400 IncompatiblePhysicalLayoutWrongNumberOfLogFiles – Zálohování databáze obsahuje nekompatibilní fyzické rozložení. Více souborů protokolu není podporováno.

  • 400 IncompatiblePhysicalLayoutNonOnlineLogFilesExist – Zálohování databáze obsahuje nekompatibilní fyzické rozložení. Existují soubory protokolu, které nejsou online.

  • 400 IncompatiblePhysicalLayoutTooManyNonDataLogFiles – Záloha databáze obsahuje nekompatibilní fyzické rozložení. Příliš mnoho souborů, které nejsou data nebo protokoly.

  • 400 ExternalBackupAlreadySignaledToComplete – Žádost o obnovení již byla signalizována k dokončení.

  • 400 ExternalBackupRestoreHasNotBeenStarted – Požadavek na obnovení lze dokončit pouze po spuštění obnovení.

  • 400 ExternalBackupUpgradeInProgress – Požadavek na obnovení nelze dokončit, protože probíhá upgrade.

  • 400 IncompatiblePhysicalLayoutTooManyXTPFiles – Zálohování databáze obsahuje nekompatibilní fyzické rozložení. Ve skupině souborů, která obsahuje MEMORY_OPTIMIZED_DATA, bylo nalezeno více souborů.

  • 400 BlobStorageFailure – Došlo k chybě úložiště objektů blob.

  • 400 BackupsFromMultipleDatabasesDetectedInTheContainerFromTheStart – Ve složce kontejneru jsou zálohy z více databází. Ujistěte se, že složka kontejneru obsahuje zálohy z jedné databáze.{0}

  • 400 ManagedIdentityIssueDetectedFromTheStart – Spravovaná identita není správně nastavená. Ověřte a zkuste to znovu.

  • 400 StorageBrokenIssueDetectedAtTheStart – Připojení k úložišti je přerušeno. Ověřte a zkuste to znovu.

  • 400 StorageBrokenIssueDetectedTerminateRetries – Připojení k úložišti je stále přerušené. Ověřte a zkuste to znovu.

  • 400 BackupSetBroken – Sada zálohování je poškozena.

  • 400 SqlRestoreError – Při obnovování zálohy došlo k neopakovatelné chybě.

  • 400 ManagedDatabaseNotInRestoringState – Spravovaná databáze není ve stavu obnovení.

Příklady

Managed database restore details.

Ukázkový požadavek

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

Ukázková odpověď

Stavový kód:
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"
}

Definice

Name Description
ErrorAdditionalInfo

Další informace o chybě správy prostředků
ErrorDetail

Podrobnosti o chybě.
ErrorResponse

Chybová odpověď
ManagedDatabaseRestoreDetailsBackupSetProperties

Vlastnosti sady zálohované zálohy spravované databáze.
ManagedDatabaseRestoreDetailsResult

Podrobnosti o obnovení spravované databáze.
ManagedDatabaseRestoreDetailsUnrestorableFileProperties

Podrobnosti o obnovení spravované databáze nejsou vyřešitelné vlastnosti souboru.
RestoreDetailsName

Název podrobností o obnovení, které se mají načíst.

ErrorAdditionalInfo

Objekt

Další informace o chybě správy prostředků

Name Typ Description
info

object

Další informace.
type

string

Další typ informací.

ErrorDetail

Objekt

Podrobnosti o chybě.

Name Typ Description
additionalInfo

ErrorAdditionalInfo[]

Další informace o chybě.
code

string

Kód chyby.
details

ErrorDetail[]

Podrobnosti o chybě.
message

string

Chybová zpráva.
target

string

Cíl chyby.

ErrorResponse

Objekt

Chybová odpověď

Name Typ Description
error

ErrorDetail

Objekt chyby.

ManagedDatabaseRestoreDetailsBackupSetProperties

Objekt

Vlastnosti sady zálohované zálohy spravované databáze.

Name Typ Description
backupSizeMB

integer (int32)

Velikost zálohy.
firstStripeName

string

Jméno prvního pruhu.
numberOfStripes

integer (int32)

Počet pruhů
restoreFinishedTimestampUtc

string (date-time)

Čas posledního obnovení souboru
restoreStartedTimestampUtc

string (date-time)

Čas posledního obnovení souboru
status

string

Stav sady záloh.

ManagedDatabaseRestoreDetailsResult

Objekt

Podrobnosti o obnovení spravované databáze.

Name Typ Description
id

string

ID prostředku.
name

string

Název prostředku
properties.blockReason

string

Důvod, proč je obnovení ve stavu Blokováno
properties.currentBackupType

string

Aktuální typ zálohování.
properties.currentRestorePlanSizeMB

integer (int32)

Aktuální velikost plánu obnovení MB.
properties.currentRestoredSizeMB

integer (int32)

Aktuální obnovená velikost MB.
properties.currentRestoringFileName

string

Aktuální název obnovujícího souboru.
properties.diffBackupSets

ManagedDatabaseRestoreDetailsBackupSetProperties[]

Rozdílové sady zálohování
properties.fullBackupSets

ManagedDatabaseRestoreDetailsBackupSetProperties[]

Úplné sady zálohování.
properties.lastRestoredFileName

string

Naposledy obnovený název souboru.
properties.lastRestoredFileTime

string (date-time)

Čas posledního obnovení souboru
properties.lastUploadedFileName

string

Název naposledy nahraného souboru.
properties.lastUploadedFileTime

string (date-time)

Čas posledního nahrání souboru
properties.logBackupSets

ManagedDatabaseRestoreDetailsBackupSetProperties[]

Sady zálohování protokolů.
properties.numberOfFilesDetected

integer (int32)

Počet zjištěných souborů
properties.numberOfFilesQueued

integer (int32)

Počet souborů zařazených do fronty
properties.numberOfFilesRestored

integer (int32)

Počet obnovených souborů
properties.numberOfFilesRestoring

integer (int32)

Počet obnovovaných souborů
properties.numberOfFilesSkipped

integer (int32)

Počet přeskočených souborů
properties.numberOfFilesUnrestorable

integer (int32)

Počet souborů, které se nedají upravit.
properties.percentCompleted

integer (int32)

Procento dokončeno.
properties.status

string

Stav obnovení
properties.type

string

Typ obnovení
properties.unrestorableFiles

ManagedDatabaseRestoreDetailsUnrestorableFileProperties[]

Soubory, které se nedají upravit.
type

string

Typ prostředku.

ManagedDatabaseRestoreDetailsUnrestorableFileProperties

Objekt

Podrobnosti o obnovení spravované databáze nejsou vyřešitelné vlastnosti souboru.

Name Typ Description
name

string

Název souboru

RestoreDetailsName

Výčet

Název podrobností o obnovení, které se mají načíst.

Hodnota Description
Default