Vérifier la possibilité de restaurer les données d'une instance à l'aide d'un jeu de sauvegarde inter-régions -

Avant d'appeler cette opération, assurez-vous que l'instance source 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 entre régions.
SQL Server. Pour plus d'informations, consultez la rubrique Sauvegarder une instance ApsaraDB RDS for SQL Server entre régions.
PostgreSQL. Pour plus d'informations, consultez la rubrique

Sauvegarder une instance ApsaraDB RDS for PostgreSQL entre régions

.

Remarque
Si votre instance ApsaraDB RDS for PostgreSQL utilise la nouvelle architecture et a été créée après le 10 octobre 2022, cette fonctionnalité n'est pas prise en charge. Pour plus d'informations, consultez la rubrique

[[Avis] L'autorisation SLR est requise pour créer une instance ApsaraDB RDS for PostgreSQL à partir du 10 octobre 2022](~~452313~~)

.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de 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	CheckCreateDdrDBInstance	Opération à effectuer. Définissez la valeur sur CheckCreateDdrDBInstance.
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 la plus récente.
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 dépend de celle du paramètre Engine. Si Engine est défini sur MySQL : 5,5, 5,6, 5,7 et 8,0 Si Engine est défini sur SQLServer : 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 Engine est défini sur PostgreSQL : 10,0, 11,0, 12,0, 13,0, 14,0 et 15,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. La valeur doit être un multiple de 5 Go. Pour plus d'informations, consultez la rubrique Types d'instances principales ApsaraDB RDS.
RestoreType	String	Yes	0	Méthode de restauration. Valeurs possibles : 0 : restaure les données à partir d'un jeu de sauvegarde. Si vous définissez ce paramètre sur 0, spécifiez également le paramètre BackupSetId. 1 : restaure les données à un instant précis. Si vous définissez ce paramètre sur 1, spécifiez également les paramètres RestoreTime, SourceRegion et SourceDBInstanceName. Valeur par défaut : 0.
BackupSetId	String	No	14358	ID du jeu de sauvegarde utilisé pour la restauration. Appelez l'opération DescribeCrossRegionBackups pour obtenir l'ID du jeu de sauvegarde. Remarque Si vous définissez le paramètre RestoreType sur 0, ce paramètre est obligatoire.
RestoreTime	String	No	2019-05-30T03:29:10Z	Instant précis de restauration des données. L'instant spécifié doit être antérieur à l'heure actuelle. Indiquez l'heure au format ISO 8601 yyyy-MM-ddTHH:mm:ssZ (UTC). Remarque Si vous définissez le paramètre RestoreType sur 1, ce paramètre est obligatoire.
SourceRegion	String	No	cn-hangzhou	ID de région de l'instance source pour une restauration à un instant précis. Remarque Si vous définissez le paramètre RestoreType sur 1, ce paramètre est obligatoire.
SourceDBInstanceName	String	No	rm-uf6wjk5xxxxxxx	ID de l'instance source pour une restauration à un instant précis. Remarque Si vous définissez le paramètre RestoreType sur 1, ce paramètre est obligatoire.

Paramètres de réponse

Parameter	Type	Example	Description
IsValid	String	true	Indique si les données de l'instance source peuvent être restaurées entre régions. Valeurs possibles : true et false.
RequestId	String	1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC	ID de la requête.

Exemples

Exemple de requête

http(s)://rds.aliyuncs.com/?Action=CheckCreateDdrDBInstance
&RegionId=cn-hangzhou
&Engine=MySQL
&DBInstanceClass=rds.mysql.s1.small
&DBInstanceStorage=20
&EngineVersion=5.6
&RestoreType=0
&BackupSetId=14358
&<Common request parameters>

Exemple de réponse réussie

Format XML

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

<CheckCreateDdrDBInstanceResponse>
  <IsValid>true</IsValid>
  <RequestId>346C62D7-8BB9-4516-93E7-25A469EAABCB</RequestId>
</CheckCreateDdrDBInstanceResponse>

Format JSON

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

{
  "IsValid" : "true",
  "RequestId" : "346C62D7-8BB9-4516-93E7-25A469EAABCB"
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	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 cette opération.
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	IncorrectBackupSetType	Backup set type should be ddr.	Le type du jeu de sauvegarde n'est pas DDR.
400	NoSourceInstanceName	No SourceDBInstanceName.	Le nom de l'instance source est introuvable.
400	NoAvailableDisasterRestoreBakset	No available disaster restore bakset.	Aucun jeu de sauvegarde disponible n'a été trouvé.
400	IncorrectBackupSetMethod	Current backup set method does not support operations.	Le jeu de sauvegarde spécifié ne permet pas de restaurer des bases de données et des tables individuelles.
400	InvalidBackupType.Format	Specified backup type is not valid.	Le type de sauvegarde spécifié n'est pas valide.
400	IncorrectEngineVersion	Current engine version does not support operations.	La version du moteur de base de données de l'instance ne prend pas en charge cette opération.
400	IncorrectBaksetVersion	Current bakset version does not support operations.	La version du jeu de sauvegarde ne prend pas en charge cette opération.
400	CrossRegionUnsupportTDE	Cross-region disaster restore not support TDE bakset.	Le jeu de sauvegarde basé sur TDE ne permet pas de restaurer une instance dans une autre région.
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.
400	InvalidMinorVersion.NotFound	Specified minor version does not exists.	La version mineure du moteur spécifiée n'existe pas.
400	InvalidDBInstanceId.MalFormed	The specified parameter DBInstanceId is not valid.	L'ID d'instance n'est pas valide. Vérifiez l'ID d'instance.
400	InvalidEngine.Malformed	Specified engine is not valid.	Le moteur de base de données spécifié 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 et réessayez.
400	MissingUserID	The request is missing a user_id parameter.	L'ID utilisateur spécifié n'existe pas.
400	MissingUID	The request is missing a uid parameter.	Le compte utilisé n'existe pas.
400	UserPermissionFailure	The request processing has failed due to user permission.	Vous ne disposez pas des autorisations requises.
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	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.
403	IncorrectDBType	The current DB type does not support this operation.	Le moteur de base de données de l'instance ne prend pas en charge cette opération. Spécifiez un autre moteur de base de données.
403	IncorrectDBInstance	The current DB instance does not support this operation.	L'instance ne prend pas en charge cette opération.
403	ResourceConfigError	The request processing has failed due to resource config error.	Une erreur de configuration des ressources s'est produite.
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.	Le jeu de sauvegarde spécifié n'existe pas. Spécifiez un jeu de sauvegarde valide.
404	InvalidDBInstance.NotFound	The specified instance does not exist or is not supported.	L'instance spécifiée est introuvable. Vérifiez l'ID de l'instance.
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.

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