Поделиться через

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

Имя В Обязательно Тип Описание
databaseName
 path True

string

Имя базы данных.
managedInstanceName
 path True

string

Имя управляемого экземпляра.
resourceGroupName
 path True

string

Имя группы ресурсов, содержащей ресурс. Это значение можно получить из API Azure Resource Manager или портала.
restoreDetailsName
 path True

RestoreDetailsName

Имя извлекаемых сведений о восстановлении.
subscriptionId
 path True

string

Идентификатор подписки, идентифицирующий подписку Azure.
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 резервного копирования диффа не >= firstLsn полного резервного копирования.

  • 400 BrokenRestorePlanGapInLogBackups — план восстановления разбит, так как firstLsn текущего резервного копирования журнала не равен lastLsn резервного копирования предварительного журнала.

  • 400 TargetServerDoesNotExist — целевой сервер {0} не существует или еще не готов. Убедитесь, что он существует и повторите запрос на восстановление.

  • 400 TargetServerRestoreNotAllowed — целевой сервер {0} в настоящее время не находится в состоянии, позволяющем запустить восстановление.

  • 400 XtpInitializedDuringRestore — оптимизированная для памяти файловая группа должна быть пуста для восстановления на уровне общего назначения управляемого экземпляра базы данных SQL.

  • 400 FullBackupMissingChecksum — предоставленная полная резервная копия отсутствует контрольная сумма.

  • 400 FullBackupDamaged — предоставлено полное резервное копирование повреждено.

  • 400 MissingStripeInBackupSet — предоставленный резервный набор содержит одну или несколько отсутствующих полос.

  • 400 BackupsFromMultipleDatabasesDetectedInTheContainerTimeRestoreInProgress — в папке контейнера есть резервные копии из нескольких баз данных. Убедитесь, что папка контейнера содержит резервные копии из одной базы данных.{0}

  • 400 BrokenRestorePlanWrongDiffBaseGUID — план восстановления разбит, так как DifferentialBaseGuid резервного копирования диффа не соответствует BackupSetGuid полной резервной копии.

  • 400 CorruptedPagesInBackupSet — операция была прервана, так как RESTORE обнаружил одну или несколько поврежденных страниц в резервном наборе.

  • 400 ManagedIdentityIssueDetectedTimeRestoreInProgress — управляемое удостоверение неправильно настроено. Проверьте и повторите попытку.

  • 400 CorruptedPagesListMaintenance — операция была прервана, так как при обработке резервной копии, выполненной без контрольной суммы, произошла внутренняя ошибка.

  • 400 StorageBrokenIssueDetectedTimeInProgresss — подключение к хранилищу нарушено. Повторная попытка автоматически...

  • 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

Пример ответа

Код состояния:
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"
}

Определения

Имя Описание
ErrorAdditionalInfo

Дополнительные сведения об ошибке управления ресурсами.
ErrorDetail

Сведения об ошибке.
ErrorResponse

Ответ на ошибку
ManagedDatabaseRestoreDetailsBackupSetProperties

Свойства резервного набора данных для восстановления управляемой базы данных.
ManagedDatabaseRestoreDetailsResult

Сведения о восстановлении управляемой базы данных.
ManagedDatabaseRestoreDetailsUnrestorableFileProperties

Свойства неограничимого файла для восстановления управляемой базы данных.
RestoreDetailsName

Имя извлекаемых сведений о восстановлении.

ErrorAdditionalInfo

Object

Дополнительные сведения об ошибке управления ресурсами.

Имя Тип Описание
info

object

Дополнительные сведения.
type

string

Дополнительный тип сведений.

ErrorDetail

Object

Сведения об ошибке.

Имя Тип Описание
additionalInfo

ErrorAdditionalInfo[]

Дополнительные сведения об ошибке.
code

string

Код ошибки.
details

ErrorDetail[]

Сведения об ошибке.
message

string

Сообщение об ошибке.
target

string

Целевой объект ошибки.

ErrorResponse

Object

Ответ на ошибку

Имя Тип Описание
error

ErrorDetail

Объект ошибки.

ManagedDatabaseRestoreDetailsBackupSetProperties

Object

Свойства резервного набора данных для восстановления управляемой базы данных.

Имя Тип Описание
backupSizeMB

integer (int32)

Размер резервного копирования.
firstStripeName

string

Имя первой полосы.
numberOfStripes

integer (int32)

Количество полос.
restoreFinishedTimestampUtc

string (date-time)

Время последнего восстановления файла.
restoreStartedTimestampUtc

string (date-time)

Время последнего восстановления файла.
status

string

Состояние резервного набора данных.

ManagedDatabaseRestoreDetailsResult

Object

Сведения о восстановлении управляемой базы данных.

Имя Тип Описание
id

string

Идентификатор ресурса.
name

string

Имя ресурса.
properties.blockReason

string

Причина, по которой восстановление находится в заблокированном состоянии.
properties.currentBackupType

string

Текущий тип резервного копирования.
properties.currentRestorePlanSizeMB

integer (int32)

Текущий размер плана восстановления в МБ.
properties.currentRestoredSizeMB

integer (int32)

Текущий восстановленный размер МБ.
properties.currentRestoringFileName

string

Текущее восстановление имени файла.
properties.diffBackupSets

ManagedDatabaseRestoreDetailsBackupSetProperties[]

Наборы резервных копий Diff.
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

Свойства неограничимого файла для восстановления управляемой базы данных.

Имя Тип Описание
name

string

Имя файла.

RestoreDetailsName

Перечисление

Имя извлекаемых сведений о восстановлении.

Значение Описание
Default