CheckRecoveryCondition - - Centre de documentation Alibaba Cloud

Vérifie si une instance MongoDB remplit les conditions de restauration des données.

Description de l'opération

Cette opération s'applique aux instances de jeu de réplicas ou aux instances de cluster fragmenté.

Remarque

Après avoir appelé cette opération pour confirmer que les conditions de restauration des données sont remplies, vous pouvez appeler l'opération CreateDBInstance pour restaurer les données vers une nouvelle instance.

Testez maintenant

Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale. Testez cette API dans OpenAPI Explorer, sans signature manuelle. Les appels réussis génèrent automatiquement du code SDK correspondant à vos paramètres. Téléchargez-le avec une sécurité intégrée des identifiants pour une utilisation locale.

Test

Autorisation RAM

Le tableau ci-dessous décrit les autorisations nécessaires pour appeler cette API. Vous pouvez les définir dans une politique Resource Access Management (RAM). Les colonnes du tableau sont détaillées ci-dessous :

Action : les actions peuvent être utilisées dans l'élément Action des instructions de politique de permissions RAM pour accorder les autorisations nécessaires à l'exécution de l'opération.
API : l'API que vous pouvez appeler pour exécuter l'action.
Niveau d'accès : le niveau d'accès prédéfini accordé pour chaque API. Valeurs valides : create, list, get, update et delete.
Type de ressource : le type de ressource qui prend en charge l'autorisation pour exécuter l'action. Il indique si l'action prend en charge les permissions au niveau de la ressource. La ressource spécifiée doit être compatible avec l'action. Sinon, la politique sera inefficace.
- Pour les API avec permissions au niveau de la ressource, les types de ressource requis sont marqués d'un astérisque (*). Spécifiez l'Alibaba Cloud Resource Name (ARN) correspondant dans l'élément Resource de la politique.
- Pour les API sans permissions au niveau de la ressource, la valeur All Resources est affichée. Utilisez un astérisque (*) dans l'élément Resource de la politique.
Clé de condition : les clés de condition définies par le service. La clé permet un contrôle granulaire, applicable aux actions seules ou aux actions associées à des ressources spécifiques. En plus des clés de condition propres au service, Alibaba Cloud fournit un ensemble de clés de condition communes applicables à tous les services pris en charge par RAM.
Action dépendante : les actions dépendantes requises pour exécuter l'action. Pour mener à bien l'opération, l'utilisateur RAM ou le rôle RAM doit disposer des permissions pour toutes les actions dépendantes.

dds:CheckRecoveryCondition

get

*Instance

acs:dds:{#regionId}:{#accountId}:dbinstance/{#dbinstanceId}

Aucune

Paramètres de requête

Paramètre	Type	Requis	Description	Exemple
SourceDBInstance	string	Oui	L'identifiant de l'instance source à restaurer.	dds-bp1378****
DatabaseNames	string	Non	Les noms des bases de données à restaurer. La valeur est un tableau JSON. Remarque Si vous ne spécifiez pas ce paramètre, toutes les bases de données sont restaurées par défaut.	["db1","db2"]
RestoreTime	string	Non	Le point dans le temps auquel vous souhaitez restaurer l'instance. Spécifiez l'heure au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être en UTC. Remarque La valeur peut être n'importe quel point dans le temps au cours des sept derniers jours. La valeur doit être antérieure à l'heure actuelle et postérieure à l'heure de création de l'instance. Vous devez spécifier soit ce paramètre, soit le paramètre BackupId.	2022-08-22T08:00:00Z
BackupId	string	Non	L'identifiant du jeu de sauvegarde. Remarque Vous pouvez appeler l'opération DescribeBackups pour interroger l'identifiant de la sauvegarde. Vous devez spécifier soit ce paramètre, soit le paramètre RestoreTime. Ce paramètre n'est pas pris en charge pour les instances de cluster fragmenté.	5664****
ResourceGroupId	string	Non	L'identifiant du groupe de ressources.	sg-bp179****
SourceDBInstance	string	Oui	La zone où réside l'instance source. Remarque Ce paramètre est requis lorsque le type de restauration de sauvegarde consiste à reconstruire une instance supprimée. Ce paramètre est requis lorsque le type de restauration de sauvegarde est le clonage avec redondance géographique.	cn-beijing
SrcRegion	string	Non	La zone où réside le jeu de sauvegarde lors d'une restauration avec redondance géographique. Remarque Ce paramètre est requis lorsque le type de restauration de sauvegarde est le clonage avec redondance géographique.	cn-hangzhou
DestRegion	string	Non	Le type de restauration de sauvegarde. Valeurs valides : Remarque 0 : restauration de sauvegarde locale 1 : restauration à un point dans le temps locale 2 : restauration de sauvegarde d'une instance supprimée à l'aide d'un jeu de sauvegarde 3 : restauration de sauvegarde avec redondance géographique à l'aide d'un jeu de sauvegarde	0
RestoreType	string	Non	Le type d'instance. Valeurs valides : replicate sharding Remarque Ce paramètre est requis lorsque le type de restauration de sauvegarde consiste à reconstruire une instance supprimée. Ce paramètre est requis lorsque le type de restauration de sauvegarde est le clonage avec redondance géographique.	replicate
InstanceType	string	Non	La version de la base de données. Valeurs valides : 8.0 7.0 6.0 5.0 4.4 4.2 4.0	4.2
EngineVersion	string	Non	La version du moteur de base de données de l'instance. 6.0 5.0 4.4 4.2 4.0 3.4	4.2

Éléments de réponse

Élément	Type	Description	Exemple
	object	Les informations de réponse.
RequestId	string	L'identifiant de la requête.	D563A3E7-6010-45FE-A0CD-9283414C9657
DBInstanceName	string	L'identifiant de l'instance.	dds-bp1378****
IsValid	boolean	Indique si les conditions de restauration sont remplies. Valeurs valides : true : Les conditions sont remplies. false : Les conditions ne sont pas remplies.	true

Exemples

JSON format

{
  "RequestId": "D563A3E7-6010-45FE-A0CD-9283414C9657",
  "DBInstanceName": "dds-bp1378****",
  "IsValid": true
}

Codes d'erreur

Code de statut HTTP	Code d'erreur	Message d'erreur	Description
400	InvalidMeta.WrongFormat	Meta information is wrong formatter.
400	InvalidRestoreTime.Format	Specified restore time is not valid.	Le paramètre RestoreTime spécifié n'est pas valide. Vérifiez que le paramètre d'entrée est correct.
403	InvalidDBName	The specified database name is not allowed.	Le nom de base de données spécifié n'est pas valide.
403	InvalidMeta.TooLarge	Meta information is too large.	Les métadonnées sont trop volumineuses.
403	SingleDBRestore.BackupSetNotSupport	This backup set do not support this operation.	Le point dans le temps ou le fichier de sauvegarde sélectionné ne prend pas en charge la restauration d'une base de données unique.
403	IncorrectDBInstanceType	Current DB instance type does not support this operation.
403	IncorrectEngineVersion	Current engine version does not support operations.
403	InvalidBackupLogStatus	Current backup log enable status does not support this operation.	L'état actuel du journal de sauvegarde ne prend pas en charge cette opération.
403	IncorrectBackupSetState	Current backup set state does not support operations..
404	InvalidBackupSetID.NotFound	Specifiedbackup set ID does not exist.
404	InvalidBackup.NotFound	Theavailable backup does not exist in recovery time.	Aucune sauvegarde n'est disponible dans la période de restauration spécifiée.

Consultez Codes d'erreur pour la liste complète.

Notes de version

Consultez Notes de version pour la liste complète.