Interroger les fichiers de sauvegarde de données interrégionaux -

Pour savoir comment interroger les fichiers de sauvegarde de journaux interrégionaux d'une instance RDS, consultez DescribeCrossRegionLogBackupFiles .

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 Sauvegarder une instance ApsaraDB RDS for MySQL entre régions .
SQL Server. Pour plus d'informations, consultez Sauvegarder une instance ApsaraDB RDS for SQL Server entre régions .
PostgreSQL. Pour plus d'informations, consultez Sauvegarder une instance ApsaraDB RDS for PostgreSQL entre régions .

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

Parameter	Type	Required	Example	Description
Action	String	Yes	DescribeCrossRegionBackups	Opération à effectuer. Définissez la valeur sur DescribeCrossRegionBackups.
DBInstanceId	String	Yes	rm-uf6wjk5xxxxxxxxxx	ID de l'instance.
RegionId	String	Yes	cn-hangzhou	ID de région de l'instance.
CrossBackupRegion	String	No	cn-shanghai	ID de la région de destination où le fichier de sauvegarde de données interrégional est stocké.
CrossBackupId	Integer	No	14562	ID du fichier de sauvegarde de données interrégional. Remarque Vous devez spécifier le paramètre CrossBackupId ou les paramètres StartTime et EndTime.
StartTime	String	No	2019-05-30T12:10:00Z	Début de la plage de temps à interroger. Spécifiez l'heure au format ISO 8601 yyyy-MM-ddTHH:mm:ssZ (UTC).
EndTime	String	No	2019-06-15T12:10:00Z	Fin de la plage de temps à interroger. Spécifiez l'heure au format ISO 8601 yyyy-MM-ddTHH:mm:ssZ (UTC).
PageSize	Integer	No	30	Nombre d'entrées à renvoyer par page. Valeurs valides : 30 50 100 Valeur par défaut : 30.
PageNumber	Integer	No	1	Numéro de la page à renvoyer. Valeurs valides : tout entier positif non nul. Valeur par défaut : 1.
BackupId	Integer	No	603524***	ID du fichier de sauvegarde de données interrégional.
ResourceGroupId	String	No	rg-acfmy*****	ID du groupe de ressources.

Paramètres de réponse

Parameter	Type	Example	Description
EndTime	String	2019-06-15T12:10:00Z	Fin de la plage de temps interrogée.
StartTime	String	2019-05-30T12:10:00Z	Début de la plage de temps interrogée.
RequestId	String	60912B41-7579-4B5D-B289-8856030F0A6A	ID de la requête.
PageRecordCount	Integer	30	Nombre de fichiers de sauvegarde de données interrégionaux sur la page actuelle.
TotalRecordCount	Integer	100	Nombre total d'entrées renvoyées.
PageNumber	Integer	1	Numéro de la page renvoyée. Valeurs valides : tout entier positif non nul. Valeur par défaut : 1.
RegionId	String	cn-hangzhou	ID de région de l'instance.
Items	Array of Item		Tableau contenant les détails des fichiers de sauvegarde de données interrégionaux.
Item
ConsistentTime	String	2019-06-12T05:44:46Z	Point dans le temps indiqué par les données du fichier de sauvegarde de données interrégional.
DBInstanceStorageType	String	ssd	Type de stockage. Valeurs valides : local_ssd : SSD local. Type de stockage recommandé. cloud_ssd : SSD standard. cloud_essd : SSD amélioré (ESSD).
CrossBackupId	Integer	14377	ID du fichier de sauvegarde de données interrégional.
BackupType	String	F	Type de sauvegarde de données interrégionale. Valeurs valides : F : sauvegarde complète des données I : sauvegarde incrémentielle des données
BackupStartTime	String	2019-05-30T12:10:00Z	Heure de début de la sauvegarde de données interrégionale.
CrossBackupSetLocation	String	oss	Emplacement de stockage du fichier de sauvegarde de données interrégional.
InstanceId	Integer	8161055	ID de l'instance. Ce paramètre permet de déterminer si l'instance qui génère le fichier de sauvegarde de données interrégional est une instance principale ou secondaire.
CrossBackupDownloadLink	String	http://rdsddrbak-shanghai.oss-cn-shanghai.aliyuncs.com/xxxxx	URL externe permettant de télécharger le fichier de sauvegarde de données interrégional.
BackupEndTime	String	2019-06-15T12:10:00Z	Heure de génération du fichier de sauvegarde de données interrégional.
EngineVersion	String	5,6	Version du moteur de base de données.
BackupSetStatus	Integer	0	État de la sauvegarde de données interrégionale. Valeurs valides : 0 : La sauvegarde de données interrégionale a réussi. 1 : La sauvegarde de données interrégionale a échoué.
CrossBackupSetFile	String	cn-hangzhou_rm-xxxxx_hins81xxx_data_20190612134426_qp.xb	Nom du package compressé contenant le fichier de sauvegarde de données interrégional.
BackupSetScale	Integer	0	Niveau auquel le fichier de sauvegarde de données interrégional est généré. 0 : sauvegarde au niveau de l'instance 1 : sauvegarde au niveau de la base de données
CrossBackupSetSize	Long	5312836	Taille du fichier de sauvegarde de données interrégional. Unité : octets.
CrossBackupRegion	String	cn-shanghai	ID de la région de destination où le fichier de sauvegarde de données interrégional de l'instance est stocké.
Category	String	HighAvailability	Édition RDS de l'instance. Valeurs valides : Basic : Édition Basic. HighAvailability : Édition Haute disponibilité. Finance : Édition Enterprise. Cette édition est prise en charge uniquement par le site Chine (aliyun.com).
Engine	String	mysql	Moteur de la base de données.
BackupMethod	String	P	Méthode utilisée pour générer le fichier de sauvegarde de données interrégional. Valeurs valides : L : sauvegarde logique P : sauvegarde physique
RestoreRegions	Array of String	"cn-hangzhou", "cn-shanghai"	Tableau contenant les régions vers lesquelles le fichier de sauvegarde de données interrégional peut être restauré.

Exemples

Exemples de requêtes

http(s)://rds.aliyuncs.com/?Action=DescribeCrossRegionBackups
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&RegionId=cn-hangzhou
&CrossBackupId=14562
&<Common request parameters>

Exemples de réponses réussies

XML format

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

<DescribeCrossRegionBackupsResponse>
<Items>
		<Item>
			<CrossBackupSetFile>cn-hangzhou_rm-bpxxxxx_hins798xxxx_data_20190611125201.tar.gz</CrossBackupSetFile>
			<BackupSetScale>0</BackupSetScale>
			<BackupType>F</BackupType>
			<InstanceId>7980000</InstanceId>
			<CrossBackupId>14358</CrossBackupId>
			<BackupEndTime>2019-06-11T04:55:02Z</BackupEndTime>
			<BackupMethod>P</BackupMethod>
			<CrossBackupSetLocation>oss</CrossBackupSetLocation>
			<CrossBackupSetSize>2179643</CrossBackupSetSize>
			<Engine>mysql</Engine>
			<BackupStartTime>2019-06-11T04:52:46Z</BackupStartTime>
			<CrossBackupDownloadLink>http://rdsddrbak-zb.oss-cn-zhangjiakou.aliyuncs.com/cn-hangzhou_rm-bpxxxxx_hins7986073_data_20190611125201.tar.gz?OSSAccessKeyId=LTAxxxxx&amp;Expires=1560501641&amp;Signature=laK0kxxxxx%3D</CrossBackupDownloadLink>
			<Category>HighAvailability</Category>
			<CrossBackupRegion>cn-zhangjiakou</CrossBackupRegion>
			<RestoreRegions>
				<RestoreRegion>cn-hangzhou</RestoreRegion>
				<RestoreRegion>cn-zhangjiakou</RestoreRegion>
			</RestoreRegions>
			<EngineVersion>5.7</EngineVersion>
			<DBInstanceStorageType>ssd</DBInstanceStorageType>
		</Item>
	</Items>
	<TotalRecordCount>1</TotalRecordCount>
	<PageNumber>1</PageNumber>
	<RequestId>60912B41-7579-4B5D-B289-8856030F0A6A</RequestId>
	<RegionId>cn-hangzhou</RegionId>
	<EndTime>2019-06-11T08:00:00Z</EndTime>
	<StartTime>2019-06-10T00:00:00Z</StartTime>
	<PageRecordCount>30</PageRecordCount>
    </DescribeCrossRegionBackupsResponse>

JSON format

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

{
  "Items" : {
    "Item" : [ {
      "CrossBackupSetFile" : "cn-hangzhou_rm-bpxxxxx_hins798xxxx_data_20190611125201.tar.gz",
      "BackupSetScale" : 0,
      "BackupType" : "F",
      "InstanceId" : 7980000,
      "CrossBackupId" : 14358,
      "BackupEndTime" : "2019-06-11T04:55:02Z",
      "BackupMethod" : "P",
      "CrossBackupSetLocation" : "oss",
      "CrossBackupSetSize" : 2179643,
      "Engine" : "mysql",
      "BackupStartTime" : "2019-06-11T04:52:46Z",
      "CrossBackupDownloadLink" : "http://rdsddrbak-zb.oss-cn-zhangjiakou.aliyuncs.com/cn-hangzhou_rm-bpxxxxx_hins7986073_data_20190611125201.tar.gz?OSSAccessKeyId=LTAxxxxx&Expires=1560501641&Signature=laK0kxxxxx%3D",
      "Category" : "HighAvailability",
      "CrossBackupRegion" : "cn-zhangjiakou",
      "RestoreRegions" : {
        "RestoreRegion" : [ "cn-hangzhou", "cn-zhangjiakou" ]
      },
      "EngineVersion" : "5.7",
      "DBInstanceStorageType" : "ssd"
    } ]
  },
  "TotalRecordCount" : 1,
  "PageNumber" : 1,
  "RequestId" : "60912B41-7579-4B5D-B289-8856030F0A6A",
  "RegionId" : "cn-hangzhou",
  "EndTime" : "2019-06-11T08:00:00Z",
  "StartTime" : "2019-06-10T00:00:00Z",
  "PageRecordCount" : 30
}

Codes d'erreur

HTTP Status code	Error code	Error message	Description
400	InvalidRegion.Format	Specified Region is not valid.	La région spécifiée n'est pas valide.
400	InvalidStartTime.Format	Specified start time is not valid.	L'heure de début spécifiée n'est pas valide.
400	InvalidEndTime.Format	Specified end time is not valid.	L'heure de fin spécifiée n'est pas valide. Spécifiez une valeur valide et réessayez.
400	InvalidTime.Format	Specified time is not valid.	Le format de l'heure spécifié n'est pas valide.
403	CrossBackupNotSupport	Specified region not support cross region backup.	La région spécifiée ne prend pas en charge la fonctionnalité de sauvegarde interrégionale.
404	InvalidDBInstance.NotFound	Specified instance does not exist or not support.	L'instance est introuvable, supprimée ou ne prend pas en charge l'opération.

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