Delen via

Managed Database Restore Details - Get

Service:
SQL Database
API-versie:
2023-08-01

Hiermee worden gegevens over het herstellen van beheerde databases opgeslagen.

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

URI-parameters

Name In Vereist Type Description
databaseName
 path True

string

De naam van de database.
managedInstanceName
 path True

string

De naam van het beheerde exemplaar.
resourceGroupName
 path True

string

De naam van de resourcegroep die de resource bevat. U kunt deze waarde verkrijgen via de Azure Resource Manager-API of de portal.
restoreDetailsName
 path True

RestoreDetailsName

De naam van de herstelgegevens die moeten worden opgehaald.
subscriptionId
 path True

string

De abonnements-id waarmee een Azure-abonnement wordt geïdentificeerd.
api-version
 query True

string

De API-versie die moet worden gebruikt voor de aanvraag.

Antwoorden

Name Type Description
200 OK

ManagedDatabaseRestoreDetailsResult

Hersteldetails zijn opgehaald.
Other Status Codes

ErrorResponse

Foutreacties: ***

  • 400 RestoreDetailsNotAvailableOrExpired - Aangevraagde hersteldetails zijn niet beschikbaar of zijn verlopen.

  • 400 TimeoutDuringRestore - Er is een time-out opgetreden tijdens het maken van verbinding met het hersteldoel.

  • 400 AutoCompleteMissingLastBackupName - Aanvraag voor automatisch aanvullen moet de parameter lastBackupName hebben opgegeven.

  • 400 MissingThumbprint - Kan servercertificaat niet vinden.

  • 400 BlobStorageServerFailure - Blob Storage-serverfout is opgetreden.

  • 400 BackupSetNotFound - Er zijn geen back-ups gevonden om de database te herstellen. Neem contact op met de ondersteuning om de database te herstellen.

  • 400 FullBackupNotFound - Volledige back-up kan niet worden gevonden.

  • 400 RestoreFromStripedBackupsNotEnabled - Herstellen vanuit gestreepte back-ups wordt niet ondersteund.

  • 400 BrokenRestorePlanNoFullBackup : het herstelplan is verbroken omdat er geen volledige back-up is.

  • 400 BrokenRestorePlanWrongLogBackupLSN: het herstelplan is verbroken omdat firstLsn van de huidige logboekback-up niet <= lastLsn van volgende logboekback-up.

  • 400 BrokenRestorePlanWrongDiffBackupLSN: het herstelplan is verbroken omdat firstLsn van diff-back-up niet >= firstLsn van volledige back-up.

  • 400 BrokenRestorePlanGapInLogBackups: het herstelplan is verbroken omdat firstLsn van de huidige logboekback-up niet gelijk is aan lastLsn van de vorige logboekback-up.

  • 400 TargetServerDoesNotExist - De doelserver {0} bestaat nog niet of is nog niet gereed. Controleer of deze bestaat en voer de herstelaanvraag opnieuw uit.

  • 400 TargetServerRestoreNotAllowed - De doelserver {0} heeft momenteel geen status waarmee een herstelbewerking kan worden gestart.

  • 400 XtpInitializedDuringRestore : de bestandsgroep die is geoptimaliseerd voor geheugen, moet leeg zijn om te worden hersteld op de laag Algemeen gebruik van sql Database Managed Instance.

  • 400 FullBackupMissingChecksum - Mits volledige back-up ontbreekt controlesom.

  • 400 FullBackupDamaged - Mits volledige back-up beschadigd is.

  • 400 MissingStripeInBackupSet - De back-upset bevat een of meer ontbrekende strepen.

  • 400 BackupsFromMultipleDatabasesDetectedInTheContainerWhileRestoreInProgress - Er zijn back-ups van meerdere databases in de containermap. Zorg ervoor dat de containermap back-ups van één database bevat.{0}

  • 400 BrokenRestorePlanWrongDiffBaseGUID - Het herstelplan is verbroken omdat DifferentBaseGuid van diff-back-up niet overeenkomt met BackupSetGuid van de volledige back-up.

  • 400 CorruptedPagesInBackupSet - Bewerking is afgebroken omdat RESTORE een of meer beschadigde pagina's in de back-upset heeft gedetecteerd.

  • 400 ManagedIdentityIssueDetectedWhileRestoreInProgress - Beheerde identiteit is niet juist ingesteld. Controleer en probeer het opnieuw.

  • 400 CorruptedPagesListMaintenance - Bewerking is afgebroken omdat er een interne fout is opgetreden tijdens het verwerken van de back-up die zonder controlesom is gemaakt.

  • 400 StorageBrokenIssueDetectedWhileInProgress - Opslagverbinding is verbroken. Automatisch opnieuw proberen...

  • 400 GedeeltelijkContainedDatabaseUnsupported - Back-up voor een gedeeltelijk ingesloten database wordt niet ondersteund.

  • 400 RequiredBackupIsNotLastRestored - Migratie kan niet worden voltooid omdat de opgegeven back-upbestandsnaam niet de naam is van het laatste back-upbestand dat is hersteld.

  • 400 ManagedInstanceStorageLimitHit : het beheerde exemplaar heeft de opslaglimiet bereikt.

  • 400 IncompatiblePhysicalLayoutTooFewDataFiles - Databaseback-up bevat incompatibele fysieke indeling. Er zijn geen gegevensbestanden gevonden in de back-up.

  • 400 IncompatiblePhysicalLayoutNonOnlineDataFilesExist - Databaseback-up bevat incompatibele fysieke indeling. Er bestaan niet-online gegevensbestanden.

  • 400 IncompatiblePhysicalLayoutWrongNumberOfLogFiles - Databaseback-up bevat incompatibele fysieke indeling. Meerdere logboekbestanden worden niet ondersteund.

  • 400 IncompatiblePhysicalLayoutNonOnlineLogFilesExist - Databaseback-up bevat incompatibele fysieke indeling. Er bestaan niet-online logboekbestanden.

  • 400 IncompatiblePhysicalLayoutTooManyNonDataLogFiles - Databaseback-up bevat incompatibele fysieke indeling. Te veel niet-gegevens-/logboekbestanden.

  • 400 ExternalBackupAlreadySignaledToComplete - De herstelaanvraag is al gesignaleerd om te voltooien.

  • 400 ExternalBackupRestoreHasNotBeenStarted - De herstelaanvraag kan alleen worden voltooid zodra de herstelbewerking is gestart.

  • 400 ExternalBackupUpgradeInProgress: de herstelaanvraag kan niet worden voltooid, omdat de upgrade wordt uitgevoerd.

  • 400 IncompatiblePhysicalLayoutTooManyXTPFiles - Databaseback-up bevat incompatibele fysieke indeling. Er zijn meerdere bestanden gevonden in de bestandsgroep die MEMORY_OPTIMIZED_DATA bevat.

  • 400 BlobStorageFailure - Blob Storage-fout is opgetreden.

  • 400 BackupsFromMultipleDatabasesDetectedInTheContainerFromTheStart - Er zijn back-ups van meerdere databases in de containermap. Zorg ervoor dat de containermap back-ups van één database bevat.{0}

  • 400 ManagedIdentityIssueDetectedFromTheStart - Beheerde identiteit is niet juist ingesteld. Controleer en probeer het opnieuw.

  • 400 StorageBrokenIssueDetectedAtTheStart - Opslagverbinding is verbroken. Controleer en probeer het opnieuw.

  • 400 StorageBrokenIssueDetectedTerminateRetries - Opslagverbinding is nog steeds verbroken. Controleer en probeer het opnieuw.

  • 400 BackupSetBroken - Back-upset is verbroken.

  • 400 SqlRestoreError: er is een fout opgetreden die niet kan worden opgehaald tijdens het herstellen van de back-up.

  • 400 ManagedDatabaseNotIn RestoreState - Beheerde database heeft niet de status Herstellen.

Voorbeelden

Managed database restore details.

Voorbeeldaanvraag

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

Voorbeeldrespons

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

Definities

Name Description
ErrorAdditionalInfo

Aanvullende informatie over de resourcebeheerfout.
ErrorDetail

De foutdetails.
ErrorResponse

Foutreactie
ManagedDatabaseRestoreDetailsBackupSetProperties

De eigenschappen van de back-upset met herstelgegevens van de beheerde database.
ManagedDatabaseRestoreDetailsResult

Details van het herstellen van een beheerde database.
ManagedDatabaseRestoreDetailsUnrestorableFileProperties

De herstelgegevens van de beheerde database bevatten onbeperkte bestandseigenschappen.
RestoreDetailsName

De naam van de herstelgegevens die moeten worden opgehaald.

ErrorAdditionalInfo

Object

Aanvullende informatie over de resourcebeheerfout.

Name Type Description
info

object

De aanvullende informatie.
type

string

Het extra informatietype.

ErrorDetail

Object

De foutdetails.

Name Type Description
additionalInfo

ErrorAdditionalInfo[]

De fout bevat aanvullende informatie.
code

string

De foutcode.
details

ErrorDetail[]

De foutdetails.
message

string

Het foutbericht.
target

string

Het foutdoel.

ErrorResponse

Object

Foutreactie

Name Type Description
error

ErrorDetail

Het foutobject.

ManagedDatabaseRestoreDetailsBackupSetProperties

Object

De eigenschappen van de back-upset met herstelgegevens van de beheerde database.

Name Type Description
backupSizeMB

integer (int32)

Back-upgrootte.
firstStripeName

string

Eerste stripenaam.
numberOfStripes

integer (int32)

Aantal strepen.
restoreFinishedTimestampUtc

string (date-time)

Laatst herstelde bestandstijd.
restoreStartedTimestampUtc

string (date-time)

Laatst herstelde bestandstijd.
status

string

Status van back-upset.

ManagedDatabaseRestoreDetailsResult

Object

Details van het herstellen van een beheerde database.

Name Type Description
id

string

Resource-id.
name

string

Resourcenaam.
properties.blockReason

string

De reden waarom herstellen de status Geblokkeerd heeft.
properties.currentBackupType

string

Huidig back-uptype.
properties.currentRestorePlanSizeMB

integer (int32)

Huidige grootte van herstelplan MB.
properties.currentRestoredSizeMB

integer (int32)

Huidige herstelde grootte MB.
properties.currentRestoringFileName

string

Huidige naam van het herstellen van het bestand.
properties.diffBackupSets

ManagedDatabaseRestoreDetailsBackupSetProperties[]

Back-upsets diff.
properties.fullBackupSets

ManagedDatabaseRestoreDetailsBackupSetProperties[]

Volledige back-upsets.
properties.lastRestoredFileName

string

Laatst herstelde bestandsnaam.
properties.lastRestoredFileTime

string (date-time)

Laatst herstelde bestandstijd.
properties.lastUploadedFileName

string

Laatst geüploade bestandsnaam.
properties.lastUploadedFileTime

string (date-time)

Laatst geüploade bestandstijd.
properties.logBackupSets

ManagedDatabaseRestoreDetailsBackupSetProperties[]

Back-upsets voor logboeken.
properties.numberOfFilesDetected

integer (int32)

Aantal gedetecteerde bestanden.
properties.numberOfFilesQueued

integer (int32)

Aantal bestanden in de wachtrij.
properties.numberOfFilesRestored

integer (int32)

Aantal herstelde bestanden.
properties.numberOfFilesRestoring

integer (int32)

Aantal bestanden dat wordt hersteld.
properties.numberOfFilesSkipped

integer (int32)

Het aantal bestanden is overgeslagen.
properties.numberOfFilesUnrestorable

integer (int32)

Aantal bestanden onbeperkt.
properties.percentCompleted

integer (int32)

Percentage voltooid.
properties.status

string

Herstelstatus.
properties.type

string

Hersteltype.
properties.unrestorableFiles

ManagedDatabaseRestoreDetailsUnrestorableFileProperties[]

Onbeperkte bestanden.
type

string

Resourcetype.

ManagedDatabaseRestoreDetailsUnrestorableFileProperties

Object

De herstelgegevens van de beheerde database bevatten onbeperkte bestandseigenschappen.

Name Type Description
name

string

Bestandsnaam.

RestoreDetailsName

Inventarisatie

De naam van de herstelgegevens die moeten worden opgehaald.

Waarde Description
Default