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.
# DescribeDBClusterSnapshots
Renvoie des informations sur les instantanés du cluster. Cette opération d'API prend en charge la pagination.
## Paramètres de demande
Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).
** DBClusterIdentifier **
ID du cluster pour lequel récupérer la liste des instantanés du cluster. Ce paramètre ne peut pas être utilisé avec le `DBClusterSnapshotIdentifier` paramètre. Ce paramètre n'est pas sensible à la casse.
Contraintes:
+ S'il est fourni, il doit correspondre à l'identifiant d'un existant`DBCluster`.
Type : chaîne
Obligatoire : non
** DBClusterSnapshotIdentifier **
Identifiant de capture d'écran spécifique du cluster à décrire. Ce paramètre ne peut pas être utilisé avec le `DBClusterIdentifier` paramètre. Cette valeur est stockée sous la forme d’une chaîne en minuscules.
Contraintes:
+ S'il est fourni, il doit correspondre à l'identifiant d'un existant`DBClusterSnapshot`.
+ Si cet identifiant est destinée à un instantané automatisé, le paramètre `SnapshotType` doit également être spécifié.
Type : chaîne
Obligatoire : non
**Filtres.Filter.N**
Ce paramètre n'est actuellement pas pris en charge.
Type : tableau d’objets [Filter](API_Filter.md)
Obligatoire : non
** IncludePublic **
Définissez sur `true` pour inclure les instantanés de cluster manuels qui sont publics et peuvent être copiés ou restaurés par n'importe qui Compte AWS, ou autrement`false`. La valeur par défaut est `false`.
Type : booléen
Obligatoire : non
** IncludeShared **
Définissez sur `true` pour inclure les instantanés de cluster manuels partagés provenant d'autres Comptes AWS entités autorisées à copier ou à restaurer, etc. Compte AWS `false` La valeur par défaut est `false`.
Type : booléen
Obligatoire : non
** Marker **
Jeton de pagination facultatif fourni par une demande précédente. Si ce paramètre est spécifié, la réponse inclut uniquement des enregistrements supérieurs au marqueur, jusqu'à la valeur spécifiée par `MaxRecords`.
Type : chaîne
Obligatoire : non
** MaxRecords **
Nombre maximal d'enregistrements à inclure dans la réponse. S'il existe plus d'enregistrements que la `MaxRecords` valeur spécifiée, un jeton de pagination (marqueur) est inclus dans la réponse afin que les résultats restants puissent être récupérés.
Par défaut : 100
Contraintes : Minimum 20, maximum 100.
Type : Integer
Obligatoire : non
** SnapshotType **
Type de snapshots de cluster à renvoyer. Vous pouvez spécifier l’une des valeurs suivantes :
+ `automated`- Renvoie tous les instantanés de cluster qu'Amazon DocumentDB a automatiquement créés pour vous. Compte AWS
+ `manual`- Renvoie tous les instantanés de cluster que vous avez créés manuellement pour votre Compte AWS.
+ `shared`- Renvoie tous les instantanés de cluster manuels qui ont été partagés avec votre Compte AWS.
+ `public`- Renvoie tous les instantanés du cluster marqués comme publics.
Si vous ne spécifiez aucune `SnapshotType` valeur, les instantanés de cluster automatisés et manuels sont renvoyés. Vous pouvez inclure des instantanés de cluster partagés avec ces résultats en définissant le `IncludeShared` paramètre sur. `true` Vous pouvez inclure des instantanés de clusters publics avec ces résultats en définissant le `IncludePublic` paramètre sur. `true`
Les paramètres `IncludeShared` et `IncludePublic` ne s'appliquent pas pour les valeurs `SnapshotType` de `manual` ou `automated`. Le paramètre `IncludePublic` ne s'applique pas lorsque `SnapshotType` est défini sur `shared`. Le paramètre `IncludeShared` ne s'applique pas lorsque `SnapshotType` est défini sur `public`.
Type : chaîne
Obligatoire : non
## Éléments de réponse
Les éléments suivants sont renvoyés par le service.
**DBClusterInstantanés. DBClusterSnapshot.N**
Fournit une liste des instantanés du cluster.
Type : tableau d’objets [DBClusterSnapshot](API_DBClusterSnapshot.md)
** Marker **
Jeton de pagination facultatif fourni par une demande précédente. Si ce paramètre est spécifié, la réponse inclut uniquement des enregistrements supérieurs au marqueur, jusqu'à la valeur spécifiée par `MaxRecords`.
Type : Chaîne
## Erreurs
Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).
** DBClusterSnapshotNotFoundFault **
`DBClusterSnapshotIdentifier`ne fait pas référence à un instantané de cluster existant.
Code d’état HTTP :404
## Voir aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeDBClusterSnapshots)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeDBClusterSnapshots)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeDBClusterSnapshots)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeDBClusterSnapshots)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeDBClusterSnapshots)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeDBClusterSnapshots)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeDBClusterSnapshots)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeDBClusterSnapshots)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeDBClusterSnapshots)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeDBClusterSnapshots)