Compartir a través de

Managed Database Restore Details - Get

  • Referencia
Servicio:
SQL Database
Versión de la API:
2023-08-01

Obtiene los detalles de restauración de bases de datos administradas.

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

Parámetros de identificador URI

Nombre En Requerido Tipo Description
databaseName
 path True

string

Nombre de la base de datos.
managedInstanceName
 path True

string

Nombre de la instancia administrada.
resourceGroupName
 path True

string

Nombre del grupo de recursos que contiene el recurso. Puede obtener este valor desde la API de Azure Resource Manager o el portal.
restoreDetailsName
 path True

RestoreDetailsName

Nombre de los detalles de restauración que se van a recuperar.
subscriptionId
 path True

string

Identificador de suscripción que identifica una suscripción de Azure.
api-version
 query True

string

Versión de la API que se va a usar para la solicitud.

Respuestas

Nombre Tipo Description
200 OK

ManagedDatabaseRestoreDetailsResult

Detalles de restauración recuperados correctamente.
Other Status Codes

ErrorResponse

Respuestas de error: ***

  • 400 RestoreDetailsNotAvailableOrExpired: los detalles de restauración solicitados no están disponibles o han expirado.

  • 400 TimeoutDuringRestore: se encontró un tiempo de espera al intentar conectarse al destino de restauración.

  • 400 AutoCompleteMissingLastBackupName: la solicitud de restauración completa automática debe tener el parámetro lastBackupName proporcionado.

  • 400 MissingThumbprint: no se puede encontrar el certificado de servidor.

  • 400 BlobStorageServerFailure: se ha producido un error en el servidor de Blob Storage.

  • 400 BackupSetNotFound: no se encontraron copias de seguridad para restaurar la base de datos. Póngase en contacto con el soporte técnico para restaurar la base de datos.

  • 400 FullBackupNotFound: no se puede encontrar copia de seguridad completa.

  • 400 RestoreFromStripedBackupsNotEnabled: no se admite la restauración a partir de copias de seguridad seccionadas.

  • 400 BrokenRestorePlanNoFullBackup: el plan de restauración está roto porque no hay ninguna copia de seguridad completa.

  • 400 BrokenRestorePlanWrongLogBackupLSN: el plan de restauración se interrumpe porque firstLsn de la copia de seguridad del registro actual no es <= lastLsn de la siguiente copia de seguridad de registros.

  • 400 BrokenRestorePlanWrongDiffBackupLSN: el plan de restauración se interrumpe porque firstLsn de copia de seguridad de diferencias no es >= firstLsn de copia de seguridad completa.

  • 400 BrokenRestorePlanGapInLogBackups: el plan de restauración se interrumpe porque firstLsn de la copia de seguridad del registro actual no es igual a lastLsn de la copia de seguridad del registro anterior.

  • 400 TargetServerDoesNotExist: el servidor de destino {0} no existe o aún no está listo. Compruebe que existe y vuelva a intentar la solicitud de restauración.

  • 400 TargetServerRestoreNotAllowed: el servidor de destino {0} no está actualmente en un estado que permita iniciar una restauración.

  • 400 XtpInitializedDuringRestore: el grupo de archivos optimizado para memoria debe estar vacío para restaurarse en el nivel De uso general de instancia administrada de SQL Database.

  • 400 FullBackupMissingChecksum: la copia de seguridad completa proporcionada falta en la suma de comprobación.

  • 400 FullBackupDamaged: se ha proporcionado una copia de seguridad completa dañada.

  • 400 MissingStripeInBackupSet: el conjunto de copia de seguridad proporcionado tiene una o varias franjas que faltan.

  • 400 Copias de seguridadFromMultipleDatabasesDetectedInTheContainerWhileRestoreInProgress: hay copias de seguridad de varias bases de datos en la carpeta contenedora. Asegúrese de que la carpeta contenedora tiene copias de seguridad de una base de datos única.{0}

  • 400 BrokenRestorePlanWrongDiffBaseGUID: el plan de restauración se interrumpe porque DifferentialBaseGuid de copia de seguridad diff no coincide con BackupSetGuid de copia de seguridad completa.

  • 400 CorruptedPagesInBackupSet: se anuló la operación porque RESTORE detectó una o varias páginas dañadas en el conjunto de copia de seguridad.

  • 400 ManagedIdentityIssueDetectedWhileRestoreInProgress: la identidad administrada no está configurada correctamente. Compruebe e inténtelo de nuevo.

  • 400 CorruptedPagesListMaintenance: se anuló la operación porque se produjo un error interno al procesar la copia de seguridad realizada sin suma de comprobación.

  • 400 StorageBrokenIssueDetectedWhileInProgress: se interrumpe la conexión de almacenamiento. Reintentar automáticamente...

  • 400 ParcialmenteContainedDatabaseUnsupported: "No se admite la copia de seguridad de una base de datos parcialmente independiente".

  • 400 RequiredBackupIsNotLastRestored: no se puede completar la migración porque el nombre del archivo de copia de seguridad proporcionado no es el nombre del último archivo de copia de seguridad que se restaura.

  • 400 ManagedInstanceStorageLimitHit: la instancia administrada ha alcanzado su límite de almacenamiento.

  • 400 IncompatiblePhysicalLayoutTooFewDataFiles: la copia de seguridad de la base de datos contiene un diseño físico incompatible. No se encuentra ningún archivo de datos en la copia de seguridad.

  • 400 IncompatiblePhysicalLayoutNonOnlineDataFilesExist: la copia de seguridad de la base de datos contiene un diseño físico incompatible. Existen archivos de datos que no son en línea.

  • 400 IncompatiblePhysicalLayoutWrongNumberOfLogFiles: la copia de seguridad de la base de datos contiene un diseño físico incompatible. No se admiten varios archivos de registro.

  • 400 IncompatiblePhysicalLayoutNonOnlineLogFilesExist: la copia de seguridad de la base de datos contiene un diseño físico incompatible. Existen archivos de registro no en línea.

  • 400 IncompatiblePhysicalLayoutTooManyNonDataLogFiles: la copia de seguridad de la base de datos contiene un diseño físico incompatible. Demasiados archivos que no son de datos o de registro.

  • 400 ExternalBackupAlreadySignaledToComplete: la solicitud de restauración ya se ha señalado para completarse.

  • 400 ExternalBackupRestoreHasNotBeenStarted: la solicitud de restauración solo se puede completar una vez iniciada la restauración.

  • 400 ExternalBackupUpGradeInProgress: no se puede completar la solicitud de restauración, ya que la actualización está en curso.

  • 400 IncompatiblePhysicalLayoutTooManyXTPFiles: la copia de seguridad de la base de datos contiene un diseño físico incompatible. Varios archivos encontrados en el grupo de archivos que contiene MEMORY_OPTIMIZED_DATA.

  • 400 BlobStorageFailure: se ha producido un error de Blob Storage.

  • 400 BackupsFromMultipleDatabasesDetectedInTheContainerFromTheStart: hay copias de seguridad de varias bases de datos en la carpeta contenedora. Asegúrese de que la carpeta contenedora tiene copias de seguridad de una base de datos única.{0}

  • 400 ManagedIdentityIssueDetectedFromTheStart: la identidad administrada no está configurada correctamente. Compruebe e inténtelo de nuevo.

  • 400 StorageBrokenIssueDetectedAtTheStart: la conexión de almacenamiento está interrumpida. Compruebe e inténtelo de nuevo.

  • 400 StorageBrokenIssueDetectedTerminateRetries: la conexión de almacenamiento sigue interrumpida. Compruebe e inténtelo de nuevo.

  • 400 BackupSetBroken: el conjunto de copia de seguridad está roto.

  • 400 SqlRestoreError: error que no se puede reintentar al restaurar la copia de seguridad.

  • 400 ManagedDatabaseNotInRestoringState: la base de datos administrada no está en estado de restauración.

Ejemplos

Managed database restore details.

Solicitud de ejemplo

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

Respuesta de muestra

status code:
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"
}

Definiciones

Nombre Description
ErrorAdditionalInfo

Información adicional sobre el error de administración de recursos.
ErrorDetail

Detalle del error.
ErrorResponse

Respuesta de error
ManagedDatabaseRestoreDetailsBackupSetProperties

Las propiedades del conjunto de copia de seguridad de detalles de restauración de la base de datos administrada.
ManagedDatabaseRestoreDetailsResult

Detalles de restauración de una base de datos administrada.
ManagedDatabaseRestoreDetailsUnrestorableFileProperties

La restauración de la base de datos administrada detalla las propiedades de archivo que se pueden recuperar.
RestoreDetailsName

Nombre de los detalles de restauración que se van a recuperar.

ErrorAdditionalInfo

Object

Información adicional sobre el error de administración de recursos.

Nombre Tipo Description
info

object

Información adicional.
type

string

Tipo de información adicional.

ErrorDetail

Object

Detalle del error.

Nombre Tipo Description
additionalInfo

ErrorAdditionalInfo[]

Información adicional del error.
code

string

Código de error.
details

ErrorDetail[]

Detalles del error.
message

string

Mensaje de error.
target

string

Destino del error.

ErrorResponse

Object

Respuesta de error

Nombre Tipo Description
error

ErrorDetail

Objeto de error.

ManagedDatabaseRestoreDetailsBackupSetProperties

Object

Las propiedades del conjunto de copia de seguridad de detalles de restauración de la base de datos administrada.

Nombre Tipo Description
backupSizeMB

integer (int32)

Tamaño de copia de seguridad.
firstStripeName

string

Nombre de primera franja.
numberOfStripes

integer (int32)

Número de franjas.
restoreFinishedTimestampUtc

string (date-time)

Hora del archivo restaurado por última vez.
restoreStartedTimestampUtc

string (date-time)

Hora del archivo restaurado por última vez.
status

string

Estado del conjunto de copia de seguridad.

ManagedDatabaseRestoreDetailsResult

Object

Detalles de restauración de una base de datos administrada.

Nombre Tipo Description
id

string

Identificador de recurso.
name

string

Nombre del recurso.
properties.blockReason

string

El motivo por el que la restauración está en estado Bloqueado.
properties.currentBackupType

string

Tipo de copia de seguridad actual.
properties.currentRestorePlanSizeMB

integer (int32)

MB de tamaño del plan de restauración actual.
properties.currentRestoredSizeMB

integer (int32)

Mb de tamaño restaurado actual.
properties.currentRestoringFileName

string

Nombre de archivo de restauración actual.
properties.diffBackupSets

ManagedDatabaseRestoreDetailsBackupSetProperties[]

Conjuntos de copia de seguridad de diferencias.
properties.fullBackupSets

ManagedDatabaseRestoreDetailsBackupSetProperties[]

Conjuntos de copia de seguridad completos.
properties.lastRestoredFileName

string

Nombre de archivo restaurado por última vez.
properties.lastRestoredFileTime

string (date-time)

Hora del archivo restaurado por última vez.
properties.lastUploadedFileName

string

Nombre de archivo cargado por última vez.
properties.lastUploadedFileTime

string (date-time)

Hora del archivo cargado por última vez.
properties.logBackupSets

ManagedDatabaseRestoreDetailsBackupSetProperties[]

Conjuntos de copia de seguridad de registros.
properties.numberOfFilesDetected

integer (int32)

Número de archivos detectados.
properties.numberOfFilesQueued

integer (int32)

Número de archivos en cola.
properties.numberOfFilesRestored

integer (int32)

Número de archivos restaurados.
properties.numberOfFilesRestoring

integer (int32)

Número de archivos que se restauran.
properties.numberOfFilesSkipped

integer (int32)

Número de archivos omitidos.
properties.numberOfFilesUnrestorable

integer (int32)

Número de archivos que no se pueden modificar.
properties.percentCompleted

integer (int32)

Porcentaje completado.
properties.status

string

Estado de restauración.
properties.type

string

Tipo de restauración.
properties.unrestorableFiles

ManagedDatabaseRestoreDetailsUnrestorableFileProperties[]

Archivos sin problemas.
type

string

Tipo de recurso.

ManagedDatabaseRestoreDetailsUnrestorableFileProperties

Object

La restauración de la base de datos administrada detalla las propiedades de archivo que se pueden recuperar.

Nombre Tipo Description
name

string

Nombre de archivo.

RestoreDetailsName

Enumeración

Nombre de los detalles de restauración que se van a recuperar.

Valor Description
Default