共用方式為

Managed Database Restore Details - Get

服務:
SQL Database
API 版本:
2023-08-01

取得受控資料庫還原詳細數據。

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

URI 參數

名稱 位於 必要 類型 Description
databaseName
 path True

string

資料庫的名稱。
managedInstanceName
 path True

string

受控實例的名稱。
resourceGroupName
 path True

string

包含資源的資源群組名稱。 您可以從 Azure Resource Manager API 或入口網站取得此值。
restoreDetailsName
 path True

RestoreDetailsName

要擷取之還原詳細數據的名稱。
subscriptionId
 path True

string

識別 Azure 訂用帳戶的訂用帳戶標識碼。
api-version
 query True

string

要用於要求的 API 版本。

回應

名稱 類型 Description
200 OK

ManagedDatabaseRestoreDetailsResult

已成功擷取還原詳細數據。
Other Status Codes

ErrorResponse

錯誤回應： ***

  • 400 RestoreDetailsNotAvailableOrExpired - 無法使用要求的還原詳細數據，或已過期。

  • 400 TimeoutDuringRestore - 嘗試連線到還原目標時發生逾時。

  • 400 AutoCompleteMissingLastBackupName - 自動完成還原要求必須提供 lastBackupName 參數。

  • 400 MissingThumbprint - 找不到伺服器證書。

  • 400 BlobStorageServerFailure - Blob 記憶體伺服器失敗。

  • 400 BackupSetNotFound - 找不到還原資料庫的備份。 請連絡支援人員以還原資料庫。

  • 400 FullBackupNotFound - 找不到完整備份。

  • 400 RestoreFromStripedBackupsNotEnabled - 不支援從等量備份還原。

  • 400 BrokenRestorePlanNoFullBackup - 還原計劃已中斷，因為沒有完整備份。

  • 400 BrokenRestorePlanWrongLogBackupLSN - 還原計劃已中斷，因為目前記錄備份的 firstLsn 未 <= 下一個記錄備份的 lastLsn。

  • 400 BrokenRestorePlanWrongDiffBackupLSN - 還原計劃已中斷，因為 diff 備份的 firstLsn 未 >= full backup 的 firstLsn。

  • 400 BrokenRestorePlanGapInLogBackups - 還原計劃已中斷，因為目前記錄備份的 firstLsn 不等於上一個記錄備份的 lastLsn。

  • 400 TargetServerDoesNotExist - 目標伺服器 {0} 不存在或尚未就緒。 請檢查它是否存在，然後重試還原要求。

  • 400 TargetServerRestoreNotAllowed - 目標伺服器 {0} 目前不是允許啟動還原的狀態。

  • 400 XtpInitializedDuringRestore - 記憶體優化檔案群組必須是空的，才能在 SQL Database 受控實例的一般用途層還原。

  • 400 FullBackupMissingChecksum - 提供的完整備份遺漏總和檢查碼。

  • 400 FullBackupDamaged - 提供的完整備份已損毀。

  • 400 MissingStripeInBackupSet - 提供的備份集有一或多個遺漏的等量。

  • 400 BackupsFromMultipleDatabasesDetectedInTheContainerWhileRestoreInProgress - 容器資料夾中有多個資料庫的備份。 請確定容器資料夾具有來自單一資料庫的備份。{0}

  • 400 BrokenRestorePlanWrongDiffBaseGUID - 還原計劃已中斷，因為差異備份的 DifferentialBaseGuid 不符合完整備份的 BackupSetGuid。

  • 400 CorruptedPagesInBackupSet - 作業已中止，因為 RESTORE 偵測到備份集中的一或多個損毀頁面。

  • 400 ManagedIdentityIssueDetectedWhileRestoreInProgress - 受控識別未正確設定。 請確認並再試一次。

  • 400 CorruptedPagesListMaintenance - 作業已中止，因為處理未進行總和檢查碼的備份時發生內部錯誤。

  • 400 StorageBrokenIssueDetectedWhileInProgress - 記憶體連線已中斷。 自動重試...

  • 400 PartiallyContainedDatabaseUnsupported -「不支援部分自主資料庫的備份」。

  • 400 RequiredBackupIsNotLastRestored - 無法完成移轉，因為提供的備份檔名不是還原的最後一個備份文件的名稱。

  • 400 ManagedInstanceStorageLimitHit - 受控實例已達到其記憶體限制。

  • 400 不相容的PhysicalLayoutTooFewDataFiles - 資料庫備份包含不相容的實體配置。 備份中找不到任何數據檔。

  • 400 不相容的PhysicalLayoutNonOnlineDataFilesExist - 資料庫備份包含不相容的實體配置。 非在線數據檔存在。

  • 400 IncompatiblePhysicalLayoutWrongNumberOfLogFiles - 資料庫備份包含不相容的實體配置。 不支援多個記錄檔。

  • 400 不相容的PhysicalLayoutNonOnlineLogFilesExist - 資料庫備份包含不相容的實體配置。 非在線記錄檔存在。

  • 400 IncompatiblePhysicalLayoutTooManyNonDataLogFiles - 資料庫備份包含不相容的實體配置。 太多非數據/記錄檔。

  • 400 ExternalBackupAlreadySignaledToComplete - 還原要求已發出完成的訊號。

  • 400 ExternalBackupRestoreHasNotBeenStarted - 還原要求只能在還原啟動之後完成。

  • 400 ExternalBackupUpgradeInProgress - 還原要求無法完成，因為升級正在進行中。

  • 400 不相容的PhysicalLayoutTooManyXTPFiles - 資料庫備份包含不相容的實體配置。 在包含MEMORY_OPTIMIZED_DATA的檔案群組中找到多個檔案。

  • 400 BlobStorageFailure - Blob 記憶體失敗。

  • 400 BackupsFromMultipleDatabasesDetectedInTheContainerFromTheStart - 容器資料夾中有多個資料庫的備份。 請確定容器資料夾具有來自單一資料庫的備份。{0}

  • 400 ManagedIdentityIssueDetectedFromTheStart - 受控識別未正確設定。 請確認並再試一次。

  • 400 StorageBrokenIssueDetectedAtTheStart - 儲存器連線中斷。 請確認並再試一次。

  • 400 StorageBrokenIssueDetectedTerminateRetries - 記憶體連線仍然中斷。 請確認並再試一次。

  • 400 BackupSetBroken - 備份集已中斷。

  • 400 SqlRestoreError - 還原備份時發生無法重試的錯誤。

  • 400 ManagedDatabaseNotInRestoringState - 受控資料庫未處於還原狀態。

範例

Managed database restore details.

範例要求

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

範例回覆

狀態碼:
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"
}

定義

名稱 Description
ErrorAdditionalInfo

資源管理錯誤其他資訊。
ErrorDetail

錯誤詳細數據。
ErrorResponse

錯誤回應
ManagedDatabaseRestoreDetailsBackupSetProperties

受控資料庫的還原詳細數據備份集屬性。
ManagedDatabaseRestoreDetailsResult

受控資料庫還原詳細數據。
ManagedDatabaseRestoreDetailsUnrestorableFileProperties

受控資料庫的還原詳細數據無法儲存的檔案屬性。
RestoreDetailsName

要擷取之還原詳細數據的名稱。

ErrorAdditionalInfo

Object

資源管理錯誤其他資訊。

名稱 類型 Description
info

object

其他資訊。
type

string

其他信息類型。

ErrorDetail

Object

錯誤詳細數據。

名稱 類型 Description
additionalInfo

ErrorAdditionalInfo[]

錯誤其他資訊。
code

string

錯誤碼。
details

ErrorDetail[]

錯誤詳細數據。
message

string

錯誤訊息。
target

string

錯誤目標。

ErrorResponse

Object

錯誤回應

名稱 類型 Description
error

ErrorDetail

error 物件。

ManagedDatabaseRestoreDetailsBackupSetProperties

Object

受控資料庫的還原詳細數據備份集屬性。

名稱 類型 Description
backupSizeMB

integer (int32)

備份大小。
firstStripeName

string

第一個等量名稱。
numberOfStripes

integer (int32)

等量數。
restoreFinishedTimestampUtc

string (date-time)

上次還原的檔案時間。
restoreStartedTimestampUtc

string (date-time)

上次還原的檔案時間。
status

string

備份集狀態。

ManagedDatabaseRestoreDetailsResult

Object

受控資料庫還原詳細數據。

名稱 類型 Description
id

string

資源標識碼。
name

string

資源名稱。
properties.blockReason

string

還原處於封鎖狀態的原因。
properties.currentBackupType

string

目前的備份類型。
properties.currentRestorePlanSizeMB

integer (int32)

目前的還原計劃大小 MB。
properties.currentRestoredSizeMB

integer (int32)

目前還原的大小 MB。
properties.currentRestoringFileName

string

目前還原檔名。
properties.diffBackupSets

ManagedDatabaseRestoreDetailsBackupSetProperties[]

差異備份集。
properties.fullBackupSets

ManagedDatabaseRestoreDetailsBackupSetProperties[]

完整備份集。
properties.lastRestoredFileName

string

上次還原的檔名。
properties.lastRestoredFileTime

string (date-time)

上次還原的檔案時間。
properties.lastUploadedFileName

string

上次上傳的檔名。
properties.lastUploadedFileTime

string (date-time)

上次上傳的檔案時間。
properties.logBackupSets

ManagedDatabaseRestoreDetailsBackupSetProperties[]

記錄備份集。
properties.numberOfFilesDetected

integer (int32)

偵測到的檔案數目。
properties.numberOfFilesQueued

integer (int32)

已排入佇列的檔案數目。
properties.numberOfFilesRestored

integer (int32)

已還原的檔案數目。
properties.numberOfFilesRestoring

integer (int32)

正在還原的檔案數目。
properties.numberOfFilesSkipped

integer (int32)

略過檔案的數目。
properties.numberOfFilesUnrestorable

integer (int32)

無法儲存的檔案數目。
properties.percentCompleted

integer (int32)

已完成百分比。
properties.status

string

還原狀態。
properties.type

string

還原類型。
properties.unrestorableFiles

ManagedDatabaseRestoreDetailsUnrestorableFileProperties[]

無法儲存的檔案。
type

string

資源類型。

ManagedDatabaseRestoreDetailsUnrestorableFileProperties

Object

受控資料庫的還原詳細數據無法儲存的檔案屬性。

名稱 類型 Description
name

string

檔名。

RestoreDetailsName

列舉型別

要擷取之還原詳細數據的名稱。

值 Description
Default