

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Restituisce informazioni sulle istanze Amazon DocumentDB assegnate. Quest'API supporta la paginazione.

## Parametri della richiesta
<a name="API_DescribeDBInstances_RequestParameters"></a>

 Per informazioni sui parametri comuni per tutte le azioni, consulta [Parametri comuni](CommonParameters.md).

 ** DBInstanceIdentifier **   
L'identificatore dell'istanza fornito dall'utente. Se viene specificato questo parametro, vengono restituite solo le informazioni relative all'istanza specifica. Questo parametro non fa distinzione tra maiuscole e minuscole.  
Vincoli:  
+ Se fornito, deve corrispondere all'identificatore di un'esistente`DBInstance`.
▬Tipo: stringa  
Obbligatorio: no

 **Filtri.Filtro.N**   
Un filtro che specifica una o più istanze da descrivere.  
Filtri supportati:  
+  `db-cluster-id`- Accetta identificatori di cluster e Amazon Resource Names (ARNs) del cluster. L'elenco dei risultati include solo le informazioni sulle istanze associate ai cluster da questi identificati. ARNs
+  `db-instance-id`- Accetta identificatori di istanza e istanze. ARNs L'elenco dei risultati include solo le informazioni sulle istanze da queste identificate. ARNs
Tipo: matrice di oggetti [Filter](API_Filter.md)  
Obbligatorio: no

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
▬Tipo: stringa  
Obbligatorio: no

 ** MaxRecords **   
 Numero massimo di record da includere nella risposta. Se esistono più record rispetto al `MaxRecords` valore specificato, nella risposta viene incluso un token di impaginazione (marker) in modo da poter recuperare i risultati rimanenti.  
Impostazione predefinita: 100  
Vincoli: minimo 20, massimo 100.  
Tipo: Integer  
Obbligatorio: no

## Elementi di risposta
<a name="API_DescribeDBInstances_ResponseElements"></a>

I seguenti elementi vengono restituiti dal servizio.

 **DBInstances. DBInstance**N.   
Informazioni dettagliate su una o più istanze.   
Tipo: matrice di oggetti [DBInstance](API_DBInstance.md)

 ** Marker **   
Token di paginazione opzionale fornito da una richiesta precedente. Se questo parametro viene specificato, la risposta include solo i record oltre il contrassegno, fino al valore specificato da `MaxRecords`.  
Tipo: String

## Errori
<a name="API_DescribeDBInstances_Errors"></a>

Per informazioni sugli errori comuni a tutte le operazioni, consultare [Errori comuni](CommonErrors.md).

 ** DBInstanceNotFound **   
 `DBInstanceIdentifier`non fa riferimento a un'istanza esistente.   
Codice di stato HTTP: 404

## Vedi anche
<a name="API_DescribeDBInstances_SeeAlso"></a>

Per ulteriori informazioni sull'utilizzo di questa API in una delle lingue specifiche AWS SDKs, consulta quanto segue:
+  [AWS Interfaccia a riga di comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK per.NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK per C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK per Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK per Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK per V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK per Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK per PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK per Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK per Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeDBInstances) 