CheckRecoveryCondition - - Centre de documentation Alibaba Cloud

Vérifie si les données d'une instance ApsaraDB for MongoDB peuvent être restaurées.

Description de l'opération

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

Remarque

Après avoir appelé cette opération pour confirmer que les données de l'instance peuvent être restaurées, 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.	dds-bp1378****
DatabaseNames	string	Non	Le nom de la base de données source. 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 l'instance est restaurée. Spécifiez l'heure selon la norme ISO 8601 au format yyyy-MM-ddTHH:mm:ssZ. L'heure doit être en UTC. Remarque L'heure peut être un point dans le temps au cours des sept derniers jours. L'heure doit être antérieure à l'heure actuelle, mais postérieure à l'heure de création de l'instance. Vous devez spécifier l'un des paramètres RestoreTime ou BackupId.	2022-08-22T08:00:00Z
BackupId	string	Non	L'identifiant de la sauvegarde. Remarque Vous pouvez appeler l'opération DescribeBackups pour interroger l'identifiant de la sauvegarde. Vous devez spécifier l'un des paramètres RestoreTime ou BackupId. Ce paramètre ne s'applique pas aux instances de cluster fragmenté.	5664****
ResourceGroupId	string	Non	L'identifiant du groupe de ressources auquel l'instance appartient.	sg-bp179****
SourceDBInstance	string	Oui	L'identifiant de l'instance source.	dds-bp1378****
SrcRegion	string	Non	La région où réside l'instance source. Remarque Ce paramètre est requis lorsque vous définissez le paramètre RestoreType sur 2. Ce paramètre est requis lorsque vous définissez le paramètre RestoreType sur 3.	cn-beijing
DestRegion	string	Non	La région du jeu de sauvegarde utilisé pour la sauvegarde et la restauration interrégionales. Remarque Ce paramètre est requis lorsque vous définissez le paramètre RestoreType sur 3.	cn-hangzhou
RestoreType	string	Non	Le type de restauration. Remarque 0 : Les données de l'instance source sont restaurées vers une nouvelle instance dans la même région. 1 : Les données de l'instance source sont restaurées à un point antérieur dans le temps. 2 : Les données d'une instance supprimée sont restaurées vers une nouvelle instance à partir du jeu de sauvegarde. 3 : Les données d'une instance supprimée sont restaurées vers une nouvelle instance dans une autre région à partir du jeu de sauvegarde.	0
InstanceType	string	Non	L'architecture de l'instance. Valeurs valides : replicate sharding Remarque Ce paramètre est requis lorsque vous définissez le paramètre RestoreType sur 2. Ce paramètre est requis lorsque vous définissez le paramètre RestoreType sur 3.	replicate
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 renvoyées.
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 données de l'instance peuvent être restaurées. Valeurs valides : true : Les données de l'instance peuvent être restaurées. false : Les données de l'instance ne peuvent pas être restaurées.	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.	The specified RestoreTime value is invalid.
403	InvalidDBName	The specified database name is not allowed.	The specified database name is invalid.
403	InvalidMeta.TooLarge	Meta information is too large.	The metadata is too large.
403	SingleDBRestore.BackupSetNotSupport	This backup set do not support this operation.	Single-database recovery is not supported for the specified time point or backup file.
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.	The operation is not supported when log backup is enabled.
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.	No backup set is available during the specified recovery period.

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

Notes de version

Consultez Notes de version pour la liste complète.