Interroger les instances ApsaraDB RDS pour lesquelles la sauvegarde inter-régions est activée -

Avant d'appeler cette opération, assurez-vous que l'instance exécute l'une des versions de moteur de base de données et éditions RDS suivantes :

MySQL 8.0 dans l'édition Haute disponibilité (avec des disques SSD locaux)
MySQL 5.7 dans l'édition Haute disponibilité (avec des disques SSD locaux)
MySQL 5.6

Débogage

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

Paramètres de requête

Paramètre	Type	Obligatoire	Exemple	Description
Action	String	Oui	DescribeCrossRegionBackupDBInstance	Opération à effectuer. Définissez la valeur sur DescribeCrossRegionBackupDBInstance.
RegionId	String	Oui	cn-hangzhou	ID de la région.
DBInstanceId	String	Non	rm-uf6wjk5xxxxxxxxxx	ID de l'instance. Vous pouvez spécifier jusqu'à 30 ID d'instance dans une seule requête. Si vous saisissez plusieurs ID, séparez-les par des virgules (,).
PageSize	Integer	Non	30	Nombre d'entrées à renvoyer par page. Valeur par défaut : 30
PageNumber	Integer	Non	1	Numéro de la page à renvoyer. Valeurs valides : entier positif non nul. Valeur par défaut : 1.

Paramètres de réponse

Paramètre	Type	Exemple	Description
RegionId	String	cn-hangzhou	ID de la région.
TotalRecords	Integer	100	Nombre total d'entrées renvoyées.
ItemsNumbers	Integer	1	Nombre total d'éléments renvoyés pour les paramètres de sauvegarde inter-régions.
PageNumber	Integer	1	Numéro de la page renvoyée. Valeurs valides : entier positif non nul. Valeur par défaut : 1.
PageSize	Integer	30	Nombre d'entrées renvoyées par page. Valeur par défaut : 30.
RequestId	String	33517002-182D-40BE-93EC-610BD3381045	ID de la requête.
Items	Array		Tableau composé des instances et de leurs paramètres de sauvegarde inter-régions.
Item
BackupEnabled	String	Enable	État du commutateur global de sauvegarde inter-régions sur l'instance. Valeurs valides : Disable Enable
BackupEnabledTime	String	2019-06-12T05:44:21Z	Heure à laquelle la sauvegarde de données inter-régions a été activée sur l'instance. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
CrossBackupRegion	String	cn-shanghai	ID de la région de destination où sont stockées les sauvegardes inter-régions de l'instance.
CrossBackupType	String	1	Politique utilisée pour enregistrer les sauvegardes inter-régions de l'instance. Valeur par défaut : 1. La valeur par défaut 1 indique que toutes les sauvegardes inter-régions sont enregistrées.
DBInstanceDescription	String	Test database	Nom de l'instance. Le nom doit comporter entre 2 et 256 caractères. Il peut contenir des lettres, des chiffres, des traits de soulignement (_) et des traits d'union (-), et doit commencer par une lettre. Remarque Le nom de l'instance ne peut pas commencer par http:// ou https://.
DBInstanceId	String	rm-uf6wjk5xxxxxxxxxx	ID de l'instance.
DBInstanceStatus	String	Running	État de l'instance. Pour plus d'informations, consultez le tableau des états des instances.
Engine	String	MySQL	Moteur de base de données.
EngineVersion	String	5,6	Version du moteur de base de données.
LockMode	String	Unlock	État de verrouillage de l'instance. Valeurs valides : Unlock : L'instance n'est pas verrouillée. ManualLock : L'instance est verrouillée manuellement. LockByExpiration : L'instance est automatiquement verrouillée à l'expiration. LockByRestoration : L'instance est automatiquement verrouillée avant une restauration. LockByDiskQuota : L'instance est automatiquement verrouillée car son espace de stockage est épuisé. Dans ce cas, l'instance est inaccessible.
LogBackupEnabled	String	Enable	État du commutateur de sauvegarde des journaux inter-régions sur l'instance. Valeurs valides : Disable Enable
LogBackupEnabledTime	String	2019-06-12T05:44:21Z	Heure à laquelle la sauvegarde des journaux inter-régions a été activée sur l'instance. L'heure suit la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure est affichée en UTC.
RetentType	Integer	1	Politique utilisée pour conserver les sauvegardes inter-régions de l'instance. Les sauvegardes inter-régions ne peuvent être conservées que selon la période de rétention spécifiée. Valeur par défaut : 1.
Retention	Integer	15	Nombre de jours pendant lesquels les sauvegardes inter-régions de l'instance sont conservées. Valeurs valides : 7 à 1825.

Exemples

Exemples de requêtes

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

Exemples de réponses réussies

XML format

<DescribeCrossRegionBackupDBInstanceResponse>
  <Items>
		    <Item>
			      <LockMode>Unlock</LockMode>
			      <CrossBackupType>1</CrossBackupType>
			      <LogBackupEnabled>Enable</LogBackupEnabled>
			      <BackupEnabledTime>2019-06-12T05:44:21Z</BackupEnabledTime>
			      <BackupEnabled>Enable</BackupEnabled>
			      <RetentType>1</RetentType>
			      <DBInstanceId>rm-bpxxxxx</DBInstanceId>
			      <Retention>15</Retention>
			      <DBInstanceDescription>Test database</DBInstanceDescription>
			      <Engine>MySQL</Engine>
			      <LogBackupEnabledTime>2019-06-12T05:44:21Z</LogBackupEnabledTime>
			      <CrossBackupRegion>cn-shanghai</CrossBackupRegion>
			      <EngineVersion>5.6</EngineVersion>
			      <DBInstanceStatus>Running</DBInstanceStatus>
		    </Item>
	  </Items>
	  <PageNumber>1</PageNumber>
	  <RegionId>cn-hangzhou</RegionId>
	  <RequestId>33517002-182D-40BE-93EC-610BD3381045</RequestId>
	  <ItemsNumbers>1</ItemsNumbers>
	  <TotalRecords>1</TotalRecords>
</DescribeCrossRegionBackupDBInstanceResponse>

JSON format

{
    "Items": {
        "Item": [
            {
                "LockMode": "Unlock",
                "CrossBackupType": "1",
                "LogBackupEnabled": "Enable",
                "BackupEnabledTime": "2019-06-12T05:44:21Z",
                "BackupEnabled": "Enable",
                "RetentType": 1,
                "DBInstanceId": "rm-bpxxxxx",
                "Retention": 15,
                "DBInstanceDescription": "Test database",
                "Engine": "MySQL",
                "LogBackupEnabledTime": "2019-06-12T05:44:21Z",
                "CrossBackupRegion": "cn-shanghai",
                "EngineVersion": "5.6",
                "DBInstanceStatus": "Running"
            }
        ]
    },
    "PageNumber": 1,
    "RegionId": "cn-hangzhou",
    "RequestId": "33517002-182D-40BE-93EC-610BD3381045",
    "ItemsNumbers": 1,
    "TotalRecords": 1
}

Codes d'erreur

Code HTTP	Code d'erreur	Message d'erreur	Description
403	IncorrectDBInstanceEngine	Current DB Instance engine does not support this operation.	Message d'erreur indiquant que le moteur de base de données de l'instance ne prend pas en charge cette opération.

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