Interroger les tâches de sauvegarde - - Centre de documentation Alibaba Cloud

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

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeBackupTasks	Opération à effectuer. Définissez la valeur sur DescribeBackupTasks.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxx	ID de l'instance.
ClientToken	String	No	ETnLKlblzczshOTUbOCzxxxxxxx	Jeton client utilisé pour garantir l'idempotence de la requête. Générez la valeur via le client, en veillant à son unicité pour chaque requête. Le jeton ne doit contenir que des caractères ASCII et ne pas dépasser 64 caractères.
Flag	String	No	None	Paramètre masqué.
BackupJobId	Integer	No	4762614	ID de la tâche de sauvegarde unique à interroger.
BackupMode	String	No	Automated	Mode de sauvegarde des tâches à interroger. Valeurs valides : Automated Manual
BackupJobStatus	String	No	NoStart	Statut des tâches de sauvegarde à interroger. Valeurs valides : NoStart : interroge les tâches de sauvegarde non démarrées. Progressing : interroge les tâches de sauvegarde en cours. Par défaut, cette opération renvoie les tâches dans les deux états.

Paramètres de réponse

Parameter	Type	Example	Description
Items	Array of BackupJob		Tableau contenant les tâches de sauvegarde.
BackupJob
BackupId	String	346650271	ID du jeu de sauvegarde généré par la tâche. Remarque Si la valeur de retour du paramètre BackupStatus est Finished, spécifiez le paramètre BackupJobId pour obtenir l'ID du jeu de sauvegarde généré.
BackupJobId	String	4762614	ID de la tâche de sauvegarde.
BackupProgressStatus	String	NoStart	Statut du programme de sauvegarde. Valeurs valides : NoStart : le programme de sauvegarde n'a pas démarré. Preparing : le programme de sauvegarde se prépare. Waiting : le programme de sauvegarde est en attente. Uploading : le programme de sauvegarde télécharge le fichier de sauvegarde. Checking : le programme de sauvegarde vérifie le fichier téléchargé. Finished : le programme de sauvegarde est terminé.
BackupStatus	String	NoStart	Statut de la tâche de sauvegarde. Valeurs valides : NoStart : la tâche de sauvegarde n'a pas démarré. Checking : la tâche de sauvegarde vérifie les paramètres. Preparing : la tâche de sauvegarde se prépare. Waiting : la tâche de sauvegarde est en attente. Uploading : la tâche de sauvegarde télécharge le fichier de sauvegarde. Finished : la tâche de sauvegarde est terminée. Failed : la tâche de sauvegarde a échoué. Remarque Ce paramètre n'est renvoyé que lors de l'exécution d'une tâche de sauvegarde.
JobMode	String	Automated	Mode de sauvegarde de la tâche. Valeurs valides : Automated Manual
Process	String	25	Progression de la tâche de sauvegarde. Unité : %.
TaskAction	String	NormalBackupTask	Type de la tâche de sauvegarde. Valeurs valides : TempBackupTask : tâche de sauvegarde temporaire NormalBackupTask : tâche de sauvegarde normale
RequestId	String	90496720-2319-42A8-87CD-FCE4DF95EBED	ID de la requête.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

XML format

<DescribeBackupTasksResponse>
	  <Items>
		    <BackupJob>
			      <JobMode>Automated</JobMode>
			      <BackupProgressStatus>NoStart</BackupProgressStatus>
			      <TaskAction>NormalBackupTask</TaskAction>
			      <BackupStatus>NoStart</BackupStatus>
			      <BackupJobId>4762614</BackupJobId>
		    </BackupJob>
	  </Items>
	  <RequestId>90496720-2319-42A8-87CD-FCE4DF95EBED</RequestId>
</DescribeBackupTasksResponse>

JSON format

{
    "Items": {
        "BackupJob": [
            {
                "JobMode": "Automated",
                "BackupProgressStatus": "NoStart",
                "TaskAction": "NormalBackupTask",
                "BackupStatus": "NoStart",
                "BackupJobId": 4762614
            }
        ]
    },
    "RequestId": "90496720-2319-42A8-87CD-FCE4DF95EBED"
}

Codes d'erreur

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