Restaurer les données vers une nouvelle instance - - Centre de documentation Alibaba Cloud

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

L'instance source est dans l'état Running.
Aucune tâche de migration n'est en cours sur l'instance source.
La fonctionnalité de sauvegarde des journaux est activée sur l'instance source pour permettre la restauration à un instant précis.
Si vous clonez l'instance source à partir de jeux de sauvegarde, celle-ci doit disposer d'au moins un jeu de sauvegarde.

Remarque

ApsaraDB RDS permet de cloner une instance avec les identifiants d'un utilisateur RAM. Assurez-vous que cet utilisateur dispose des autorisations nécessaires. Pour plus d'informations, consultez

Utiliser RAM pour gérer les autorisations ApsaraDB RDS

.

Points importants :

La nouvelle instance hérite des mêmes paramètres que l'instance source : liste d'autorisation IP, SQL Explorer (SQL Audit), seuils d'alerte, sauvegarde et configuration.
Les comptes et les données de la nouvelle instance correspondent exactement à ceux contenus dans le fichier de sauvegarde ou à l'instant précis utilisé pour la restauration.

Débogage

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

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	No	CloneDBInstance	Opération à effectuer. Définissez la valeur sur CloneDBInstance.
RegionId	String	No	cn-hangzhou	ID de région de la nouvelle instance. Appelez l'opération DescribeRegions pour obtenir la liste des régions.
ZoneId	String	No	cn-hangzhou-b	ID de zone de l'instance principale. Appelez l'opération DescribeRegions pour obtenir la liste des zones. Remarque Par défaut, ce paramètre prend l'ID de la zone de l'instance source.
DBInstanceClass	String	No	mysql.n1.micro.1	Type d'instance de la nouvelle instance. Pour plus d'informations, consultez Types d'instances principales ApsaraDB RDS. Remarque Par défaut, ce paramètre reprend le type d'instance de l'instance principale.
DBInstanceStorage	Integer	No	1000	Capacité de stockage de la nouvelle instance (en Go). Incrément de 5 Go. Pour plus d'informations, consultez Types d'instances principales ApsaraDB RDS. Remarque Par défaut, ce paramètre reprend la capacité de stockage de l'instance principale.
DbNames	String	No	test1,test2	Nom de la base de données. Pour plusieurs bases, utilisez le format suivant : `Nom de la base de données d'origine 1,Nom de la base de données d'origine 2`.
PayType	String	No	Postpaid	Mode de facturation de la nouvelle instance. Valeurs possibles : Postpaid : paiement à l'utilisation. Prepaid : abonnement. Serverless : serverless. Pris en charge uniquement pour les instances MySQL. Pour plus d'informations, consultez Présentation.
InstanceNetworkType	String	No	VPC	Type de réseau de la nouvelle instance. Valeurs possibles : VPC Classic Remarque Par défaut, ce paramètre reprend le type de réseau de l'instance principale.
DBInstanceId	String	No	rm-uf6wjk5xxxxxxxxxx	ID de l'instance.
BackupId	String	No	902****	ID du jeu de sauvegarde. Appelez l'opération DescribeBackups pour consulter les jeux de sauvegarde. Remarque Spécifiez au moins l'un des paramètres BackupId ou RestoreTime.
RestoreTime	String	No	2011-06-11T16:00:00Z	Instant précis de restauration des données. Il doit se situer dans la période de rétention des sauvegardes. Format ISO 8601 : yyyy-MM-ddTHH:mm:ssZ (UTC). Remarque Spécifiez au moins l'un des paramètres BackupId ou RestoreTime.
VPCId	String	No	vpc-uf6f7l4fg90xxxxxxxxxx	ID du VPC auquel appartient la nouvelle instance. Remarque Le VPC doit appartenir à la région spécifiée.
VSwitchId	String	No	vsw-uf6adz52c2pxxxxxxxxxx	ID du vSwitch. Le vSwitch doit appartenir à la zone définie par le paramètre ZoneId. Si le paramètre InstanceNetworkType est défini sur VPC, ce paramètre est obligatoire. Si vous spécifiez le paramètre ZoneSlaveId1, indiquez deux ID de vSwitch séparés par une virgule (,).
PrivateIpAddress	String	No	172.XX.XXX.69	Adresse IP interne de la nouvelle instance. Elle doit appartenir au bloc CIDR du vSwitch spécifié. Le système attribue automatiquement une adresse IP interne selon les paramètres VPCId et VSwitchId.
UsedTime	Integer	No	1	Durée d'abonnement de la nouvelle instance. Si le paramètre Period est défini sur Year, la valeur de UsedTime varie de 1 à 3. Si le paramètre Period est défini sur Month, la valeur de UsedTime varie de 1 à 9. Remarque Si le paramètre PayType est défini sur Prepaid, le paramètre UsedTime est obligatoire.
Period	String	No	Year	Unité de durée du cycle de facturation de la nouvelle instance. Valeurs possibles : Year Month Remarque Si le paramètre PayType est défini sur Prepaid, le paramètre Period est obligatoire.
Category	String	No	HighAvailability	Édition RDS de la nouvelle instance. Valeurs possibles : Basic : Édition de base RDS. HighAvailability : Édition haute disponibilité RDS. AlwaysOn : Édition Cluster RDS pour SQL Server. cluster : Édition Cluster RDS pour MySQL. Finance : Édition Entreprise RDS. Disponible uniquement sur le site Chine (aliyun.com). serverless_basic : Édition de base RDS Serverless.
ZoneIdSlave1	String	No	cn-hangzhou-c	ID de zone de l'instance secondaire. Si ZoneIdSlave1 est identique à ZoneId, le déploiement est mono-zone. Sinon, il est multi-zone.
ZoneIdSlave2	String	No	cn-hangzhou-d	ID de zone de l'instance de journalisation. Si ZoneIdSlave2 est identique à ZoneId, le déploiement est mono-zone. Sinon, il est multi-zone.
DBInstanceStorageType	String	No	cloud_essd	Type de stockage de la nouvelle instance. Valeurs possibles : local_ssd : SSD locaux cloud_ssd : SSD standard cloud_essd : ESSD PL1 cloud_essd2 : ESSD PL2 cloud_essd3 : ESSD PL3
RestoreTable	String	No	1	Indique si vous souhaitez restaurer les bases de données et tables spécifiées. La valeur 1 active la restauration. Omettez ce paramètre pour ne pas restaurer les éléments spécifiés.
TableMeta	String	No	[{"type":"db","name":"testdb1","newname":"testdb1_new","tables":[{"type":"table","name":"testdb1table1","newname":"testdb1table1_new"}]}]	Informations sur les bases de données et tables à restaurer. Syntaxe : [{"type":"db","name":"The original name of Database 1","newname":"The new name of Database 1","tables":[{"type":"table","name":"The original name of Table 1 in Database 1","newname":"The new name of Table 1 in Database 1"},{"type":"table","name":"The original name of Table 2 in Database 1","newname":"The new name of Table 2 in Database 1"}]},{"type":"db","name":"The original name of Database 2","newname":"The new name of Database 2","tables":[{"type":"table","name":"The original name of Table 1 in Database 2","newname":"The new name of Table 1 in Database 2"},{"type":"table","name":"The original name of Table 2 in Database 2","newname":"The new name of Table 2 in Database 2"}]}]
DedicatedHostGroupId	String	No	dhg-7a9xxxxxxxx	ID du cluster dédié auquel appartient la nouvelle instance.
BackupType	String	No	FullBackup	Type de sauvegarde. Valeurs possibles : FullBackup IncrementalBackup
DeletionProtection	Boolean	No	true	Active ou désactive la protection contre la suppression de la nouvelle instance. Valeurs possibles : true : active la fonctionnalité. false : désactive la fonctionnalité. Valeur par défaut : false.
AutoPause	Boolean	No	true	Active ou désactive le démarrage et l'arrêt automatiques de l'instance serverless. Si aucune connexion n'est établie pendant 10 minutes, l'instance est suspendue. Elle reprend automatiquement lors d'une nouvelle connexion. Valeurs possibles : true : active la fonctionnalité. false : désactive la fonctionnalité (valeur par défaut).
MaxCapacity	double	No	8	Nombre maximal d'unités de capacité RDS (RCU).
MinCapacity	double	No	0,5	Nombre minimal de RCU.
SwitchForce	Boolean	No	false	Active ou désactive la mise à l'échelle forcée de l'instance serverless. ApsaraDB RDS ajuste généralement les RCU en temps réel selon la charge. Dans de rares cas, l'ajustement peut être retardé ; activez cette option pour forcer la mise à l'échelle. Valeurs possibles : true : active la fonctionnalité. false : désactive la fonctionnalité (valeur par défaut).

Paramètres de réponse

Parameter	Type	Example	Description
DBInstanceId	String	rm-uf6wjk5xxxxxxx	ID de l'instance.
RequestId	String	1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC	ID de la requête.
OrderId	String	100789370****	ID de la commande.

Exemples

Exemples de requêtes

http(s)://rds.aliyuncs.com/?Action=CloneDBInstance
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-b
&DBInstanceClass=mysql.n1.micro.1
&DBInstanceStorage=1000
&DbNames=test1,test2
&PayType=Postpaid
&InstanceNetworkType=VPC
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&BackupId=902****
&RestoreTime=2011-06-11T16:00:00Z
&VPCId=vpc-uf6f7l4fg90xxxxxxxxxx
&VSwitchId=vsw-uf6adz52c2pxxxxxxxxxx
&PrivateIpAddress=172.XX.XXX.69
&UsedTime=1
&Period=Year
&Category=HighAvailability
&ZoneIdSlave1=cn-hangzhou-c
&ZoneIdSlave2=cn-hangzhou-d
&DBInstanceStorageType=cloud_essd
&RestoreTable=1
&TableMeta=[{"type":"db","name":"testdb1","newname":"testdb1_new","tables":[{"type":"table","name":"testdb1table1","newname":"testdb1table1_new"}]}]
&DedicatedHostGroupId=dhg-7a9xxxxxxxx
&BackupType=FullBackup
&DeletionProtection=true
&ServerlessConfig={"AutoPause":true,"MaxCapacity":8.0,"MinCapacity":0.5,"SwitchForce":false}
&Common request parameters

Exemples de réponses réussies

XML format

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

<CloneDBInstanceResponse>
    <DBInstanceId>rm-uf6wjk5xxxxxxx</DBInstanceId>
    <RequestId>1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC</RequestId>
    <OrderId>100789370****</OrderId>
</CloneDBInstanceResponse>

JSON format

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

{
  "DBInstanceId" : "rm-uf6wjk5xxxxxxx",
  "RequestId" : "1E43AAE0-BEE8-43DA-860D-EAF2AA0724DC",
  "OrderId" : "100789370****"
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidAvZone.Format	Specified AvZone is not valid.	La valeur du paramètre ZoneID n'est pas valide.
400	InvalidAvZone.NotSupport	Specified availableArea multiZone does not support in RDS.	La valeur spécifiée pour le paramètre availableArea multiZone n'est pas prise en charge dans ApsaraDB RDS.
400	CannotDecreaseEssdPerfLevel	cannot decrease cloud essd performance level.	La modification du type de stockage n'est pas autorisée. Le type de stockage d'une instance SQL Server avec des SSD standard ne peut être modifié qu'en ESSD. Celui d'une instance avec des SSD locaux peut être modifié en SSD standard ou ESSD.
400	CannotDecreaseEssdPerfLevel	invalid cloud essd storage size.	La valeur du paramètre DBInstanceStorage n'est pas valide.
400	InvalidIPAddress.Conflict	IP address conflict.	Conflit d'adresses IP.
400	CDDC.AvailableHostsNotEnoughInZone	Not enough available hosts are in the target zone.	Aucun hôte disponible dans la zone spécifiée. Créez un hôte dans la zone et réessayez.
400	InvalidInstanceLevel.DiskType	Specified instance level not support request disk type	Le type d'instance spécifié ne prend pas en charge le type de stockage demandé.
400	InvalidRecoveryDbInstance.StorageType	The disk local_ssd can not clone to cloud disk type	Vous ne pouvez pas restaurer les données d'une instance utilisant des SSD locaux vers une instance utilisant des SSD standard ou des ESSD.
400	InvalidRecoveryDbInstance.StorageSize	The disk space of the new instance cannot be less than that of the current instance	L'espace de stockage de la nouvelle instance doit être supérieur ou égal à la taille totale des données de l'instance source.
403	IncorrectMinorVersion	Current engine minor version does not support operations.	Cette opération n'est pas prise en charge par la version mineure actuelle du moteur.
403	IncorrectCharacterType	Current DB instance character type does not support this operation.	Cette opération n'est pas prise en charge par le type de caractères de l'instance actuelle.

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