Managed Database Restore Details - Get

Servizio:

SQL Database

Versione API:

2023-08-01

Ottiene i dettagli di ripristino del database gestito.

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
databaseName	path	True	string	Nome del database.
managedInstanceName	path	True	string	Nome dell'istanza gestita.
resourceGroupName	path	True	string	Nome del gruppo di risorse che contiene la risorsa. È possibile ottenere questo valore dall'API di Azure Resource Manager o dal portale.
restoreDetailsName	path	True	RestoreDetailsName	Nome dei dettagli di ripristino da recuperare.
subscriptionId	path	True	string	ID sottoscrizione che identifica una sottoscrizione di Azure.
api-version	query	True	string	Versione dell'API da usare per la richiesta.

Risposte

Nome	Tipo	Descrizione
200 OK	ManagedDatabaseRestoreDetailsResult	Sono stati recuperati i dettagli di ripristino.
Other Status Codes	ErrorResponse	Risposte di errore: 400 RestoreDetailsNotAvailableOrExpired: i dettagli di ripristino richiesti non sono disponibili o sono scaduti. 400 TimeoutDuringRestore- È stato rilevato un timeout durante il tentativo di connessione alla destinazione di ripristino. 400 AutoCompleteMissingLastBackupName- La richiesta di ripristino automatico deve avere il parametro lastBackupName specificato. 400 MissingThumbprint : non è possibile trovare il certificato del server. 400 BlobStorageServerFailure - Si è verificato un errore del server di archiviazione BLOB. 400 BackupSetNotFound- Non sono stati trovati backup per ripristinare il database. Contattare il supporto tecnico per ripristinare il database. 400 FullBackupNotFound - Impossibile trovare il backup completo. 400 RestoreFromStripedBackupsNotEnabled: il ripristino da backup con striping non è supportato. 400 BrokenRestorePlanNoFullBackup - Il piano di ripristino viene interrotto perché non è presente alcun backup completo. 400 BrokenRestorePlanWlationLogBackupLSN- Il piano di ripristino viene interrotto perché firstLsn del backup del log corrente non è <= lastLsn del backup del log successivo. 400 BrokenRestorePlanWbackupDiffBackupLSN- Il piano di ripristino viene interrotto perché firstLsn di backup diff non è >= firstLsn del backup completo. 400 BrokenRestorePlanGapInLogBackups - Il piano di ripristino viene interrotto perché firstLsn del backup del log corrente non è uguale a lastLsn del backup del log precedente. 400 TargetServerDoesNotExist: il server di destinazione {0} non esiste o non è ancora pronto. Verificare che esista e ripetere la richiesta di ripristino. 400 TargetServerRestoreNotAllowed: il server di destinazione {0} non è attualmente in uno stato che consente l'avvio di un ripristino. 400 XtpInitializedDuringRestore: il filegroup ottimizzato per la memoria deve essere vuoto per poter essere ripristinato nel livello Utilizzo generico dell'istanza gestita di database SQL. 400 FullBackupMissingChecksum - Il backup completo specificato non è presente. 400 FullBackupDamaged - Il backup completo fornito è danneggiato. 400 MissingStripeInBackupSet- Il set di backup fornito include una o più strisce mancanti. 400 BackupsFromMultipleDatabasesDetectedInTheContainerWhileRestoreInProgress: sono presenti backup da più database nella cartella contenitore. Assicurarsi che la cartella contenitore disponga di backup da un database singolo.{0} 400 BrokenRestorePlanWlationDiffBaseGUID - Il piano di ripristino viene interrotto perché DifferentialBaseGuid del backup diff non corrisponde a BackupSetGuid del backup completo. 400 CorruptedPagesInBackupSet - Operazione interrotta perché RESTORE ha rilevato una o più pagine danneggiate nel set di backup. 400 ManagedIdentityIssueDetectedWhileRestoreInProgress : l'identità gestita non è configurata correttamente. Verificare e riprovare. 400 CorruptedPagesListMaintenance - Operazione interrotta perché si è verificato un errore interno durante l'elaborazione del backup eseguito senza checksum. 400 StorageBrokenIssueDetectedWhileInProgress - Connessione di archiviazione interrotta. Riprovare automaticamente... 400 PartiallyContainedDatabaseUnsupported : "Il backup per un database parzialmente indipendente non è supportato". 400 RequiredBackupIsNotLastRestored - Impossibile completare la migrazione perché il nome del file di backup specificato non è il nome dell'ultimo file di backup ripristinato. 400 ManagedInstanceStorageLimitHit: l'istanza gestita ha raggiunto il limite di archiviazione. 400 IncompatiblePhysicalLayoutTooFewDataFiles - Il backup del database contiene un layout fisico incompatibile. Nessun file di dati trovato nel backup. 400 IncompatiblePhysicalLayoutNonOnlineDataFilesExist - Il backup del database contiene un layout fisico incompatibile. Esistono file di dati non online. 400 IncompatiblePhysicalLayoutWintuneNumberOfLogFiles - Il backup del database contiene un layout fisico incompatibile. Non sono supportati più file di log. 400 IncompatiblePhysicalLayoutNonOnlineLogFilesExist - Il backup del database contiene un layout fisico incompatibile. Esistono file di log non online. 400 IncompatiblePhysicalLayoutTooManyNonDataLogFiles - Il backup del database contiene un layout fisico incompatibile. Troppi file non di dati/log. 400 ExternalBackupAlreadySignaledToComplete: la richiesta di ripristino è già stata segnalata per il completamento. 400 ExternalBackupRestoreHasNotBeenStarted: la richiesta di ripristino può essere completata solo dopo l'avvio del ripristino. 400 ExternalBackupUpgradeInProgress - Impossibile completare la richiesta di ripristino, perché l'aggiornamento è in corso. 400 IncompatiblePhysicalLayoutTooManyXTPFiles - Il backup del database contiene un layout fisico incompatibile. Più file trovati nel filegroup che contiene MEMORY_OPTIMIZED_DATA. 400 BlobStorageFailure - Si è verificato un errore di archiviazione BLOB. 400 BackupsFromMultipleDatabasesDetectedInTheContainerFromTheStart: sono presenti backup da più database nella cartella contenitore. Assicurarsi che la cartella contenitore disponga di backup da un database singolo.{0} 400 ManagedIdentityIssueDetectedFromTheStart - L'identità gestita non è configurata correttamente. Verificare e riprovare. 400 StorageBrokenIssueDetectedAtTheStart - Connessione di archiviazione interrotta. Verificare e riprovare. 400 StorageBrokenIssueDetectedTerminateRetries - La connessione di archiviazione è ancora interrotta. Verificare e riprovare. 400 BackupSetBroken - Il set di backup è interrotto. 400 SqlRestoreError - Errore non ritentabile durante il ripristino del backup. 400 ManagedDatabaseNotInRestoringState - Il database gestito non è in stato ripristino.

Esempio

Managed database restore details.

Esempio di richiesta

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

Risposta di esempio

Codice di stato:

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

Definizioni

Nome	Descrizione
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
ManagedDatabaseRestoreDetailsBackupSetProperties	Proprietà del set di backup dei dettagli di ripristino del database gestito.
ManagedDatabaseRestoreDetailsResult	Dettagli di ripristino del database gestito.
ManagedDatabaseRestoreDetailsUnrestorableFileProperties	I dettagli di ripristino del database gestito non ripristinano le proprietà dei file non ripristinabili.
RestoreDetailsName	Nome dei dettagli di ripristino da recuperare.

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

ManagedDatabaseRestoreDetailsBackupSetProperties

Object

Proprietà del set di backup dei dettagli di ripristino del database gestito.

Nome	Tipo	Descrizione
backupSizeMB	integer (int32)	Dimensioni del backup.
firstStripeName	string	Nome della prima striscia.
numberOfStripes	integer (int32)	Numero di strisce.
restoreFinishedTimestampUtc	string (date-time)	Ora dell'ultimo file ripristinato.
restoreStartedTimestampUtc	string (date-time)	Ora dell'ultimo file ripristinato.
status	string	Stato del set di backup.

ManagedDatabaseRestoreDetailsResult

Object

Dettagli di ripristino del database gestito.

Nome	Tipo	Descrizione
id	string	ID risorsa.
name	string	Nome risorsa.
properties.blockReason	string	Motivo per cui il ripristino è in stato Bloccato.
properties.currentBackupType	string	Tipo di backup corrente.
properties.currentRestorePlanSizeMB	integer (int32)	Dimensioni correnti del piano di ripristino MB.
properties.currentRestoredSizeMB	integer (int32)	Dimensioni ripristinate correnti MB.
properties.currentRestoringFileName	string	Nome file di ripristino corrente.
properties.diffBackupSets	ManagedDatabaseRestoreDetailsBackupSetProperties[]	Set di backup Diff.
properties.fullBackupSets	ManagedDatabaseRestoreDetailsBackupSetProperties[]	Set di backup completi.
properties.lastRestoredFileName	string	Ultimo nome file ripristinato.
properties.lastRestoredFileTime	string (date-time)	Ora dell'ultimo file ripristinato.
properties.lastUploadedFileName	string	Cognome del file caricato.
properties.lastUploadedFileTime	string (date-time)	Ora dell'ultimo file caricato.
properties.logBackupSets	ManagedDatabaseRestoreDetailsBackupSetProperties[]	Set di backup del log.
properties.numberOfFilesDetected	integer (int32)	Numero di file rilevati.
properties.numberOfFilesQueued	integer (int32)	Numero di file in coda.
properties.numberOfFilesRestored	integer (int32)	Numero di file ripristinati.
properties.numberOfFilesRestoring	integer (int32)	Numero di file di ripristino.
properties.numberOfFilesSkipped	integer (int32)	Numero di file ignorati.
properties.numberOfFilesUnrestorable	integer (int32)	Numero di file non ripristinabili.
properties.percentCompleted	integer (int32)	Percentuale completata.
properties.status	string	Stato di ripristino.
properties.type	string	Tipo di ripristino.
properties.unrestorableFiles	ManagedDatabaseRestoreDetailsUnrestorableFileProperties[]	File non ripristinabili.
type	string	Tipo di risorsa.

ManagedDatabaseRestoreDetailsUnrestorableFileProperties

Object

I dettagli di ripristino del database gestito non ripristinano le proprietà dei file non ripristinabili.

Nome	Tipo	Descrizione
name	string	Nome file.

RestoreDetailsName

Enumerazione

Nome dei dettagli di ripristino da recuperare.

Valore	Descrizione
Default