Interroger les fichiers de sauvegarde complète - - Centre de documentation Alibaba Cloud

Remarque

Un fichier de sauvegarde complète contient les données d'une base de données MySQL auto-gérée. Vous pouvez restaurer ces données vers une instance ApsaraDB RDS for MySQL à partir d'un tel fichier. Pour plus d'informations, consultez la rubrique Migrer les données d'une instance MySQL 5,7 auto-gérée vers le cloud.
Avant d'appeler l'opération CreateDBInstance pour créer une instance ApsaraDB RDS for MySQL destinée à recevoir des fichiers de sauvegarde complète, appelez l'opération ListUserBackupFiles afin d'obtenir les ID de ces fichiers.
Appelez l'opération ImportUserBackupFile pour importer un fichier de sauvegarde complète dans une instance ApsaraDB RDS for MySQL.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de 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

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	ListUserBackupFiles	Opération à effectuer. Définissez la valeur sur ListUserBackupFiles.
Status	String	Non	CheckSuccess	Statut des fichiers de sauvegarde complète. Valeurs possibles : Importing : Importation en cours. Failed : Échec de l'importation. CheckSucccess : Vérification réussie. BackupSuccess : Importation réussie. Deleted : Fichier supprimé.
RegionId	String	Oui	cn-hangzhou	ID de région de l'instance. Appelez l'opération DescribeRegions pour obtenir la liste des régions les plus récentes.
Comment	String	Non	BackupTest	Chaîne de caractères incluse dans la description des fichiers de sauvegarde complète. Remarque Le système effectue une correspondance floue basée sur la valeur de ce paramètre.
BackupId	String	Non	b-kwwvr7v8t7of********	ID du fichier de sauvegarde complète.
OssUrl	String	Non	https://****.oss-ap-******.aliyuncs.com/backup_qp.xb	URL de téléchargement du fichier de sauvegarde complète stocké en tant qu'objet dans un compartiment Object Storage Service (OSS). Pour savoir comment obtenir l'URL, consultez la rubrique Obtenir l'URL d'accès après avoir téléchargé des objets.
Tags	String	Non	key1:value1	Tag ajouté aux fichiers de sauvegarde complète.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RequestId	String	AD67C22F-64F3-4448-A9A8-D1606D242879	ID de la requête.
Records	Array of Records		Tableau contenant les informations relatives aux fichiers de sauvegarde complète renvoyés.
Status	String	BackupSuccess	Statut du fichier de sauvegarde complète. Valeurs possibles : Importing : Importation en cours. Failed : Échec de l'importation. CheckSucccess : Vérification réussie. BackupSuccess : Importation réussie. Deleted : Fichier supprimé.
CreationTime	String	1623231084000	Heure de début d'importation du fichier de sauvegarde complète. La valeur est un horodatage UNIX exprimé en millisecondes.
FinishTime	String	1623231750000	Heure de fin d'importation du fichier de sauvegarde complète. La valeur est un horodatage UNIX exprimé en millisecondes.
Comment	String	BackupTest	Description du fichier de sauvegarde complète.
OssFilePath	String	test/backup_qp.xb	Chemin d'accès au fichier de sauvegarde complète stocké en tant qu'objet dans un compartiment OSS.
OssBucket	String	BackupTest	Nom du compartiment OSS dans lequel le fichier de sauvegarde complète est stocké en tant qu'objet.
ModificationTime	String	1623231750000	Heure de fin d'importation du fichier de sauvegarde complète. La valeur est un horodatage UNIX exprimé en millisecondes.
OssFileSize	Long	79115	Taille du fichier de sauvegarde complète stocké en tant qu'objet dans un compartiment OSS. Unité : Ko.
OssFileName	String	backup_qp.xb	Nom du fichier de sauvegarde complète stocké en tant qu'objet dans un compartiment OSS.
EngineVersion	String	5.7	Version du moteur de base de données de l'instance.
BackupId	String	b-kwwvr7v8t7of********	ID du fichier de sauvegarde complète.
RestoreSize	String	20	Espace de stockage nécessaire pour restaurer les données du fichier de sauvegarde complète. Unité : Go.
ZoneId	String	cn-hangzhou-b	ID de zone du fichier de sauvegarde complète.
Retention	Integer	3	Période de rétention du fichier de sauvegarde complète. Unité : jours.
Engine	String	mysql	Moteur de base de données de l'instance.
OssUrl	String	https://****.oss-ap-******.aliyuncs.com/backup_qp.xb	URL de téléchargement OSS du fichier de sauvegarde complète.
OssFileMetaData	String	{\"Accept-Ranges\":\"bytes\",\"Connection\":\"keep-alive\",\"Content-Length\":81014337,\"Content-Type\":\"application/octet-stream\",\"Date\":1623309548000,\"ETag\":\"889FE9E5FCEBFE4781829488A352863B-1\",\"Last-Modified\":1622186844000,\"Server\":\"AliyunOSS\",\"x-oss-hash-crc64ecma\":\"5793608435727323129\",\"x-oss-object-type\":\"Multipart\",\"x-oss-request-id\":\"60C1BCEC92572F37318BD499\",\"x-oss-server-time\":\"166\",\"x-oss-storage-class\":\"Standard\"}	Métadonnées du fichier de sauvegarde complète. Pour plus d'informations, consultez la rubrique Gérer les métadonnées d'objet.
BinlogInfo	String	{\"binlogPosition\":\"154\",\"binlogFile\":\"0.000002\"}	Informations relatives au fichier journal binaire contenant les données incrémentielles. Ce paramètre est renvoyé si des données incrémentielles sont générées pendant la sauvegarde complète.
Reason	String	success	Raison de l'échec de l'importation du fichier de sauvegarde complète.

Exemples

Exemple de requête

http(s)://rds.aliyuncs.com/?Action=ListUserBackupFiles
&RegionId=cn-hangzhou
&<Common request parameters>

Exemple de réponse réussie

XML format

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

<ListUserBackupFilesResponse>
<RequestId>9FB29A6E-C63A-4810-B71D-AFC65FD66309</RequestId>
<Records>
    <Status>BackupSuccess</Status>
    <Comment>b-c8677aw89jo7********</Comment>
    <EngineVersion>5.7</EngineVersion>
    <OssBucket>ghjtest</OssBucket>
    <BackupId>b-c8677aw89jo7********</BackupId>
    <ModificationTime>1623310685000</ModificationTime>
    <Retention>3</Retention>
    <OssFileMetaData>{"Accept-Ranges":"bytes","Connection":"keep-alive","Content-Length":81014337,"Content-MD5":"WBKyX0RbaSVjiwINUgEuTA==","Content-Type":"application/octet-stream","Date":1623310682000,"ETag":"5812B25F445B6925638B020D52012E4C","Last-Modified":1623310648000,"Server":"AliyunOSS","x-oss-hash-crc64ecma":"5793608435727323129","x-oss-object-type":"Normal","x-oss-request-id":"60C1C15AA846BB3737811ED8","x-oss-server-time":"17","x-oss-storage-class":"Standard"}</OssFileMetaData>
    <CreationTime>1623310685000</CreationTime>
    <OssUrl>https://******.oss-ap-********.aliyuncs.com/backup_qp.xb</OssUrl>
    <OssFileName>backup_qp.xb</OssFileName>
    <RestoreSize>20</RestoreSize>
    <OssFileSize>79115</OssFileSize>
    <Engine>mysql</Engine>
    <OssFilePath>test/backup_qp.xb</OssFilePath>
</Records>
</ListUserBackupFilesResponse>

JSON format

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

{
  "RequestId" : "9FB29A6E-C63A-4810-B71D-AFC65FD66309",
  "Records" : [ {
    "Status" : "BackupSuccess",
    "Comment" : "b-c8677aw89jo7********",
    "EngineVersion" : "5.7",
    "OssBucket" : "ghjtest",
    "BackupId" : "b-c8677aw89jo7********",
    "ModificationTime" : 1623310685000,
    "Retention" : 3,
    "OssFileMetaData" : "{\"Accept-Ranges\":\"bytes\",\"Connection\":\"keep-alive\",\"Content-Length\":81014337,\"Content-MD5\":\"WBKyX0RbaSVjiwINUgEuTA==\",\"Content-Type\":\"application/octet-stream\",\"Date\":1623310682000,\"ETag\":\"5812B25F445B6925638B020D52012E4C\",\"Last-Modified\":1623310648000,\"Server\":\"AliyunOSS\",\"x-oss-hash-crc64ecma\":\"5793608435727323129\",\"x-oss-object-type\":\"Normal\",\"x-oss-request-id\":\"60C1C15AA846BB3737811ED8\",\"x-oss-server-time\":\"17\",\"x-oss-storage-class\":\"Standard\"}",
    "CreationTime" : 1623310685000,
    "OssUrl" : "https://******.oss-ap-********.aliyuncs.com/backup_qp.xb",
    "OssFileName" : "backup_qp.xb",
    "RestoreSize" : 20,
    "OssFileSize" : 79115,
    "Engine" : "mysql",
    "OssFilePath" : "test/backup_qp.xb"
  } ]
}

Codes d'erreur

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