Interroger un fichier de sauvegarde de données pour les bases de données et les tables -

Avant d'appeler l'opération RestoreTable afin de restaurer des bases de données ou des tables individuelles d'une instance ApsaraDB RDS for MySQL, utilisez cette opération pour identifier les éléments éligibles à la restauration. Pour plus d'informations, consultez la rubrique Restaurer des bases de données et des tables individuelles d'une instance ApsaraDB RDS for MySQL .

Remarque

Cette opération est prise en charge uniquement lorsque l'instance exécute MySQL 8.0, MySQL 5.7 ou MySQL 5.6 sur l'édition Haute disponibilité (High-availability Edition) d'ApsaraDB RDS avec des disques SSD locaux.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Par souci de simplicité, nous vous recommandons d'appeler cette opération dans OpenAPI Explorer. Celui-ci génère dynamiquement l'exemple de code de l'opération pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeMetaList	L'opération que vous souhaitez exécuter. Définissez la valeur sur DescribeMetaList.
ClientToken	String	No	ETnLKlblzczshOTUbOCzxxxxxxxxxx	Le jeton client utilisé pour garantir l'idempotence de la requête. Vous pouvez utiliser le client pour générer la valeur, mais vous devez vous assurer que le jeton généré est unique parmi les différentes requêtes. Le jeton ne peut contenir que des caractères ASCII et ne doit pas dépasser 64 caractères.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxx	L'ID de l'instance. Appelez l'opération DescribeDBInstances pour interroger l'ID de l'instance.
RestoreType	String	No	BackupSetID	La méthode utilisée pour restaurer les données. Valeurs valides : BackupSetID : Restaure les données à partir d'un fichier de sauvegarde de données. Si vous utilisez cette valeur, vous devez également spécifier le paramètre BackupSetID. RestoreTime : Restaure les données à un instant précis. Si vous utilisez cette valeur, vous devez également spécifier le paramètre RestoreTime. Valeur par défaut : BackupSetID.
BackupSetID	Integer	No	14358	L'ID du fichier de sauvegarde de données à partir duquel vous souhaitez restaurer les données. Appelez l'opération DescribeBackups pour interroger les ID des fichiers de sauvegarde de données. Remarque Ce paramètre est requis lorsque vous définissez le paramètre RestoreType sur BackupSetID.
RestoreTime	String	No	2019-05-30T03:29:10Z	L'instant précis auquel vous souhaitez restaurer les données. L'instant spécifié doit être antérieur à l'heure actuelle. Spécifiez l'heure au format ISO 8601 yyyy-MM-ddTHH:mm:ssZ. L'heure doit être exprimée en UTC. Appelez l'opération DescribeBackups pour interroger la plage de temps restaurable. Remarque Ce paramètre est requis lorsque vous définissez le paramètre RestoreType sur RestoreTime.
GetDbName	String	No	testdb1	Le nom de la base de données à interroger. ApsaraDB RDS effectue une correspondance exacte basée sur la valeur de ce paramètre et renvoie le nom de la base de données correspondante ainsi que les noms de toutes les tables qu'elle contient. Remarque Si vous laissez ce paramètre vide, ApsaraDB RDS renvoie toutes les bases de données créées sur l'instance.
Pattern	String	No	test	Le nom de la base de données à interroger. ApsaraDB RDS effectue une correspondance floue basée sur la valeur de ce paramètre et renvoie uniquement les noms des bases de données correspondantes. Remarque Par exemple, si vous définissez la valeur sur `test`, ApsaraDB RDS renvoie `testdb1` et `testdb2`. Vous pouvez ensuite spécifier le paramètre GetDbName pour interroger les tables de la base de données souhaitée.
PageSize	Integer	No	1	Le nombre d'entrées à renvoyer par page. Valeur par défaut : 1. Remarque Ce paramètre n'est valide que si vous spécifiez le paramètre PageIndex.
PageIndex	Integer	No	1	Le numéro de la page à renvoyer. Valeurs valides : tout entier positif non nul. Valeur par défaut : 1. Remarque Ce paramètre n'est valide que si vous spécifiez le paramètre PageSize.
ResourceGroupId	String	No	rg-acfmy*****	L'ID du groupe de ressources.

Paramètres de réponse

Parameter	Type	Example	Description
DBInstanceName	String	rm-uf6wjk5xxxxxxx	Le nom de l'instance.
TotalPageCount	Integer	1	Le nombre total de pages renvoyées.
RequestId	String	60F9A12A-16B8-4728-B099-4CA38D32C31C	L'ID de la requête.
PageRecordCount	Integer	1	Le nombre d'entrées renvoyées sur la page actuelle.
TotalRecordCount	Integer	1	Le nombre total d'entrées renvoyées.
PageNumber	Integer	1	Le numéro de la page renvoyée.
Items	Array of Meta		Un tableau contenant les informations sur les bases de données et les tables dont les données sont incluses dans le fichier de sauvegarde de données.
Meta
Tables	String	test1	Le nom de la table.
Database	String	testdb1	Le nom de la base de données.
Size	String	64	La taille de la table. Unité : Ko.

Exemples

Exemple de requête

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

Exemple de réponse réussie

Format XML

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

<DescribeMetaList>
    <TotalPageCount>1</TotalPageCount>
    <TotalRecordCount>1</TotalRecordCount>
    <PageRecordCount>1</PageRecordCount>
    <RequestId>60F9A12A-16B8-4728-B099-4CA38D32C31C</RequestId>
    <PageNumber>1</PageNumber>
    <Items>
        <Meta>
            <Size>64</Size>
            <Database>testdb1</Database>
            <Tables>test1</Tables>
        </Meta>
    </Items>
    <DBInstanceName>rm-uf6wjk5xxxxxxx</DBInstanceName>
</DescribeMetaList>

Format JSON

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

{
  "TotalPageCount" : "1",
  "TotalRecordCount" : "1",
  "PageRecordCount" : "1",
  "RequestId" : "60F9A12A-16B8-4728-B099-4CA38D32C31C",
  "PageNumber" : "1",
  "Items" : {
    "Meta" : [ {
      "Size" : "64",
      "Database" : "testdb1",
      "Tables" : "test1"
    } ]
  },
  "DBInstanceName" : "rm-uf6wjk5xxxxxxx"
}

Codes d'erreur

HTTP status code	Error code	Error message	Description
400	InvalidPageSize	The page size is invalid	La valeur du paramètre pageSize n'est pas valide. Saisissez un nombre valide.
400	InvalidRestoreTime.Format	Specified restore time is not valid.	L'heure de restauration spécifiée n'est pas valide. Saisissez une heure valide.
403	InvalidMeta.Empty	Meta information is empty.	Les métadonnées sont vides.
403	IncorrectDBInstanceType	Current DB instance type does not support this operation.	Cette opération n'est pas prise en charge lorsque l'instance se trouve dans l'état actuel.
403	IncorrectEngineVersion	Current engine version does not support operations.	Cette opération n'est pas prise en charge pour la version du moteur de base de données exécutée sur l'instance.
403	InvalidBackupLogStatus	Current backup log enable status does not support this operation.	La fonctionnalité de sauvegarde des journaux est désactivée et les données ne peuvent pas être restaurées à un instant précis.
404	InvalidBackupSetID.NotFound	Specified backup set ID does not exist.	Le fichier de sauvegarde de données spécifié est introuvable. Vérifiez les fichiers de sauvegarde de données existants.

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