Restaurer des données vers une nouvelle instance dans une autre région -

Appelez l'opération CreateDdrInstance pour restaurer les données d'une instance vers une nouvelle instance située dans une autre région.

Avant d'appeler cette opération, utilisez l'opération CheckCreateDdrDBInstance pour vérifier si les données de l'instance source peuvent être restaurées à partir d'un fichier de sauvegarde interrégional.

Assurez-vous que l'instance utilise l'un des moteurs de base de données suivants :

MySQL. Pour plus d'informations, consultez la rubrique Sauvegarder une instance ApsaraDB RDS for MySQL dans une autre région .
SQL Server. Pour plus d'informations, consultez la rubrique Sauvegarder une instance ApsaraDB RDS for SQL Server dans une autre région .
PostgreSQL. Pour plus d'informations, consultez la rubrique Sauvegarder une instance ApsaraDB RDS for PostgreSQL dans une autre région .

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération via OpenAPI Explorer pour plus de commodité. 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	CreateDdrInstance	Opération à effectuer. Définissez la valeur sur CreateDdrInstance.
RegionId	String	Yes	cn-hangzhou	ID de région de l'instance de destination. Appelez l'opération DescribeRegions pour obtenir la liste des régions les plus récentes.
Engine	String	Yes	MySQL	Moteur de base de données de l'instance de destination. Valeurs possibles : MySQL SQLServer PostgreSQL
EngineVersion	String	Yes	5,6	Version majeure du moteur de l'instance de destination. La valeur de ce paramètre varie en fonction de la valeur du paramètre Engine. Valeurs possibles : Si le paramètre Engine est défini sur MySQL : 5,5, 5,6, 5,7 et 8,0 Si le paramètre Engine est défini sur SQL Server : 2008r2, 08r2_ent_ha, 2012, 2012_ent_ha, 2012_std_ha, 2012_web, 2014_std_ha, 2016_ent_ha, 2016_std_ha, 2016_web, 2017_std_ha, 2017_ent, 2019_std_ha et 2019_ent Si le paramètre Engine est défini sur PostgreSQL : 9,4, 10,0, 11,0, 12,0 et 13,0
DBInstanceClass	String	Yes	rds.mysql.s1.small	Type d'instance de l'instance de destination. Pour plus d'informations, consultez la rubrique Types d'instances principales ApsaraDB RDS.
DBInstanceStorage	Integer	Yes	20	Capacité de stockage de l'instance de destination. Valeurs possibles : 5 à 2000. Unité : Go. Cette valeur doit être un multiple de 5 Go. Pour plus d'informations, consultez la rubrique Types d'instances principales ApsaraDB RDS.
SystemDBCharset	String	No	uft8	Jeu de caractères de l'instance de destination. Valeurs possibles : utf8 gbk latin1 utf8mb4
DBInstanceNetType	String	Yes	Intranet	Type de connexion réseau de l'instance de destination. Valeurs possibles : Internet : Internet Intranet : réseau interne
DBInstanceDescription	String	No	testdatabase	Nom de l'instance de destination. Le nom doit comporter entre 2 et 256 caractères et peut contenir des lettres, des chiffres, des traits de soulignement (_) et des tirets (-). Il doit commencer par une lettre. Remarque Le nom ne peut pas commencer par http:// ou https://.
SecurityIPList	String	Yes	127.0.0.1	Liste d'autorisation d'adresses IP de l'instance de destination. Si vous souhaitez ajouter plusieurs entrées à la liste d'autorisation d'adresses IP, séparez-les par des virgules (,). Chaque entrée doit être unique. Vous pouvez ajouter jusqu'à 1 000 entrées. Pour plus d'informations, consultez la rubrique Configurer une liste d'autorisation d'adresses IP pour une instance ApsaraDB RDS for MySQL. Les entrées de la liste d'autorisation d'adresses IP doivent respecter l'un des formats suivants : Adresse IP. Exemple : 10.23.12.24. Bloc CIDR. Exemple : 10.23.12.24/24. Dans cet exemple, 24 indique que le préfixe du bloc CIDR est de 24 bits. Vous pouvez remplacer 24 par une valeur comprise entre 1 et 32.
ClientToken	String	No	ETnLKlblzczshOTUbOCzxxxxxxxxxx	Jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer le jeton, mais vous devez vous assurer qu'il est unique pour chaque requête. Le jeton ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères.
PayType	String	Yes	Prepaid	Méthode de facturation de l'instance de destination. Valeurs possibles : Postpaid : paiement à l'utilisation Prepaid : abonnement
ZoneId	String	No	cn-hangzhou-b	ID de zone de l'instance de destination. Si l'instance de destination est déployée dans plusieurs zones, séparez les ID des zones par des deux-points (:). Remarque Si vous spécifiez un VPC et un vSwitch, vous devez également spécifier le paramètre ZoneId.
InstanceNetworkType	String	No	Classic	Type de réseau de l'instance de destination. Valeurs possibles : VPC Classic Valeur par défaut : Classic. Remarque Si vous définissez ce paramètre sur VPC, vous devez également spécifier les paramètres VPCId et VSwitchId.
ConnectionMode	String	No	Standard	Mode de connexion de l'instance de destination. Valeurs possibles : Standard : mode standard Safe : mode proxy de base de données Valeur par défaut : Standard
VPCId	String	No	vpc-xxxxxxxxxxxx	ID du VPC de l'instance de destination. Ce paramètre n'est disponible que si vous définissez le paramètre InstanceNetworkType sur VPC. Remarque Si vous spécifiez ce paramètre, vous devez également spécifier le paramètre ZoneId.
VSwitchId	String	No	vsw-xxxxxxxxxxx	ID du vSwitch de l'instance de destination. Si vous spécifiez plusieurs vSwitches, séparez leurs ID par des virgules (,). Ce paramètre n'est disponible que si vous définissez le paramètre InstanceNetworkType sur VPC. Remarque Si vous spécifiez ce paramètre, vous devez également spécifier le paramètre ZoneId.
PrivateIpAddress	String	No	172.XXX.XXX.69	Adresse IP privée de l'instance de destination. L'adresse IP privée doit se trouver dans le bloc CIDR pris en charge par le vSwitch spécifié. Le système attribue automatiquement une adresse IP privée à une instance en fonction des valeurs des paramètres VPCId et VSwitchId.
UsedTime	String	No	2	Durée de l'abonnement de l'instance. Valeurs possibles : Si vous définissez le paramètre Period sur Year, la valeur du paramètre UsedTime est comprise entre 1 et 3. Si vous définissez le paramètre Period sur Month, la valeur du paramètre UsedTime est comprise entre 1 et 9. Remarque Si vous définissez le paramètre PayType sur Prepaid, vous devez également spécifier ce paramètre.
Period	String	No	Year	Unité de mesure de la durée de l'abonnement de l'instance de destination. Valeurs possibles : Year Month Remarque Si vous définissez le paramètre PayType sur Prepaid, vous devez également spécifier ce paramètre.
ResourceGroupId	String	No	rg-acfmyxxxxxxxxxx	ID du groupe de ressources.
RestoreType	String	Yes	BackupSet	Méthode utilisée pour restaurer les données. Valeurs possibles : BackupSet : Restaure les données à partir d'un ensemble de sauvegarde. Si vous utilisez cette valeur, vous devez également spécifier le paramètre BackupSetID. BackupTime : Restaure les données à un instant précis. Vous devez également spécifier les paramètres RestoreTime, SourceRegion et SourceDBInstanceName.
BackupSetId	String	No	14***	ID de l'ensemble de sauvegarde utilisé pour la restauration. Appelez l'opération DescribeCrossRegionBackups pour interroger l'ID de l'ensemble de sauvegarde. Remarque Si vous définissez le paramètre RestoreType sur BackupSet, vous devez également spécifier ce paramètre.
RestoreTime	String	No	2019-05-30T03:29:10Z	Instant précis auquel vous souhaitez restaurer les données. L'instant spécifié doit être antérieur à l'heure actuelle. Spécifiez l'heure au format ISO 8601 yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en UTC. Remarque Si vous définissez le paramètre RestoreType sur BackupTime, vous devez également spécifier ce paramètre.
SourceRegion	String	No	cn-hangzhou	ID de région de l'instance source si vous souhaitez restaurer les données à un instant précis. Remarque Si vous définissez le paramètre RestoreType sur BackupTime, vous devez également spécifier ce paramètre.
SourceDBInstanceName	String	No	rm-uf6wjk5xxxxxxx	ID de l'instance source si vous souhaitez restaurer les données à un instant précis. Remarque Si vous définissez le paramètre RestoreType sur BackupTime, vous devez également spécifier ce paramètre.
DBInstanceStorageType	String	No	local_ssd	Type de stockage de l'instance de destination. Seul le type de stockage SSD local est pris en charge. Valeur par défaut : local_ssd.

Paramètres de réponse

Parameter	Type	Example	Description
DBInstanceId	String	rm-xxxxx	ID de l'instance de destination.
RequestId	String	E52666CC-330E-418A-8E5B-A19E3FB42D13	ID de la requête.
Port	String	3306	Numéro de port utilisé pour se connecter à l'instance de destination. Remarque Le paramètre DBInstanceNetType indique si le port est un port interne ou un port public.
ConnectionString	String	rm-xxxxx.mysql.rds.aliyuncs.com	Endpoint utilisé pour se connecter à l'instance de destination. Remarque Le paramètre DBInstanceNetType indique si l'endpoint est un endpoint interne ou un endpoint public.
OrderId	String	2038691xxxxx	ID de la commande.

Exemples

Exemple de requête

http(s)://rds.aliyuncs.com/?Action=CreateDdrInstance
&RegionId=cn-hangzhou
&Engine=MySQL
&EngineVersion=5.6
&DBInstanceClass=rds.mysql.s1.small
&DBInstanceStorage=20
&SystemDBCharset=uft8
&DBInstanceNetType=Intranet
&DBInstanceDescription=testdatabase
&SecurityIPList=127.0.0.1
&ClientToken=ETnLKlblzczshOTUbOCzxxxxxxxxxx
&PayType=Prepaid
&ZoneId=cn-hangzhou-b
&InstanceNetworkType=Classic
&ConnectionMode=Standard
&VPCId=vpc-xxxxxxxxxxxx
&VSwitchId=vsw-xxxxxxxxxxx
&PrivateIpAddress=172.XXX.XXX.69
&UsedTime=2
&Period=Year
&ResourceGroupId=rg-acfmyxxxxxxxxxx	
&RestoreType=BackupSet
&BackupSetId=14***
&RestoreTime=2019-05-30T03:29:10Z
&SourceRegion=cn-hangzhou
&SourceDBInstanceName=rm-uf6wjk5xxxxxxx
&DBInstanceStorageType=local_ssd
&Common request parameters

Exemple de réponse réussie

Format XML

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

<CreateDdrInstanceResponse>
    <RequestId>E52666CC-330E-418A-8E5B-A19E3FB42D13</RequestId>
    <DBInstanceId>rm-xxxxx</DBInstanceId>
    <Port>3306</Port>
    <ConnectionString>rm-xxxxx.mysql.rds.aliyuncs.com</ConnectionString>
    <OrderId>2038691xxxxx</OrderId>
</CreateDdrInstanceResponse>

Format JSON

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

{
  "RequestId" : "E52666CC-330E-418A-8E5B-A19E3FB42D13",
  "DBInstanceId" : "rm-xxxxx",
  "Port" : "3306",
  "ConnectionString" : "rm-xxxxx.mysql.rds.aliyuncs.com",
  "OrderId" : "2038691xxxxx"
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidZoneId.NotSupported	The Specified vpc Zone not supported.	La zone spécifiée ne permet pas de créer une instance dans un VPC. Spécifiez une autre zone et réessayez.
400	InvalidDBInstanceName.Format	Specified DB instance name is not valid.	L'instance n'existe pas. Vérifiez les informations de l'instance.
400	InvalidDBInstanceName.Duplicate	Specified DB instance name already exists in the Aliyun RDS.	Le nom de l'instance existe déjà. Spécifiez un autre nom et réessayez.
400	InvalidRegion.Format	Specified Region is not valid.	La région spécifiée n'est pas valide.
400	InvalidServiceType.Format	Specified service type is not valid.	Le type de service n'est pas valide. Définissez le type de service sur 0 ou 1. La valeur 0 indique un service Alibaba Cloud et la valeur 1 indique un service JST.
400	InvalidEngine.Malformed	Specified engine is not valid.	Le moteur de base de données n'est pas valide. Spécifiez un moteur de base de données valide.
400	InvalidEngineVersion.Malformed	Specified engine version is not valid.	La version du moteur de base de données spécifiée n'est pas valide. Vérifiez la version du moteur de base de données et réessayez.
400	InvalidConnectionString.Format	Specified connection string is not valid.	Le préfixe de l'endpoint n'est pas valide. Le préfixe doit comporter entre 5 et 40 caractères.
400	InvalidConnectionString.Duplicate	Specified connection string already exists in the Aliyun RDS.	L'endpoint spécifié existe déjà. Spécifiez un autre endpoint.
400	InvalidCharacterSetName.Format	Specified character set name is not valid.	Le jeu de caractères spécifié n'est pas valide. ApsaraDB RDS prend en charge les jeux de caractères suivants : GBK, UTF-8, EUC-KR et ASCII.
400	InvalidDBInstanceType.Format	Specified instance type is not valid.	Le type d'instance spécifié n'est pas valide. Spécifiez un type d'instance valide.
400	InvalidPort.Malformed	Specified port is not valid.	Le numéro de port spécifié n'est pas valide.
400	InvalidBackupRetentionPeriod.Malformed	Specified backup retention period is not valid.	Le cycle de sauvegarde spécifié n'est pas valide. Le cycle de sauvegarde doit être supérieur à 1 jour ou inférieur ou égal à 30 jours.
400	InvalidPreferredBackupTime.Format	Specified preferred backup time is not valid.	Le format de l'heure de sauvegarde est incorrect. Spécifiez l'heure au format GMT AAAA-MM-JJThh:mmZ. Exemple : 2012-06-11T15:00Z.
400	InvalidPreferredBackupPeriod.Malformed	Specified backup period is not valid.	L'heure de sauvegarde n'est pas valide.
400	InvalidExpiredTime.Format	Specified expired time is not valid.	La valeur du paramètre ExpiredTime n'est pas valide. Spécifiez l'heure au format aaaa-MM-jjTHH:mm:ssZ. L'heure doit être exprimée en UTC.
400	InvalidSecurityIPList.Format	Specified security IP list format is not valid.	La liste d'autorisation d'adresses IP n'est pas valide. Vérifiez la liste d'autorisation d'adresses IP.
400	InvalidSecurityIPList.Duplicate	Specified security IP list is not valid: Duplicate IP address in the list	Les adresses IP ou les blocs CIDR spécifiés ne sont pas valides. Les adresses IP ou les blocs CIDR spécifiés sont en double.
400	InvalidSecurityIPList.QuotaExceeded	Specified security IP list is not valid: Exceeding the allowed amount of IP address in the list.	Le nombre d'entrées dans la liste d'autorisation d'adresses IP spécifiée dépasse la limite supérieure. Vous pouvez spécifier jusqu'à 1 000 entrées pour une liste d'autorisation d'adresses IP.
400	InvalidDBInstanceDescription.Format	Specified DB instance description is not valid.	La valeur du paramètre DBInstanceDescription n'est pas valide. Spécifiez une valeur valide pour le paramètre. La valeur de ce paramètre doit comporter entre 2 et 256 caractères et peut contenir des lettres, des chiffres, des traits de soulignement (_) et des tirets (-). La valeur doit commencer par une lettre.
400	InvalidStorage.Format	Specified Storage is not valid.	La valeur du paramètre Storage n'est pas valide. Spécifiez une valeur valide pour le paramètre.
400	InvalidDBInstanceConnType.Format	Specified DB instance conn type is not valid.	Le type de réseau de l'instance ne prend pas en charge cette opération.
400	PreCheckInvalid	CreateDdrInstance PreCheck Is Invalid	La vérification préalable de l'opération CreateDdrInstance n'est pas valide.
400	IncorrectDBInstanceType	Current DB instance engine and type does not support operations.	L'opération n'est pas prise en charge pour le moteur de base de données et le type d'instance de l'instance.
400	InvalidRestoreType.Format	Specified restore type is not valid.	Le type de restauration spécifié n'est pas valide. Spécifiez un type de restauration valide.
400	NoBackupSetRegion	BackupSetRegion is absence.	La région de sauvegarde n'existe pas.
400	NoBaksetName	BaksetName is absence.	Le nom de l'ensemble de sauvegarde n'existe pas.
400	NoSourceInstanceName	No SourceDBInstanceName.	Le nom de l'instance source est introuvable.
400	NoAvailableDisasterRestoreBakset	No available disaster restore bakset.	Aucun ensemble de sauvegarde disponible n'a été trouvé.
400	InvalidBackupType.Format	Specified backup type is not valid.	Le type de sauvegarde n'est pas valide.
400	IncorrectEngineVersion	Current engine version does not support operations.	Cette opération n'est pas prise en charge pour la version du moteur de base de données exécutée sur l'instance.
400	DisasterRestoreRegionNotMatched	Disaster restore should be operated in the ddr region or source region.	La reprise après sinistre doit être effectuée dans la région de l'instance source ou de destination.
403	IncorrectBackupSetMethod	Current backup set method does not support operations.	L'ensemble de sauvegarde spécifié ne peut pas être utilisé pour restaurer des bases de données et des tables individuelles.
403	IncorrectBaksetVersion	Current bakset version does not support operations.	L'opération n'est pas prise en charge pour la version de l'ensemble de sauvegarde.
403	CrossRegionUnsupportTDE	Cross-region disaster restore not support TDE bakset.	L'ensemble de sauvegarde basé sur TDE ne peut pas être utilisé pour restaurer une instance dans une autre région.
404	InvalidRegion.NotFound	Specified Region does not exist in the RDS	L'ID de région n'est pas valide.
404	InvalidClusterName.NotFound	The specified cluster name is not available.	Le nom du cluster n'existe pas. Vérifiez le nom du cluster et réessayez.
404	InvalidDBInstanceClass.NotFound	Specified DB instance class is not found.	Le nouveau type d'instance est introuvable ou n'est plus disponible à l'achat. Sélectionnez un type d'instance disponible.
404	InvalidDBInstanceNetType.NotFound	Specified DB instance net type is not found.	Le type de réseau de l'instance n'est pas valide. Vérifiez le type de réseau.
404	RestoreType.NotFound	RestoreType is not found.	La méthode de restauration spécifiée n'existe pas.
404	InvalidBackupSetID.NotFound	Specified backup set ID does not exist.	L'ensemble de sauvegarde spécifié n'existe pas. Vous devez vérifier les ensembles de sauvegarde existants.

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