Managed Database Restore Details - Get

Tjänst:

SQL Database

API-version:

2023-08-01

Hämtar information om återställning av hanterade databaser.

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

URI-parametrar

Name	I	Obligatorisk	Typ	Description
databaseName	path	True	string	Namnet på databasen.
managedInstanceName	path	True	string	Namnet på den hanterade instansen.
resourceGroupName	path	True	string	Namnet på resursgruppen som innehåller resursen. Du kan hämta det här värdet från Azure Resource Manager-API:et eller portalen.
restoreDetailsName	path	True	RestoreDetailsName	Namnet på återställningsinformationen som ska hämtas.
subscriptionId	path	True	string	Det prenumerations-ID som identifierar en Azure-prenumeration.
api-version	query	True	string	DEN API-version som ska användas för begäran.

Svar

Name	Typ	Description
200 OK	ManagedDatabaseRestoreDetailsResult	Återställningsinformationen har hämtats.
Other Status Codes	ErrorResponse	Felsvar: *** 400 RestoreDetailsNotAvailableOrExpired – Begärd återställningsinformation är inte tillgänglig eller har upphört att gälla. 400 TimeoutDuringRestore – En timeout påträffades när du försökte ansluta till återställningsmålet. 400 AutoCompleteMissingLastBackupName – Begäran om automatisk fullständig återställning måste ha parametern lastBackupName angiven. 400 MissingThumbprint – Det går inte att hitta servercertifikatet. 400 BlobStorageServerFailure – bloblagringsserverfel har inträffat. 400 BackupSetNotFound – Inga säkerhetskopior hittades för att återställa databasen. Kontakta supporten för att återställa databasen. 400 FullBackupNotFound – Fullständig säkerhetskopiering kan inte hittas. 400 RestoreFromStripedBackupsNotEnabled – Återställning från randiga säkerhetskopior stöds inte. 400 BrokenRestorePlanNoFullBackup – Återställningsplanen är bruten eftersom det inte finns någon fullständig säkerhetskopiering. 400 BrokenRestorePlanWrongLogBackupLSN – Återställningsplanen bryts eftersom firstLsn för den aktuella loggsäkerhetskopian inte är <= lastLsn för nästa loggsäkerhetskopia. 400 BrokenRestorePlanWrongDiffBackupLSN – Återställningsplanen bryts eftersom firstLsn för diff-säkerhetskopiering inte är >= firstLsn för fullständig säkerhetskopiering. 400 BrokenRestorePlanGapInLogBackups – Återställningsplanen är bruten eftersom firstLsn för den aktuella loggsäkerhetskopian inte är lika med lastLsn för förhandsloggsäkerhetskopiering. 400 TargetServerDoesNotExist – målservern {0} inte finns eller är inte klar än. Kontrollera att den finns och försök igen med återställningsbegäran. 400 TargetServerRestoreNotAllowed – målservern {0} är för närvarande inte i ett tillstånd som tillåter att en återställning startas. 400 XtpInitializedDuringRestore – Minnesoptimerad filgrupp måste vara tom för att kunna återställas på nivån Generell användning i SQL Database Managed Instance. 400 FullBackupMissingChecksum – Den fullständiga säkerhetskopian saknas. 400 FullBackupDamaged – Förutsatt att fullständig säkerhetskopiering är skadad. 400 MissingStripeInBackupSet – Den angivna säkerhetskopieringsuppsättningen har en eller flera ränder som saknas. 400 BackupsFromMultipleDatabasesDetectedInTheContainerWhileRestoreInProgress – Det finns säkerhetskopior från flera databaser i containermappen. Kontrollera att containermappen har säkerhetskopior från en enda databas.{0} 400 BrokenRestorePlanWrongDiffBaseGUID – Återställningsplanen är bruten eftersom DifferentialBaseGuid för diff-säkerhetskopiering inte matchar BackupSetGuid för fullständig säkerhetskopiering. 400 CorruptedPagesInBackupSet – Åtgärden avbröts eftersom RESTORE identifierade en eller flera skadade sidor i säkerhetskopieringsuppsättningen. 400 ManagedIdentityIssueDetectedWhileRestoreInProgress – Hanterad identitet har inte konfigurerats korrekt. Kontrollera och försök igen. 400 CorruptedPagesListMaintenance – Åtgärden avbröts eftersom ett internt fel inträffade när säkerhetskopieringen bearbetades utan kontrollsumma. 400 StorageBrokenIssueDetectedWhileInProgress – Lagringsanslutningen är bruten. Försöker igen automatiskt... 400 PartiallyContainedDatabaseUnsupported – "Säkerhetskopiering för en delvis innesluten databas stöds inte." 400 RequiredBackupIsNotLastRestored – Migreringen kan inte slutföras eftersom det angivna namnet på säkerhetskopieringsfilen inte är namnet på den senaste säkerhetskopieringsfilen som återställdes. 400 ManagedInstanceStorageLimitHit – Den hanterade instansen har nått sin lagringsgräns. 400 IncompatiblePhysicalLayoutTooFewDataFiles – Databassäkerhetskopiering innehåller inkompatibel fysisk layout. Inga datafiler hittades i säkerhetskopian. 400 IncompatiblePhysicalLayoutNonOnlineDataFilesExist – Databassäkerhetskopiering innehåller inkompatibel fysisk layout. Datafiler som inte är online finns. 400 IncompatiblePhysicalLayoutWrongNumberOfLogFiles – Databassäkerhetskopiering innehåller inkompatibel fysisk layout. Flera loggfiler stöds inte. 400 IncompatiblePhysicalLayoutNonOnlineLogFilesExist – Databassäkerhetskopiering innehåller inkompatibel fysisk layout. Loggfiler som inte är online finns. 400 IncompatiblePhysicalLayoutTooManyNonDataLogFiles – Databassäkerhetskopiering innehåller inkompatibel fysisk layout. För många icke-data-/loggfiler. 400 ExternalBackupAlreadySignaledToComplete – Återställningsbegäran har redan signalerats att slutföras. 400 ExternalBackupRestoreHasNotBeenStarted – Återställningsbegäran kan bara slutföras när återställningen har startats. 400 ExternalBackupUpgradeInProgress – Återställningsbegäran kan inte slutföras eftersom uppgradering pågår. 400 IncompatiblePhysicalLayoutTooManyXTPFiles – Databassäkerhetskopiering innehåller inkompatibel fysisk layout. Flera filer hittades i den filgrupp som innehåller MEMORY_OPTIMIZED_DATA. 400 BlobStorageFailure – bloblagringsfel har inträffat. 400 BackupsFromMultipleDatabasesDetectedInTheContainerFromTheStart – Det finns säkerhetskopior från flera databaser i containermappen. Kontrollera att containermappen har säkerhetskopior från en enda databas.{0} 400 ManagedIdentityIssueDetectedFromTheStart – Hanterad identitet har inte konfigurerats korrekt. Kontrollera och försök igen. 400 StorageBrokenIssueDetectedAtTheStart – Lagringsanslutningen är bruten. Kontrollera och försök igen. 400 StorageBrokenIssueDetectedTerminateRetries – Lagringsanslutningen är fortfarande bruten. Kontrollera och försök igen. 400 BackupSetBroken – Säkerhetskopieringsuppsättningen är bruten. 400 SqlRestoreError – Det uppstod ett fel som inte gick att försöka igen när säkerhetskopieringen återställdes. 400 ManagedDatabaseNotInRestoringState – Den hanterade databasen är inte i återställningstillstånd.

Exempel

Managed database restore details.

Exempelbegäran

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

Exempelsvar

Statuskod:

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"
}

Definitioner

Name	Description
ErrorAdditionalInfo	Ytterligare information om resurshanteringsfelet.
ErrorDetail	Felinformationen.
ErrorResponse	Felsvar
ManagedDatabaseRestoreDetailsBackupSetProperties	Egenskaperna för säkerhetskopieringsuppsättningen för den hanterade databasens återställningsinformation.
ManagedDatabaseRestoreDetailsResult	En hanterad databasåterställningsinformation.
ManagedDatabaseRestoreDetailsUnrestorableFileProperties	Den hanterade databasens återställning beskriver obegränsade filegenskaper.
RestoreDetailsName	Namnet på återställningsinformationen som ska hämtas.

ErrorAdditionalInfo

Objekt

Ytterligare information om resurshanteringsfelet.

Name	Typ	Description
info	object	Ytterligare information.
type	string	Ytterligare informationstyp.

ErrorDetail

Objekt

Felinformationen.

Name	Typ	Description
additionalInfo	ErrorAdditionalInfo[]	Ytterligare information om felet.
code	string	Felkoden.
details	ErrorDetail[]	Felinformationen.
message	string	Felmeddelandet.
target	string	Felmålet.

ErrorResponse

Objekt

Felsvar

Name	Typ	Description
error	ErrorDetail	Felobjektet.

ManagedDatabaseRestoreDetailsBackupSetProperties

Objekt

Egenskaperna för säkerhetskopieringsuppsättningen för den hanterade databasens återställningsinformation.

Name	Typ	Description
backupSizeMB	integer (int32)	Säkerhetskopieringsstorlek.
firstStripeName	string	Namn på förband.
numberOfStripes	integer (int32)	Antal ränder.
restoreFinishedTimestampUtc	string (date-time)	Senast återställd filtid.
restoreStartedTimestampUtc	string (date-time)	Senast återställd filtid.
status	string	Status för säkerhetskopieringsuppsättning.

ManagedDatabaseRestoreDetailsResult

Objekt

En hanterad databasåterställningsinformation.

Name	Typ	Description
id	string	Resurs-ID.
name	string	Resursnamn.
properties.blockReason	string	Anledningen till att återställningen är i blockerat tillstånd.
properties.currentBackupType	string	Aktuell typ av säkerhetskopiering.
properties.currentRestorePlanSizeMB	integer (int32)	Aktuell storlek på återställningsplan MB.
properties.currentRestoredSizeMB	integer (int32)	Aktuell återställd storlek MB.
properties.currentRestoringFileName	string	Aktuellt namn på återställning av fil.
properties.diffBackupSets	ManagedDatabaseRestoreDetailsBackupSetProperties[]	Säkerhetskopieringsuppsättningar för Diff.
properties.fullBackupSets	ManagedDatabaseRestoreDetailsBackupSetProperties[]	Fullständiga säkerhetskopieringsuppsättningar.
properties.lastRestoredFileName	string	Senast återställt filnamn.
properties.lastRestoredFileTime	string (date-time)	Senast återställd filtid.
properties.lastUploadedFileName	string	Senast uppladdat filnamn.
properties.lastUploadedFileTime	string (date-time)	Senast uppladdad filtid.
properties.logBackupSets	ManagedDatabaseRestoreDetailsBackupSetProperties[]	Loggsäkerhetskopieringsuppsättningar.
properties.numberOfFilesDetected	integer (int32)	Antal filer som identifierats.
properties.numberOfFilesQueued	integer (int32)	Antal filer i kö.
properties.numberOfFilesRestored	integer (int32)	Antal filer som har återställts.
properties.numberOfFilesRestoring	integer (int32)	Antal filer som återställs.
properties.numberOfFilesSkipped	integer (int32)	Antal filer som hoppas över.
properties.numberOfFilesUnrestorable	integer (int32)	Antal filer som är obegränsade.
properties.percentCompleted	integer (int32)	Procenten har slutförts.
properties.status	string	Återställningsstatus.
properties.type	string	Återställningstyp.
properties.unrestorableFiles	ManagedDatabaseRestoreDetailsUnrestorableFileProperties[]	Obegränsade filer.
type	string	Resurstyp.

ManagedDatabaseRestoreDetailsUnrestorableFileProperties

Objekt

Den hanterade databasens återställning beskriver obegränsade filegenskaper.

Name	Typ	Description
name	string	Filnamn.

RestoreDetailsName

Uppräkning

Namnet på återställningsinformationen som ska hämtas.

Värde	Description
Default