Créer un fichier de sauvegarde - - Centre de documentation Alibaba Cloud

Cette opération utilise la fonctionnalité de sauvegarde d'ApsaraDB RDS pour créer un fichier de sauvegarde. Vous pouvez également utiliser Database Backup (DBS) à cette fin.

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

L'instance est à l'état Running.
Aucune tâche de sauvegarde n'est en cours sur l'instance.
Le nombre de fichiers de sauvegarde créés par jour pour une instance ne peut pas dépasser 20.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'utiliser OpenAPI Explorer pour appeler cette opération. Il 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	CreateBackup	Opération à effectuer. Définissez la valeur sur CreateBackup.
DBInstanceId	String	Oui	rm-uf6wjk5****	ID de l'instance.
DBName	String	Non	rds_mysql	Noms des bases de données à sauvegarder. Séparez les noms par des virgules (,). Remarque Spécifiez ce paramètre lors d'une sauvegarde logique de bases de données individuelles sur une instance ApsaraDB RDS for MySQL. Vous pouvez également l'utiliser pour une sauvegarde physique complète de bases de données individuelles sur une instance ApsaraDB RDS for SQL Server.
BackupStrategy	String	Non	db	Stratégie de sauvegarde. Valeurs valides : db : sauvegarde au niveau de la base de données. instance : sauvegarde au niveau de l'instance. Remarque Spécifiez ce paramètre lors d'une sauvegarde logique sur une instance ApsaraDB RDS for MySQL. Vous pouvez également l'utiliser pour une sauvegarde physique complète sur une instance ApsaraDB RDS for SQL Server.
BackupMethod	String	Non	Physical	Type de sauvegarde. Valeurs valides : Logical : sauvegarde logique Physical : sauvegarde physique Snapshot : sauvegarde par snapshot Valeur par défaut : Physical. Remarque La sauvegarde logique n'est possible que si des bases de données existent sur l'instance. Pour une sauvegarde par snapshot sur une instance ApsaraDB RDS for MariaDB, définissez ce paramètre sur Physical. Pour plus d'informations sur les types de sauvegarde pris en charge, consultez Sauvegarder une instance ApsaraDB RDS for MySQL. Pour une sauvegarde par snapshot sur une instance ApsaraDB RDS for SQL Server utilisant des disques SSD standard ou ESSD (Enhanced SSD), définissez ce paramètre sur Snapshot.
BackupType	String	Non	Auto	Méthode de sauvegarde. Valeurs valides : Auto : le système détermine s'il faut effectuer une sauvegarde complète ou incrémentielle FullBackup : sauvegarde complète. Valeur par défaut : Auto. Remarque Définissez ce paramètre uniquement si l'instance exécute le moteur de base de données SQL Server. Ce paramètre n'est valide que si le paramètre BackupMethod est défini sur Physical.
ResourceGroupId	String	Non	rg-acfmy*****	ID du groupe de ressources.

Paramètres de réponse

Paramètre

Type

Exemple

Description

BackupJobId

String

5073731

ID de la tâche de sauvegarde.

RequestId

String

2C125605-266F-41CA-8AC5-3A643D4F42C5

ID de la requête.

Exemples

Exemple de requête

http(s)://rds.aliyuncs.com/?Action=CreateBackup
&DBInstanceId=rm-uf6wjk5****
&<Common request parameters>

Exemples de réponses réussies

Format XML

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

<?xml version="1.0" encoding="UTF-8" ?>
<CreateBackupResponse>
    <RequestId>2C125605-266F-41CA-8AC5-3A643D4F42C5</RequestId>
    <BackupJobId>5073731</BackupJobId>
</CreateBackupResponse>

Format JSON

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

{
  "RequestId" : "2C125605-266F-41CA-8AC5-3A643D4F42C5",
  "BackupJobId" : "5073731"
}

Codes d'erreur

Code d'état HTTP	Code d'erreur	Message d'erreur	Description
403	OperationDenied.ApiForbidden	operation not permitted.	L'opération actuelle n'est pas prise en charge.

Pour obtenir la liste des codes d'erreur, consultez le Centre d'erreurs API.