DeleteDBCluster - Amazon DocumentDB
Paramètres de demandeÉléments de réponseErreursconsultez aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

DeleteDBCluster

Supprime un cluster précédemment provisionné. Lorsque vous supprimez un cluster, toutes les sauvegardes automatiques de ce cluster sont supprimées et ne peuvent pas être restaurées. Les instantanés manuels du cluster de base de données du cluster spécifié ne sont pas supprimés.

Paramètres de demande

Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez Paramètres courants.

DBClusterIdentifier

Identifiant du cluster à supprimer. Ce paramètre n'est pas sensible à la casse.

Contraintes :

  • Doit correspondre à un existantDBClusterIdentifier.

Type : chaîne

Obligatoire : oui

FinalDBSnapshotIdentifier

L'identifiant de capture d'écran de cluster du nouveau cliché de cluster créé lorsque SkipFinalSnapshot ce paramètre est défini surfalse.

Note

Le fait de spécifier ce paramètre et de le SkipFinalShapshot définir également sur true entraîne une erreur.

Contraintes :

  • Il doit comporter de 1 à 255 lettres, chiffres ou traits d'union.

  • Le premier caractère doit être une lettre.

  • Ne peut pas se terminer par un trait d'union ni contenir deux traits d'union consécutifs.

Type : chaîne

Obligatoire : non

SkipFinalSnapshot

Détermine si un instantané final du cluster est créé avant la suppression du cluster. Si cette true option est spécifiée, aucun instantané de cluster n'est créé. Si cela false est spécifié, un instantané de cluster est créé avant que le cluster de base de données ne soit supprimé.

Note

Dans SkipFinalSnapshot l'falseaffirmative, vous devez spécifier un FinalDBSnapshotIdentifier paramètre.

Par défaut : false

Type : booléen

Obligatoire : non

Éléments de réponse

L'élément suivant est renvoyé par le service.

DBCluster

Informations détaillées sur un cluster.

Type : objet DBCluster

Erreurs

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez Erreurs courantes.

DBClusterNotFoundFault

DBClusterIdentifierne fait pas référence à un cluster existant.

Code d’état HTTP : 404

DBClusterSnapshotAlreadyExistsFault

Vous disposez déjà d'un instantané du cluster avec l'identifiant indiqué.

Code d’état HTTP : 400

InvalidDBClusterSnapshotStateFault

La valeur fournie n'est pas un état de capture d'écran de cluster valide.

Code d’état HTTP : 400

InvalidDBClusterStateFault

Le cluster n'est pas dans un état valide.

Code d’état HTTP : 400

SnapshotQuotaExceeded

La demande vous obligerait à dépasser le nombre autorisé de clichés.

Code d’état HTTP : 400

consultez aussi

Pour plus d'informations sur l'utilisation de cette API dans l'un des AWS SDK spécifiques au langage, consultez les pages suivantes :