你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

Managed Database Restore Details - Get

获取托管数据库还原详细信息。

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

URI 参数

名称 必需 类型 说明
databaseName
path True

string

数据库的名称。

managedInstanceName
path True

string

托管实例的名称。

resourceGroupName
path True

string

包含资源的资源组的名称。 可以从 Azure 资源管理器 API 或门户获取此值。

restoreDetailsName
path True

RestoreDetailsName

要检索的还原详细信息的名称。

subscriptionId
path True

string

标识 Azure 订阅的订阅 ID。

api-version
query True

string

要用于请求的 API 版本。

响应

名称 类型 说明
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 - 还原计划中断,因为差异备份的 firstLsn 不是 >= 完整备份的第一个Lsn。

  • 400 BrokenRestorePlanGapInLogBackups - 还原计划中断,因为当前日志备份的 firstLsn 不等于上一个日志备份的 lastLsn。

  • 400 TargetServerDoesNotExist - 目标服务器 {0} 不存在或尚未就绪。 请检查是否存在并重试还原请求。

  • 400 TargetServerRestoreNotAllowed - 目标服务器 {0} 当前未处于允许启动还原的状态。

  • 400 XtpInitializedDuringRestore - 内存优化文件组必须为空,才能在 SQL 数据库托管实例的“常规用途”层上还原。

  • 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 IncompatiblePhysicalLayoutTooFewDataFiles - 数据库备份包含不兼容的物理布局。 备份中未找到任何数据文件。

  • 400 IncompatiblePhysicalLayoutNonOnlineDataFilesExist - 数据库备份包含不兼容的物理布局。 存在非联机数据文件。

  • 400 IncompatiblePhysicalLayoutWrongNumberOfLogFiles - 数据库备份包含不兼容的物理布局。 不支持多个日志文件。

  • 400 IncompatiblePhysicalLayoutNonOnlineLogFilesExist - 数据库备份包含不兼容的物理布局。 存在非联机日志文件。

  • 400 IncompatiblePhysicalLayoutTooManyNonDataLogFiles - 数据库备份包含不兼容的物理布局。 过多的非数据/日志文件。

  • 400 ExternalBackupAlreadySignaledToComplete - 还原请求已发出完成信号。

  • 400 ExternalBackupRestoreHasNotBeenStarted - 还原请求只能在还原启动后完成。

  • 400 ExternalBackupUpgradeInProgress - 还原请求无法完成,因为升级正在进行。

  • 400 IncompatiblePhysicalLayoutTooManyXTPFiles - 数据库备份包含不兼容的物理布局。 在包含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

示例响应

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

定义

名称 说明
ErrorAdditionalInfo

资源管理错误附加信息。

ErrorDetail

错误详细信息。

ErrorResponse

错误响应

ManagedDatabaseRestoreDetailsBackupSetProperties

托管数据库的还原详细信息备份集属性。

ManagedDatabaseRestoreDetailsResult

托管数据库还原详细信息。

ManagedDatabaseRestoreDetailsUnrestorableFileProperties

托管数据库的还原详细信息不可还原的文件属性。

RestoreDetailsName

要检索的还原详细信息的名称。

ErrorAdditionalInfo

资源管理错误附加信息。

名称 类型 说明
info

object

其他信息。

type

string

其他信息类型。

ErrorDetail

错误详细信息。

名称 类型 说明
additionalInfo

ErrorAdditionalInfo[]

错误附加信息。

code

string

错误代码。

details

ErrorDetail[]

错误详细信息。

message

string

错误消息。

target

string

错误目标。

ErrorResponse

错误响应

名称 类型 说明
error

ErrorDetail

错误对象。

ManagedDatabaseRestoreDetailsBackupSetProperties

托管数据库的还原详细信息备份集属性。

名称 类型 说明
backupSizeMB

integer (int32)

备份大小。

firstStripeName

string

第一个条带名称。

numberOfStripes

integer (int32)

条带数。

restoreFinishedTimestampUtc

string (date-time)

上次还原的文件时间。

restoreStartedTimestampUtc

string (date-time)

上次还原的文件时间。

status

string

备份集状态。

ManagedDatabaseRestoreDetailsResult

托管数据库还原详细信息。

名称 类型 说明
id

string

资源 ID。

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

托管数据库的还原详细信息不可还原的文件属性。

名称 类型 说明
name

string

文件名。

RestoreDetailsName

要检索的还原详细信息的名称。

说明
Default