Tous les produits
Search
Centre de documentation

:Répliquer des bases de données

Dernière mise à jour :Aug 19, 2026

Appelez l'opération CopyDatabaseBetweenInstances pour répliquer des bases de données d'une instance vers une autre.

Vous pouvez également utiliser cette opération pour restaurer des bases de données spécifiques sur une instance existante à partir d'un instant précis ou d'un jeu de sauvegarde. Pour plus d'informations, consultez la rubrique Restaurer les données d'une instance ApsaraDB RDS for SQL Server.

Avant d'appeler cette opération, vérifiez que les conditions suivantes sont remplies :

  • Les instances source et de destination appartiennent au même compte.

  • Les instances source et de destination exécutent la même version du moteur de base de données.

  • Les instances source et de destination se trouvent dans la même région et utilisent le même type de réseau. Leurs zones peuvent différer.

  • Les instances source et de destination ne contiennent pas de bases de données portant le même nom.

  • L'espace de stockage disponible de l'instance de destination est supérieur à la taille totale des bases de données à répliquer depuis l'instance source.

    Remarque

    Cette opération s'applique uniquement aux instances exécutant SQL Server 2012 ou une version ultérieure.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de la signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. OpenAPI Explorer génère dynamiquement des exemples de code pour différents SDK.

Paramètres de requête

Parameter Type Required Example Description
Action String Yes CopyDatabaseBetweenInstances

Opération à effectuer. Définissez la valeur sur CopyDatabaseBetweenInstances.

DBInstanceId String Yes rm-uf6wjk5xxxxxxx

ID de l'instance source.

TargetDBInstanceId String Yes rm-ut5ajk3xxxxxxx

ID de l'instance de destination. Il doit être différent de celui de l'instance source.

DbNames String Yes {"test1":"newtest1","test2":"newtest2"}

Noms des bases de données. Format : {"Nom de la base de données d'origine 1":"Nouveau nom de la base de données 1","Nom de la base de données d'origine 2":"Nouveau nom de la base de données 2"}.

BackupId String No 106523874****

ID du jeu de sauvegarde utilisé pour restaurer les bases de données de l'instance source. Lors de la réplication par jeu de sauvegarde, appelez l'opération DescribeBackups pour obtenir l'ID du jeu de sauvegarde.

Remarque Spécifiez uniquement l'un des paramètres BackupId ou RestoreTime.
RestoreTime String No 2011-06-11T16:00:00Z

Instant de réplication des bases de données. Sélectionnez un instant dans la période de rétention des sauvegardes. Spécifiez l'heure au format ISO 8601 yyyy-MM-ddTHH:mm:ssZ (UTC).

Remarque Spécifiez uniquement l'un des paramètres BackupId ou RestoreTime.
SyncUserPrivilege String No NO

Indique s'il faut copier les utilisateurs et les autorisations.

  • YES : copie les utilisateurs et les autorisations. Si l'instance de destination contient un utilisateur portant le même nom qu'un utilisateur de l'instance source, les autorisations de ce dernier sont accordées à l'utilisateur de l'instance de destination après la copie.
  • NO : ne copie pas les utilisateurs et les autorisations.

Valeur par défaut : NO.

Paramètres de réponse

Parameter

Type

Example

Description

RequestId

String

803D11AF-C370-465B-AB46-CB3A642DC303

ID de la requête.

Exemples

Exemples de requêtes

http(s)://rds.aliyuncs.com/?Action=CopyDatabaseBetweenInstances
&DBInstanceId=rm-uf6wjk5xxxxxxx
&TargetDBInstanceId=rm-ut5ajk3xxxxxxx
&DbNames={"test1":"newtest1","test2":"newtest2"}
&BackupId=106523874****
&RestoreTime=2011-06-11T16:00:00Z
&SyncUserPrivilege=NO
&Common request parameters

Exemples de réponses réussies

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<CopyDatabaseBetweenInstancesResponse>
    <RequestId>803D11AF-C370-465B-AB46-CB3A642DC303</RequestId>
</CopyDatabaseBetweenInstancesResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "803D11AF-C370-465B-AB46-CB3A642DC303"
}

Codes d'erreur

HTTP status code

Error code

Error message

Description

400

InvalidBackupSetID

Invalid backup set id.

Le jeu de sauvegarde n'existe pas. Appelez l'opération DescribeBackups pour interroger les jeux de sauvegarde existants d'une instance.

400

DBCountLimitExceeded

Db count limit exceeded.

Le nombre de bases de données dépasse la limite supérieure.

400

BackupRestoreNotSupported.BasicHA

Basic instances cannot be restored to high availability instances, and high availability instances cannot be restored to basic instances.

Les données ne peuvent pas être restaurées d'une instance RDS Basic Edition vers une instance RDS High-availability Edition, et vice versa.

400

BackupRestoreNotSupported.HADedicatedAlwaysOn

High availability instances cannot be restored to dedicated cluster instances or AlwaysOn instances.

Les données d'une instance RDS High-availability Edition ne peuvent pas être restaurées vers une instance déployée dans un cluster dédié ou exécutant RDS Enterprise Edition.

400

BackupRestoreNotSupported.ShareDedicatedAlwaysOn

Shared instances cannot be restored to dedicated cluster instances, AlwaysOn instances, or high availability instances.

Les données d'une instance partagée ne peuvent pas être restaurées vers une instance déployée dans un cluster dédié ou vers une instance RDS exécutant RDS Enterprise Edition ou RDS High-availability Edition.

400

OperationDenied.RestoreTime

The instance with snapshot backup enabled can only be restored to the instance with snapshot backup enabled.

Les données d'une instance pour laquelle la fonction de sauvegarde instantanée est activée ne peuvent être restaurées que vers une autre instance avec cette fonction activée.

400

OperationDenied.SnapshotBackupSet

Snapshot backup set can only be restored to the instance with snapshot backup enabled.

Lorsque vous restaurez les données d'une instance avec sauvegarde instantanée activée vers une autre instance similaire, assurez-vous que le type du jeu de sauvegarde de l'instance est « snapshot ».

400

CanNotCopyDBHasTDEEnabled

The source database has enabled the TDE feature. You cannot copy it to another instance.

Les données de l'instance source ne peuvent pas être répliquées vers une autre instance lorsque Transparent Data Encryption (TDE) est activé sur l'instance source.

400

InvalidBackupDBNames.NotFound

The specified BackupDBNames is not found.

Le nom de l'instance n'est pas spécifié.

400

InvalidBackupDBNames.Malformed

The specified backup database is not valid.

La base de données spécifiée pour la sauvegarde n'est pas valide.

400

InvalidDBName.Format

Specified DB name is not valid.

Le nom de la base de données n'est pas valide. Spécifiez un nom valide. Le nom peut comporter jusqu'à 16 caractères (lettres minuscules, chiffres et traits de soulignement [_]). Il doit commencer par une lettre minuscule et se terminer par une lettre minuscule ou un chiffre.

400

InvalidDBInstanceName.NotFound

Invalid DBInstanceId NotFound.

L'ID de l'instance est introuvable.

400

EngineNotSupported

The engine does not support the operation.

L'opération n'est pas prise en charge pour le moteur de base de données exécuté sur l'instance.

400

InvalidTargetDBInstanceName.Format

Specified Target DB instance name is not valid.

Le nom de l'instance de destination est incorrect.

400

MasterDBInstanceState.NotSupport

The Master instance state does not support this operation.

L'opération n'est pas prise en charge dans l'état actuel de l'instance.

400

TargetInstanceEngineNotSupported

The specified Engine cannot be supported the operation.

Le moteur de base de données ne prend pas en charge l'opération.

400

InvalidInstancesRegion.Malformed

The instance region is not the same as the target instance region.

La région de l'instance de destination diffère de celle de l'instance source.

400

InvalidStartTime.Format

The specified parameter "StartTime" is not valid.

Le format de l'heure de début est incorrect. Spécifiez l'heure au format GMT AAAA-MM-JJThh:mmZ. Exemples : DescribeDBInstancePerformance : 2012-06-11T15:00Z. DescribeErrorLogs : 2011-06-11T16:00Z.

400

InvalidEndTime.Format

The specified parameter "EndTime" is not valid.

Le format de l'heure de fin n'est pas valide. Spécifiez l'heure au format GMT AAAA-MM-JJThh:mmZ. Exemple : 2012-06-11T15:00Z.

400

InvalidParameterCombination

The end time must be greater than the start time

L'heure de fin doit être postérieure à l'heure de début.

400

InvalidBackupSetLocation.Format

Specified backup set location is not valid.

Le répertoire spécifié du jeu de sauvegarde n'est pas valide.

400

InvalidCrossRegionTrans

Cross region instance trans is not supported

L'instance source et l'instance de destination se trouvent dans des régions différentes.

400

ErrorParametersConflict

Parameter BackupsetID and restoretime can only exist one.

Spécifiez uniquement le paramètre BackupID ou Restoretime.

400

InvalidDBName.NotFound

Specified DB name does not exist.

Le nom d'utilisateur du compte de base de données spécifié n'existe pas. Saisissez un nom d'utilisateur correct.

400

InvalidDBName.Duplicate

Specified DB name already exists in the This instance.

Le nom de la base de données spécifiée existe déjà dans l'instance. Modifiez-le.

400

ReadDBInstanceNotSupport

The operation is not permitted due to type of the instance.

Les instances en lecture seule ne prennent pas en charge l'opération.

400

InvalidRecoveryDbInstance.StorageSize

The disk space of the new instance cannot be less than that of the current instance

L'espace de stockage disponible de l'instance de destination doit être supérieur ou égal à la taille totale des données stockées dans l'instance source.

400

InvalidRecoveryDBNames.Format

The specified parameter DBNames is not valid.

Le nom de l'instance n'est pas valide. Vérifiez-le.

400

InvalidBackupIdOrRestoreTime.NotFound

The specified parameter BackupId or RestoreTime is not valid.

La valeur du paramètre BackupId ou RestoreTime n'est pas valide.

400

Forbidden.RegionNotFound

The provided RegionId does not exist in our record.

L'ID de région spécifié est introuvable.

400

ImageNotFound

The specified Image is disabled or is deleted.

L'image spécifiée est désactivée ou supprimée.

400

InvalidZone.NotSupportedForStorageType

The specified zone is closed or invalid for Specified DBInstanceStorageType.

La zone spécifiée n'est plus disponible ou la valeur du paramètre DBInstanceStorageType n'est pas valide.

400

InvalidEngineOrEngineVersion

The specified params engine or engineVersion should not be null.

Le paramètre Engine ou EngineVersion a la valeur null.

400

InvalidGeneralGroupNameOrGdnInstanceName

The specified params generalGroupName or gdnInstanceName should not be null.

Le paramètre generalGroupName ou gdInsttanceName est vide.

400

InvalidVSwitchId.NotFound

Specified virtual switch is not found in specified VPC.

Aucun vSwitch n'est disponible dans le cloud privé virtuel (VPC).

400

CDDC.TargetHostIDNotAvailable

The target host ID is not available.

L'hôte n'est pas disponible. Spécifiez un autre hôte.

400

CDDC.AvailableHostsNotEnoughInZone

Not enough available hosts are in the target zone.

Aucun hôte n'est disponible dans la zone spécifiée. Créez un hôte dans la zone et réessayez.

400

ReadOnlyInstanceNotSupport

Specified ReadOnly Instance not support this operation.

Les instances en lecture seule ne prennent pas en charge l'opération.

400

InvalidShareDbInstanceClassNotSupport

The current instance classType is not support operation.

Le type d'instance spécifié ne prend pas en charge l'opération.

400

InvalidQuantity.NotSupported

The specified instance quantity is not supported.

Le nombre d'instances dépasse la limite supérieure. Vérifiez-le.

400

IncorrectMasterDBInstanceState

Master instance state does not support this operation.

L'opération n'est pas prise en charge dans l'état actuel de l'instance principale.

400

InvalidDBInstance.ReadDBInstanceExceeded

Current DB Instance exceeding the allowed amount of read instance.

Le nombre d'instances en lecture seule dépasse la limite supérieure. Réduisez ce nombre. Si la mémoire d'une instance MySQL dépasse 64 Go, vous pouvez créer jusqu'à 10 instances en lecture seule. Sinon, la limite est de cinq instances.

400

InvalidEngineVersion.Malformed

Specified engine version is not valid.

La version spécifiée du moteur de base de données n'est pas valide. Vérifiez-la et réessayez.

400

InvalidEssdStorageSize

The cloud ESSD storage size is invalid.

La capacité de stockage spécifiée pour l'instance avec des SSD standard ou des SSD améliorés (ESSD) n'est pas valide. Sélectionnez une capacité valide et réessayez.

400

IncorrectInstanceNetworkType

The specified parameter InstanceNetworkType is not valid.

La valeur du paramètre InstanceNetworkType n'est pas valide.

400

AtLeastTwoVSwitchParamExists

The specified params(Vswitchs) at least two.

Spécifiez au moins deux valeurs pour le paramètre Vswitchs. Assurez-vous que le nombre de vSwitches correspond à celui des zones.

403

StorageLimitExceeded

Exceeding the allowed Storage of DB instance.

La nouvelle capacité de stockage dépasse la limite supérieure. Libérez de l'espace disque.

403

InvalidTempInstance.NotSupport

The temp db Instance is not support.

L'instance est verrouillée.

403

IncorrectDBInstanceState

The current database instance state does not support the operation.

L'opération n'est pas prise en charge dans l'état actuel de l'instance. Vérifiez si l'instance est dans l'état Running.

403

IncorrectDBInstanceType

Current DB instance engine and type does not support operations.

Le moteur de base de données et le type d'instance ne prennent pas en charge l'opération.

403

Forbidden.SnapshotRecovery

Snapshot backup does not support partial restore

Les sauvegardes instantanées ne permettent pas de restaurer uniquement une partie spécifique des données.

403

OperationDenied.Resource

Specified DB instance class or storage is not available in all Availability Zones.

L'inventaire des ressources est insuffisant. Modifiez le type d'instance et la capacité de stockage, puis réessayez.

403

ReadonlyDBInstanceStorageExceeded

You can not create the order with the db instance because The masterInstance storage value exceeding the readonlyInstance storage value.

La capacité de stockage de l'instance principale est supérieure à celle de son instance en lecture seule. Vous ne pouvez pas créer de commande avec cette instance.

403

MasterDBInstanceClassNotSupport

You can not create the readonly instance with the db instance class does not support.

Impossible de créer l'instance en lecture seule car le paramètre n'est pas pris en charge par l'instance principale.

403

ReadonlyDBInstanceClassNotSupport

You can not create the readonly instance with the master instance class does not support.

Impossible de créer l'instance en lecture seule car l'option n'est pas prise en charge par l'instance.

403

ReadonlyDBInstanceClassLowerThanMasterInstance

The readonly instance db instance class are lower than master instance db instance class.

Les spécifications de l'instance en lecture seule sont inférieures à celles de l'instance principale.

403

InvalidSwitchType.Malformed

The specified parameter InvalidSwitchType is not valid.

La valeur du paramètre InvalidSwitchType n'est pas valide.

403

UnsupportedCopyDbHighAvailabilityToBasic

Replicate Database from RDS Category:HighAvailability to RDS Category:Basic is not supported.

La réplication de la base de données d'une instance RDS High-availability Edition vers une instance RDS Basic Edition n'est pas prise en charge.

403

InvalidInstanceVersion

Source instance version is greater than the target instance version.

La version du moteur de base de données de l'instance source est plus récente que celle de l'instance de destination.

403

UnsupportedCopyDbShareToHighAvailability

Replicate Database from RDS Category:Share to RDS Category:HighAvailability is not supported.

La réplication de la base de données d'une instance partagée vers une instance RDS High-availability Edition n'est pas prise en charge.

403

UnsupportedCopyDbAlwaysOnToBasic

Replicate Database from RDS Category:AlwaysOn to RDS Category:Basic is not supported.

La réplication de la base de données d'une instance RDS Cluster Edition vers une instance RDS Basic Edition n'est pas prise en charge.

403

UnsupportedCopyDbBasicToShare

Replicate Database from RDS Category:Basic to RDS Category:Share is not supported.

La réplication de la base de données d'une instance RDS Basic Edition vers une instance partagée n'est pas prise en charge.

403

UnsupportedCopyDbAlwaysOnToHighAvailability

Replicate Database from RDS Category:AlwaysOn to RDS Category:HighAvailability is not supported.

La réplication de la base de données d'une instance RDS Cluster Edition vers une instance RDS High-availability Edition n'est pas prise en charge.

403

UnsupportedCopyDbShareToBasic

Replicate Database from RDS Category:Share to RDS Category:Basic is not supported.

La réplication de la base de données d'une instance partagée vers une instance RDS Basic Edition n'est pas prise en charge.

403

UnsupportedCopyDbHighAvailabilityToShare

Replicate Database from RDS Category:HighAvailability to RDS Category:Share is not supported.

La réplication de la base de données d'une instance RDS High-availability Edition vers une instance partagée n'est pas prise en charge.

403

UnsupportedCopyDbShareToAlwaysOn

Replicate Database from RDS Category:Share to RDS Category:AlwaysOn is not supported.

La réplication de la base de données d'une instance partagée vers une instance RDS Cluster Edition n'est pas prise en charge.

403

UnsupportedCopyDbAlwaysOnToShare

Replicate Database from RDS Category:AlwaysOn to RDS Category:Share is not supported.

La réplication de la base de données d'une instance RDS Cluster Edition vers une instance partagée n'est pas prise en charge.

403

InvalidParamTableMeta.RestoreTime

There are databases created later than the last full backup at the instance level, point-in-time restore is not possible, try to restore using a backup set or pick another database restore time.

La base de données à restaurer a été créée après la dernière sauvegarde complète. La restauration à un instant précis est impossible. Nous vous recommandons de restaurer les données à partir d'un jeu de sauvegarde ou de choisir une autre base de données répondant aux exigences.

404

InvalidDBInstance.NotFound

The specified instance does not exist or is not supported.

L'instance spécifiée est introuvable. Vérifiez son ID.

404

InvalidInstanceStorageType.NotFound

The specified DBInstanceStorageType is not found.

Le paramètre InstanceStorageType n'est pas spécifié. Spécifiez-le.

404

InvalidRegion.NotFound

Specified Region does not exist in the RDS

L'ID de région n'est pas valide.

404

IncorrectVswitchId

The specified parameter VSwitchId is not valid.

La valeur du paramètre VSwitchId n'est pas valide.

404

InsufficientResourceCapacity

Current cluster resources are insufficient. Try again later.

L'inventaire des ressources dans le cluster est insuffisant. Réessayez ultérieurement.

Pour obtenir la liste des codes d'erreur, consultez les Codes d'erreur de service.