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.

# DescribeDBInstances
<a name="API_DescribeDBInstances"></a>

Renvoie des informations sur les instances Amazon DocumentDB provisionnées. Cette API prend en charge la pagination.

## Paramètres de demande
<a name="API_DescribeDBInstances_RequestParameters"></a>

 Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).

 ** DBInstanceIdentifier **   
L'identifiant d'instance fourni par l'utilisateur. Si ce paramètre est spécifié, les informations provenant uniquement de l'instance spécifique sont renvoyées. Ce paramètre n'est pas sensible à la casse.  
Contraintes:  
+ S'il est fourni, il doit correspondre à l'identifiant d'un existant`DBInstance`.
Type : chaîne  
Obligatoire : non

 **Filtres.Filter.N**   
Filtre qui spécifie une ou plusieurs instances à décrire.  
Filtres pris en charge :  
+  `db-cluster-id`- Accepte les identifiants de cluster et les noms de ressources Amazon du cluster (ARNs). La liste des résultats inclut uniquement les informations relatives aux instances associées aux clusters identifiés par celles-ci ARNs.
+  `db-instance-id`- Accepte les identifiants d'instance et les instances ARNs. La liste des résultats inclut uniquement les informations relatives aux instances identifiées par ces derniers ARNs.
Type : tableau d’objets [Filter](API_Filter.md)  
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

## Éléments de réponse
<a name="API_DescribeDBInstances_ResponseElements"></a>

Les éléments suivants sont renvoyés par le service.

 **DBInstances. DBInstance**N.   
Informations détaillées sur une ou plusieurs instances.   
Type : tableau d’objets [DBInstance](API_DBInstance.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
<a name="API_DescribeDBInstances_Errors"></a>

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).

 ** DBInstanceNotFound **   
 `DBInstanceIdentifier`ne fait pas référence à une instance existante.   
Code d’état HTTP :404

## Voir aussi
<a name="API_DescribeDBInstances_SeeAlso"></a>

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/DescribeDBInstances) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeDBInstances)