다음을 통해 공유

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 매개 변수

Name In(다음 안에) 필수 형식 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 구독을 식별하는 구독 ID입니다.
api-version
 query True

string

요청에 사용할 API 버전입니다.

응답

Name 형식 Description
200 OK

ManagedDatabaseRestoreDetailsResult

복원 세부 정보를 검색했습니다.
Other Status Codes

ErrorResponse

오류 응답: ***

  • 400 RestoreDetailsNotAvailableOrExpired - 요청된 복원 세부 정보를 사용할 수 없거나 만료되었습니다.

  • 400 TimeoutDuringRestore - 복원 대상에 연결하는 동안 시간 제한이 발생했습니다.

  • 400 AutoCompleteMissingLastBackupName - 자동 완료 복원 요청에는 lastBackupName 매개 변수가 제공되어야 합니다.

  • 400 MissingThumbprint - 서버 인증서를 찾을 수 없습니다.

  • 400 BlobStorageServerFailure - Blob Storage 서버 오류가 발생했습니다.

  • 400 BackupSetNotFound - 데이터베이스를 복원할 백업이 없습니다. 데이터베이스를 복원하려면 지원에 문의하세요.

  • 400 FullBackupNotFound - 전체 백업을 찾을 수 없습니다.

  • 400 RestoreFromStripedBackupsNotEnabled - 스트라이프 백업에서 복원은 지원되지 않습니다.

  • 400 BrokenRestorePlanNoFullBackup - 전체 백업이 없으므로 복원 계획이 끊어졌습니다.

  • 400 BrokenRestorePlanWrongLogBackupLSN - 현재 로그 백업의 firstLsn이 <= 다음 로그 백업의 lastLsn이 아니므로 복원 계획이 끊어졌습니다.

  • 400 BrokenRestorePlanWrongDiffBackupLSN - diff 백업의 firstLsn이 >= 전체 백업의 firstLsn이 아니므로 복원 계획이 끊어졌습니다.

  • 400 BrokenRestorePlanGapInLogBackups - 현재 로그 백업의 firstLsn이 prev 로그 백업의 lastLsn과 같지 않으므로 복원 계획이 끊어졌습니다.

  • 400 TargetServerDoesNotExist - {0} 대상 서버가 없거나 아직 준비되지 않았습니다. 존재하는지 확인하고 복원 요청을 다시 시도하세요.

  • 400 TargetServerRestoreNotAllowed - {0} 대상 서버가 현재 복원을 시작할 수 있는 상태가 아닙니다.

  • 400 XtpInitializedDuringRestore - SQL Database Managed Instance의 범용 계층에서 복원하려면 메모리 최적화 파일 그룹이 비어 있어야 합니다.

  • 400 FullBackupMissingChecksum - 전체 백업에 체크섬이 없는 경우

  • 400 FullBackupDamaged - 전체 백업이 손상된 경우.

  • 400 MissingStripeInBackupSet - 제공된 백업 세트에 하나 이상의 누락된 스트라이프가 있습니다.

  • 400 BackupsFromMultipleDatabasesDetectedInTheContainerWhileRestoreInProgress - 컨테이너 폴더에 여러 데이터베이스의 백업이 있습니다. 컨테이너 폴더에 단일 데이터베이스의 백업이 있는지 확인하세요.{0}

  • 400 BrokenRestorePlanWrongDiffBaseGUID - diff 백업의 DifferentialBaseGuid가 전체 백업의 BackupSetGuid와 일치하지 않으므로 복원 계획이 끊어졌습니다.

  • 400 CorruptedPagesInBackupSet - RESTORE가 백업 세트에서 하나 이상의 손상된 페이지를 검색하여 작업이 중단되었습니다.

  • 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 - 컨테이너 폴더에 여러 데이터베이스의 백업이 있습니다. 컨테이너 폴더에 단일 데이터베이스의 백업이 있는지 확인하세요.{0}

  • 400 ManagedIdentityIssueDetectedFromTheStart - 관리 ID가 제대로 설정되지 않았습니다. 확인하고 다시 시도하세요.

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

정의

Name Description
ErrorAdditionalInfo

리소스 관리 오류 추가 정보입니다.
ErrorDetail

오류 세부 정보입니다.
ErrorResponse

오류 응답
ManagedDatabaseRestoreDetailsBackupSetProperties

관리되는 데이터베이스의 복원 세부 정보 백업 집합 속성입니다.
ManagedDatabaseRestoreDetailsResult

관리되는 데이터베이스 복원 세부 정보입니다.
ManagedDatabaseRestoreDetailsUnrestorableFileProperties

관리되는 데이터베이스의 복원 세부 정보는 복원할 수 없는 파일 속성입니다.
RestoreDetailsName

검색할 복원 세부 정보의 이름입니다.

ErrorAdditionalInfo

Object

리소스 관리 오류 추가 정보입니다.

Name 형식 Description
info

object

추가 정보입니다.
type

string

추가 정보 유형입니다.

ErrorDetail

Object

오류 세부 정보입니다.

Name 형식 Description
additionalInfo

ErrorAdditionalInfo[]

오류 추가 정보입니다.
code

string

오류 코드입니다.
details

ErrorDetail[]

오류 세부 정보입니다.
message

string

오류 메시지입니다.
target

string

오류 대상입니다.

ErrorResponse

Object

오류 응답

Name 형식 Description
error

ErrorDetail

오류 개체입니다.

ManagedDatabaseRestoreDetailsBackupSetProperties

Object

관리되는 데이터베이스의 복원 세부 정보 백업 집합 속성입니다.

Name 형식 Description
backupSizeMB

integer (int32)

백업 크기입니다.
firstStripeName

string

첫 번째 스트라이프 이름입니다.
numberOfStripes

integer (int32)

줄무늬 수입니다.
restoreFinishedTimestampUtc

string (date-time)

마지막으로 복원된 파일 시간입니다.
restoreStartedTimestampUtc

string (date-time)

마지막으로 복원된 파일 시간입니다.
status

string

백업 설정 상태입니다.

ManagedDatabaseRestoreDetailsResult

Object

관리되는 데이터베이스 복원 세부 정보입니다.

Name 형식 Description
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[]

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 형식 Description
name

string

파일 이름입니다.

RestoreDetailsName

열거형

검색할 복원 세부 정보의 이름입니다.

값 Description
Default