Managed Databases - Complete Restore

Service:

SQL Database

API Version:

2021-11-01

Termine l’opération de restauration sur une base de données managée.

POST https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Sql/managedInstances/{managedInstanceName}/databases/{databaseName}/completeRestore?api-version=2021-11-01

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
databaseName	path	True	string	Nom de la base de données.
managedInstanceName	path	True	string	Nom de l'instance managée.
resourceGroupName	path	True	string	Nom du groupe de ressources qui contient la ressource. Vous pouvez obtenir cette valeur à partir de l’API Azure Resource Manager ou du portail.
subscriptionId	path	True	string	L’ID d’abonnement d’un abonnement Azure.
api-version	query	True	string	Version de l’API à utiliser pour la requête.

Corps de la demande

Nom	Obligatoire	Type	Description
lastBackupName	True	string	Nom de la dernière sauvegarde à appliquer

Réponses

Nom	Type	Description
200 OK		Demande de restauration terminée avec succès.
202 Accepted		La demande de restauration est en cours.
Other Status Codes		Réponses d’erreur : *** 400 InvalidDatabaseCompleteRestoreRequest - La demande de restauration de base de données complète n’est pas valide 400 InvalidDatabaseCompleteRestoreRequestLastBackupName - Le nom de la dernière sauvegarde n’est pas valide 400 InvalidIdentifier : l’identificateur contient NULL ou un caractère Unicode non valide. 400 SourceDatabaseNotFound : la base de données source n’existe pas. 400 TokenTooLong : le jeton fourni est trop long. 400 UnsupportedServiceName : le nom spécifié est un nom non valide, car il contient un ou plusieurs caractères Unicode non pris en charge. 400 TargetServerDoesNotExist : le serveur {0} cible n’existe pas ou n’est pas encore prêt. Veuillez case activée qu’il existe et réessayez la demande de restauration. 400 TargetServerRestoreNotAllowed : le serveur {0} cible n’est actuellement pas dans un état qui permet de démarrer une restauration. 400 BackupSetNotFound : aucune sauvegarde n’a été trouvée pour restaurer la base de données. Contactez le support technique pour restaurer la base de données. 400 FullBackupNotFound - La sauvegarde complète est introuvable. 400 MissingThumbprint : certificat de serveur introuvable. 400 RestoreFromStripedBackupsNotEnabled : la restauration à partir de sauvegardes entre bandes n’est pas prise en charge. 400 BackupSetBroken - L’ensemble de sauvegarde est rompu. 400 BrokenRestorePlanNoFullBackup : le plan de restauration est rompu, car il n’y a pas de sauvegarde complète. 400 SqlRestoreError - Une erreur non retriable s’est produite lors de la restauration de la sauvegarde avec l’index {0} - {1}{2} 400 BrokenRestorePlanWrongLogBackupLSN : le plan de restauration est rompu, car le premierLsn de la sauvegarde du journal actuel n’est pas <= lastLsn de la sauvegarde du journal suivante. 400 BrokenRestorePlanWrongDiffBackupLSN : le plan de restauration est rompu, car firstLsn de diff sauvegarde n’est pas >= firstLsn de sauvegarde complète. 400 BrokenRestorePlanGapInLogBackups : le plan de restauration est rompu, car le premierLsn de la sauvegarde actuelle du journal n’est pas égal à lastLsn de la sauvegarde du journal antérieur. 400 PartiellementContainedDatabaseUnsupported : « La sauvegarde d’une base de données partiellement autonome n’est pas prise en charge ». 400 RequiredBackupIsNotLastRestored - Impossible de terminer la migration, car le nom du fichier de sauvegarde fourni n’est pas le nom du dernier fichier de sauvegarde restauré. 400 XtpInitializedDuringRestore : le groupe de fichiers à mémoire optimisée doit être vide pour être restauré sur usage général niveau de SQL Database Managed Instance. 400 FullBackupMissingChecksum : la somme de contrôle est manquante pour la sauvegarde complète. 400 FullBackupDamaged : la sauvegarde complète est endommagée. 400 MissingStripeInBackupSet : le jeu de sauvegarde fourni a une ou plusieurs bandes manquantes. 400 BrokenRestorePlanWrongDiffBaseGUID : le plan de restauration est rompu, car DifferentialBaseGuid de diff sauvegarde ne correspond pas à BackupSetGuid de la sauvegarde complète. 400 IncompatiblePhysicalLayoutTooFewDataFiles - La sauvegarde de base de données contient une disposition physique incompatible. Aucun fichier de données n’est trouvé dans la sauvegarde. 400 CorruptedPagesInBackupSet : l’opération a été abandonnée, car RESTORE a détecté une ou plusieurs pages endommagées dans le jeu de sauvegarde. 400 IncompatiblePhysicalLayoutNonOnlineDataFilesExist - La sauvegarde de base de données contient une disposition physique incompatible. Il existe des fichiers de données non en ligne. 400 CorruptedPagesListMaintenance : l’opération a été abandonnée car une erreur interne s’est produite lors du traitement de la sauvegarde effectuée sans somme de contrôle. 400 IncompatiblePhysicalLayoutWrongNumberOfLogFiles - La sauvegarde de base de données contient une disposition physique incompatible. Les fichiers journaux multiples ne sont pas pris en charge. 400 IncompatiblePhysicalLayoutNonOnlineLogFilesExist - La sauvegarde de base de données contient une disposition physique incompatible. Il existe des fichiers journaux non en ligne. 400 IncompatiblePhysicalLayoutTooManyNonDataLogFiles - La sauvegarde de base de données contient une disposition physique incompatible. Trop de fichiers non-données/journaux. 400 ExternalBackupAlreadySignaledToComplete : la demande de restauration a déjà été signalée comme terminée. 400 ExternalBackupRestoreHasNotBeenStarted : la demande de restauration ne peut être effectuée qu’une fois la restauration démarrée. 400 ExternalBackupUpgradeInProgress : la demande de restauration ne peut pas être effectuée, car la mise à niveau est en cours. 400 IncompatiblePhysicalLayoutTooManyXTPFiles - La sauvegarde de base de données contient une disposition physique incompatible. Plusieurs fichiers trouvés dans le groupe de fichiers qui contient MEMORY_OPTIMIZED_DATA. 400 BlobStorageFailure - Échec du stockage d’objets blob. 400 BackupsFromMultipleDatabasesDetectedInTheContainerFromTheStart : il existe des sauvegardes à partir de plusieurs bases de données dans le dossier conteneur. Vérifiez que le dossier conteneur contient des sauvegardes à partir d’une base de données unique.{0} 400 ManagedIdentityIssueDetectedFromTheStart : l’identité managée n’est pas configurée correctement. Vérifiez et réessayez. 400 ManagedInstanceStorageLimitHit : le instance managé a atteint sa limite de stockage. 400 AutoCompleteMissingLastBackupName : le paramètre lastBackupName doit être fourni pour la demande de restauration automatique. 400 BlobStorageServerFailure - Échec du serveur de stockage Blob. 400 BackupsFromMultipleDatabasesDetectedInTheContainerWhileRestoreInProgress : il existe des sauvegardes à partir de plusieurs bases de données dans le dossier conteneur. Vérifiez que le dossier conteneur contient des sauvegardes à partir d’une base de données unique.{0} 400 ManagedIdentityIssueDetectedWhileRestoreInProgress : l’identité managée n’est pas configurée correctement. Vérifiez et réessayez. 404 ResourceDoesNotExist : la ressource portant le nom «{0} » n’existe pas. Pour continuer, spécifiez un nom de ressource valide. 404 OperationIdNotFound : l’opération avec ID n’existe pas. 409 OperationCancelled : l’opération a été annulée par l’utilisateur. 409 Opération interrompue : l’opération sur la ressource n’a pas pu être terminée, car elle a été interrompue par une autre opération sur la même ressource. 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyCreateUpdateRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles. 429 SubscriptionTooManyRequests : demandes au-delà du nombre maximal de requêtes pouvant être traitées par les ressources disponibles. 500 OperationTimedOut : l’opération a expiré et a été restaurée automatiquement. Réessayez l’opération. 503 TooManyRequests : demandes au-delà du nombre maximal de demandes pouvant être traitées par les ressources disponibles.

Exemples

Completes a managed database external backup restore.

Sample Request

HTTP

POST https://management.azure.com/subscriptions/00000000-1111-2222-3333-444444444444/resourceGroups/myRG/providers/Microsoft.Sql/managedInstances/myManagedInstanceName/databases/myDatabase/completeRestore?api-version=2021-11-01

{
  "lastBackupName": "testdb1_log4"
}

Java

import com.azure.core.util.Context;
import com.azure.resourcemanager.sql.models.CompleteDatabaseRestoreDefinition;

/** Samples for ManagedDatabases CompleteRestore. */
public final class Main {
    /*
     * x-ms-original-file: specification/sql/resource-manager/Microsoft.Sql/stable/2021-11-01/examples/
     * ManagedDatabaseCompleteExternalRestore.json
     */
    /**
     * Sample code: Completes a managed database external backup restore.
     *
     * @param azure The entry point for accessing resource management APIs in Azure.
     */
    public static void
        completesAManagedDatabaseExternalBackupRestore(com.azure.resourcemanager.AzureResourceManager azure) {
        azure.sqlServers().manager().serviceClient().getManagedDatabases().completeRestore("myRG",
            "myManagedInstanceName", "myDatabase",
            new CompleteDatabaseRestoreDefinition().withLastBackupName("testdb1_log4"), Context.NONE);
    }
}

To use the Azure SDK library in your project, see this documentation. To provide feedback on this code sample, open a GitHub issue

Sample Response

Status code:

200

Status code:

202

Définitions

CompleteDatabaseRestoreDefinition

Contient les informations nécessaires pour effectuer une opération de restauration de base de données complète.

Nom	Type	Description
lastBackupName	string	Nom de la dernière sauvegarde à appliquer