Restaurer des bases de données - - Centre de documentation Alibaba Cloud

Cette opération permet de restaurer des bases de données vers une nouvelle instance ou une instance existante. Pour restaurer des bases de données vers une instance existante, nous vous recommandons d'utiliser l'opération Copier des bases de données .

Pour restaurer des bases de données vers une nouvelle instance, créez d'abord l'instance, puis restaurez-y les bases de données souhaitées (partielles ou complètes).

Si vous spécifiez le nom d'une base de données, seule cette base est restaurée sur la nouvelle instance.
Si vous ne spécifiez aucun nom de base de données, toutes les bases de données sont restaurées sur la nouvelle instance.

Remarque

L'opération RecoveryDBInstance n'est prise en charge que pour les instances exécutant SQL Server 2012 ou une version ultérieure.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération dans 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

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	RecoveryDBInstance	Opération à effectuer. Définissez la valeur sur RecoveryDBInstance.
DBInstanceClass	String	Non	rds.mysql.s2.large	Type d'instance de la nouvelle instance. Pour plus d'informations, consultez Types d'instances.
DBInstanceStorage	Integer	Non	5	Capacité de stockage de la nouvelle instance. Unité : Go. Pour plus d'informations, consultez Types d'instances.
PayType	String	Non	Postpaid	Méthode de facturation de la nouvelle instance. Valeurs possibles : Postpaid : paiement à l'utilisation Prepaid: : abonnement
InstanceNetworkType	String	Non	VPC	Type de réseau de la nouvelle instance. Valeurs possibles : Classic VPC Par défaut, la nouvelle instance utilise le même type de réseau que l'instance d'origine.
DBInstanceId	String	Non	rm-xxxxxxxx1	ID de l'instance d'origine. Remarque Si vous spécifiez le paramètre BackupId, ce paramètre est inutile. Si vous spécifiez le paramètre RestoreTime, ce paramètre est obligatoire.
TargetDBInstanceId	String	Non	rm-uf6wjk5xxxxxxx	ID de l'instance de destination.
DbNames	String	Oui	Restauration de la base de données vers une nouvelle instance : test1,test2 ; Restauration de la base de données vers une instance existante : {"test1":"newtest1","test2":"newtest2"}	Nom de la base de données. Pour restaurer des bases de données vers une nouvelle instance, utilisez le format suivant : `Nom de la base de données d'origine 1,Nouveau nom de la base de données 2`. Pour restaurer des bases de données vers une instance existante, utilisez le format suivant : `{"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	Non	29304****	ID du jeu de sauvegarde. Appelez l'opération DescribeBackups pour obtenir l'ID. Si vous spécifiez ce paramètre, le paramètre DBInstanceId est inutile. Remarque Vous devez spécifier au moins l'un des paramètres BackupId ou RestoreTime.
RestoreTime	String	Non	2011-06-11T16:00:00Z	Point dans le temps auquel vous souhaitez restaurer les bases de données. Sélectionnez un moment situé dans la période de rétention des sauvegardes. Indiquez l'heure au format ISO 8601 yyyy-MM-ddTHH:mm:ssZ (UTC). Si vous spécifiez ce paramètre, le paramètre DBInstanceId est obligatoire. Remarque Vous devez spécifier au moins l'un des paramètres BackupId ou RestoreTime.
VPCId	String	Non	vpc-xxxxxxxxxxx	ID du VPC de la nouvelle instance.
VSwitchId	String	Non	vsw-xxxxxxxxxxx	ID du vSwitch de la nouvelle instance. Si vous spécifiez plusieurs ID de vSwitch, séparez-les par des virgules (,).
PrivateIpAddress	String	Non	172.XXX.XXX.69	Adresse IP interne de la nouvelle instance. Elle doit appartenir au bloc CIDR pris en charge par le vSwitch spécifié. Le système attribue automatiquement une adresse IP interne à la nouvelle instance selon les valeurs des paramètres VPCId et VSwitchId.
UsedTime	String	Non	1	Durée de l'abonnement de l'instance. Valeurs possibles : Si le paramètre Period est défini sur Year, la valeur du paramètre UsedTime varie de 1 à 3. Si le paramètre Period est défini sur Month, la valeur du paramètre UsedTime varie de 1 à 9. Remarque Si le paramètre PayType est défini sur Prepaid, ce paramètre est obligatoire.
Period	String	Non	Month	Unité de calcul du cycle de facturation de la nouvelle instance. Ce paramètre s'applique uniquement si vous choisissez la facturation par abonnement. Valeurs possibles : Year Month Remarque Si le paramètre PayType est défini sur Prepaid, ce paramètre est obligatoire.
DBInstanceStorageType	String	Non	local_ssd	Type de stockage de la nouvelle instance. Valeurs possibles : local_ssd/ephemeral_ssd : SSD local cloud_ssd : SSD standard cloud_essd : SSD amélioré (ESSD)

Paramètres de réponse

Paramètre	Type	Exemple	Description
DBInstanceId	String	rm-xxxxxxx	ID de l'instance.
RequestId	String	EFB6083A-7699-489B-8278-C0CB4793A96E	ID de la requête.
OrderId	String	54325****	ID de la commande.

Exemples

Exemples de requêtes

http(s)://rds.aliyuncs.com/?Action=RecoveryDBInstance
&DBInstanceClass=rds.mysql.s2.large
&DBInstanceStorage=5
&PayType=Postpaid
&InstanceNetworkType=VPC
&DBInstanceId=rm-xxxxxxxx1
&TargetDBInstanceId=rm-uf6wjk5xxxxxxx
&DbNames=Database restoration to a new instance: test1,test2; Database restoration to an existing instance: {"test1":"newtest1","test2":"newtest2"}
&BackupId=29304****
&RestoreTime=2011-06-11T16:00:00Z
&VPCId=vpc-xxxxxxxxxxx
&VSwitchId=vsw-xxxxxxxxxxx
&PrivateIpAddress=172.XXX.XXX.69
&UsedTime=1
&Period=Month
&DBInstanceStorageType=local_ssd
&Common request parameters

Exemples de réponses réussies

Format XML

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

<RecoveryDBInstanceResponse>
    <DBInstanceId>rm-xxxxxxx</DBInstanceId>
    <RequestId>EFB6083A-7699-489B-8278-C0CB4793A96E</RequestId>
    <OrderId>54325****</OrderId>
</RecoveryDBInstanceResponse>

Format JSON

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

{
  "DBInstanceId" : "rm-xxxxxxx",
  "RequestId" : "EFB6083A-7699-489B-8278-C0CB4793A96E",
  "OrderId" : "54325****"
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
400	IllegalParameter	illegal parameter, param is empty.	Les paramètres spécifiés ne sont pas valides.
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 la nouvelle instance doit être supérieur ou égal à la taille totale des données stockées dans l'instance d'origine.
400	DBCountLimitExceeded	Db count limit exceeded.	Le nombre de bases de données dépasse la limite autorisée.
403	Forbidden.SnapshotRecovery	Snapshot backup does not support partial restore	Les fichiers de sauvegarde instantanée ne permettent pas de restaurer uniquement une partie des données.

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