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	リソースを含むリソースグループの名前。この値は、Azure Resource Manager 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 が >= 完全バックアップの firstLsn ではないため、復元プランが壊れています。 400 BrokenRestorePlanGapInLogBackups - 現在のログバックアップの firstLsn が prev ログバックアップの lastLsn と等しくないため、復元プランが壊れています。 400 TargetServerDoesNotExist - ターゲットサーバー {0} が存在しないか、まだ準備ができていません。存在することを確認し、復元要求を再試行してください。 400 TargetServerRestoreNotAllowed - ターゲットサーバー {0} は現在、復元を開始できる状態ではありません。 400 XtpInitializedDuringRestore - SQL Database Managed Instance の General Purpose レベルで復元するには、メモリ最適化ファイルグループを空にする必要があります。 400 FullBackupMissingChecksum - 完全バックアップにチェックサムがない場合。 400 FullBackupDamaged - 完全バックアップが破損している場合。 400 MissingStripeInBackupSet - 指定されたバックアップセットに 1 つ以上の欠落ストライプがあります。 400 BackupsFromMultipleDatabasesDetectedInTheContainerWhileRestoreInProgress - コンテナーフォルダー内の複数のデータベースからのバックアップがあります。コンテナーフォルダーに 1 つのデータベースからのバックアップがあることを確認してください。{0} 400 BrokenRestorePlanWrongDiffBaseGUID - 差分バックアップの DifferentialBaseGuid が完全バックアップの BackupSetGuid と一致しないため、復元プランが壊れています。 400 CorruptedPagesInBackupSet - RESTORE でバックアップセット内の 1 つ以上の破損したページが検出されたため、操作が中止されました。 400 ManagedIdentityIssueDetectedWhileRestoreInProgress - マネージド ID が正しく設定されていません。確認してやり直してください。 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 Storage エラーが発生しました。 400 BackupsFromMultipleDatabasesDetectedInTheContainerFromTheStart - コンテナーフォルダー内の複数のデータベースからのバックアップがあります。コンテナーフォルダーに 1 つのデータベースからのバックアップがあることを確認してください。{0} 400 ManagedIdentityIssueDetectedFromTheStart - マネージド ID が正しく設定されていません。確認してやり直してください。 400 StorageBrokenIssueDetectedAtTheStart - ストレージ接続が切断されました。確認してやり直してください。 400 StorageBrokenIssueDetectedTerminateRetries - ストレージ接続はまだ切断されています。確認してやり直してください。 400 BackupSetBroken - バックアップセットが壊れています。 400 SqlRestoreError - バックアップの復元中に再トリガーできないエラーが発生しました。 400 ManagedDatabaseNotInRestoringState - マネージドデータベースが復元状態ではありません。

名前

型

説明

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 が prev ログバックアップの lastLsn と等しくないため、復元プランが壊れています。
400 TargetServerDoesNotExist - ターゲットサーバー {0} が存在しないか、まだ準備ができていません。存在することを確認し、復元要求を再試行してください。
400 TargetServerRestoreNotAllowed - ターゲットサーバー {0} は現在、復元を開始できる状態ではありません。
400 XtpInitializedDuringRestore - SQL Database Managed Instance の General Purpose レベルで復元するには、メモリ最適化ファイルグループを空にする必要があります。
400 FullBackupMissingChecksum - 完全バックアップにチェックサムがない場合。
400 FullBackupDamaged - 完全バックアップが破損している場合。
400 MissingStripeInBackupSet - 指定されたバックアップセットに 1 つ以上の欠落ストライプがあります。
400 BackupsFromMultipleDatabasesDetectedInTheContainerWhileRestoreInProgress - コンテナーフォルダー内の複数のデータベースからのバックアップがあります。コンテナーフォルダーに 1 つのデータベースからのバックアップがあることを確認してください。{0}
400 BrokenRestorePlanWrongDiffBaseGUID - 差分バックアップの DifferentialBaseGuid が完全バックアップの BackupSetGuid と一致しないため、復元プランが壊れています。
400 CorruptedPagesInBackupSet - RESTORE でバックアップセット内の 1 つ以上の破損したページが検出されたため、操作が中止されました。
400 ManagedIdentityIssueDetectedWhileRestoreInProgress - マネージド ID が正しく設定されていません。確認してやり直してください。
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 Storage エラーが発生しました。
400 BackupsFromMultipleDatabasesDetectedInTheContainerFromTheStart - コンテナーフォルダー内の複数のデータベースからのバックアップがあります。コンテナーフォルダーに 1 つのデータベースからのバックアップがあることを確認してください。{0}
400 ManagedIdentityIssueDetectedFromTheStart - マネージド ID が正しく設定されていません。確認してやり直してください。
400 StorageBrokenIssueDetectedAtTheStart - ストレージ接続が切断されました。確認してやり直してください。
400 StorageBrokenIssueDetectedTerminateRetries - ストレージ接続はまだ切断されています。確認してやり直してください。
400 BackupSetBroken - バックアップセットが壊れています。
400 SqlRestoreError - バックアップの復元中に再トリガーできないエラーが発生しました。
400 ManagedDatabaseNotInRestoringState - マネージドデータベースが復元状態ではありません。

例

Managed database restore details.

要求のサンプル

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

応答のサンプル

状態コード:: 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	リソース 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

Object

マネージドデータベースの復元では、復元できないファイルのプロパティについて詳しく説明します。

名前	型	説明
name	string	ファイル名。

RestoreDetailsName

列挙

取得する復元の詳細の名前。

値	説明
Default

次の方法で共有

Managed Database Restore Details - Get

URI パラメーター

応答

例

Managed database restore details.

要求のサンプル

応答のサンプル

定義

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

ManagedDatabaseRestoreDetailsBackupSetProperties

ManagedDatabaseRestoreDetailsResult

ManagedDatabaseRestoreDetailsUnrestorableFileProperties

RestoreDetailsName

その他のリソース