Interroger les bases de données et les tables incluses dans un fichier de sauvegarde inter-région -

Les instances ApsaraDB RDS for MySQL prennent en charge la sauvegarde et la restauration inter-régions. Pour plus d'informations, consultez les rubriques Back up an ApsaraDB RDS for MySQL instance across regions et Restore the data of an ApsaraDB RDS for MySQL instance across regions.

Avant d'appeler cette opération, vérifiez que l'instance utilise l'un des moteurs de base de données suivants :

MySQL. Pour plus d'informations, consultez la rubrique Back up an ApsaraDB RDS for MySQL instance across regions.
SQL Server. Pour plus d'informations, consultez la rubrique Back up an ApsaraDB RDS for SQL Server instance across regions.
PostgreSQL. Pour plus d'informations, consultez la rubrique Back up an ApsaraDB RDS for PostgreSQL instance across regions.

Débogage

OpenAPI Explorer calcule automatiquement la valeur de signature. Nous vous recommandons d'appeler cette opération dans OpenAPI Explorer pour plus de commodité. OpenAPI Explorer génère dynamiquement l'exemple de code pour différents SDK.

Paramètres de requête

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeCrossBackupMetaList	Opération à exécuter. Définissez la valeur sur DescribeCrossBackupMetaList.
BackupSetId	String	Yes	123456	ID du fichier de sauvegarde inter-région à utiliser. Appelez l'opération DescribeCrossRegionBackups pour obtenir l'ID du fichier de sauvegarde inter-région.
GetDbName	String	No	testdb1	Nom de la base de données à interroger. Le système effectue une correspondance exacte selon la valeur de ce paramètre et renvoie le nom de la base de données correspondante ainsi que les noms des tables qu'elle contient.
Pattern	String	No	test	Nom de la base de données à interroger. Le système effectue une correspondance partielle (fuzzy match) selon la valeur de ce paramètre et renvoie uniquement le nom de la base de données correspondante. Remarque Vous pouvez combiner une correspondance partielle et une correspondance exacte. Par exemple, définissez le paramètre Pattern sur test pour interroger les bases de données testdb1 et testdb2. Spécifiez ensuite le paramètre GetDbName pour n'interroger que la base de données correspondante et les tables qu'elle contient.
PageSize	String	No	30	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	String	No	1	Numéro de la page à renvoyer. Valeurs valides : tout entier positif non nul. Remarque Ce paramètre n'est valide que si vous spécifiez le paramètre PageSize.
Region	String	No	cn-hangzhou	ID de région de l'instance.
ResourceGroupId	String	No	rg-acfmy*****	ID du groupe de ressources.

Paramètres de réponse

Parameter	Type	Example	Description
DBInstanceName	String	rm-uf6wjk5xxxxxxx	Instance à laquelle appartient le fichier de sauvegarde inter-région.
TotalPageCount	Integer	1	Nombre total de pages renvoyées.
RequestId	String	60F9A12A-16B8-4728-B099-4CA38D32C31C	ID de la requête.
PageRecordCount	Integer	1	Nombre d'entrées renvoyées sur la page actuelle.
TotalRecordCount	Integer	1	Nombre total d'entrées renvoyées.
PageNumber	Integer	1	Numéro de la page renvoyée.
Items	Array of Meta		Tableau contenant les informations sur les bases de données et les tables dont les données figurent dans le fichier de sauvegarde inter-région.
Meta
Tables	String	test1,test2	Tableau contenant les noms des tables de la base de données. Si la base de données contient plusieurs tables, leurs noms sont séparés par des virgules (,).
Database	String	testdb1	Nom de la base de données.
Size	String	1000	Taille de la table. Unité : Ko. Si la base de données contient plusieurs tables, leurs noms sont séparés par des virgules (,).

Exemples

Exemple de requête

http(s)://rds.aliyuncs.com/?Action=DescribeCrossBackupMetaList
&BackupSetId=123456
&GetDbName=testdb1
&PageSize=30
&PageIndex=1
&<Common request parameters>

Exemple de réponse réussie

XML format

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

<DescribeCrossBackupMetaListResponse>
<TotalRecordCount>1</TotalRecordCount>
<TotalPageCount>1</TotalPageCount>
<RequestId>60F9A12A-16B8-4728-B099-4CA38D32C31C</RequestId>
<PageNumber>1</PageNumber>
<Items>
    <Meta>
        <Size>4320</Size>
        <Size>5</Size>
        <Database>testdb1</Database>
        <Tables>test1</Tables>
        <Tables>test2</Tables>
    </Meta>
</Items>
<DBInstanceName>rm-uf6wjk5xxxxxxx</DBInstanceName>
</DescribeCrossBackupMetaListResponse>

JSON format

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

{
  "TotalRecordCount" : 1,
  "TotalPageCount" : 1,
  "RequestId" : "60F9A12A-16B8-4728-B099-4CA38D32C31C",
  "PageNumber" : 1,
  "Items" : {
    "Meta" : [ {
      "Size" : [ 4320, 5 ],
      "Database" : "testdb1",
      "Tables" : [ "test1", "test2" ]
    } ]
  },
  "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. Spécifiez une valeur valide pour le paramètre PageSize.
400	InvalidRestoreTime.Format	Specified restore time is not valid.	La valeur du paramètre RestoreTime n'est pas valide. Spécifiez une valeur valide pour le paramètre RestoreTime.
403	InvalidMeta.Empty	Meta information is empty.	La valeur du paramètre Meta est vide.
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 ; il est donc impossible de restaurer les données à un instant précis.
404	InvalidBackupSetID.NotFound	Specified backup set ID does not exist.	Le fichier de sauvegarde de données spécifié n'existe pas. Spécifiez un fichier de sauvegarde de données valide.
404	Request.NotFound	The requested resource is not available.	La ressource demandée n'est pas disponible.

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