As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

Retorna informações sobre instâncias do Amazon DocumentDB provisionadas. Essa API dá suporte à paginação.

## Parâmetros da solicitação
<a name="API_DescribeDBInstances_RequestParameters"></a>

 Para obter informações sobre os parâmetros comuns a todas as ações, consulte [Parâmetros Comuns](CommonParameters.md).

 ** DBInstanceIdentifier **   
O identificador da instância fornecido pelo usuário. Se esse parâmetro for especificado, somente as informações da instância específica serão retornadas. Esse parâmetro não diferencia maiúsculas de minúsculas.  
Restrições:  
+ Caso fornecido, deve corresponder ao identificador de um `DBInstance` existente.
Tipo: string  
Obrigatório: Não

 **Filters.Filter.N**   
Um filtro que especifica uma ou mais instâncias a serem descritas.  
Filtros com suporte:  
+  `db-cluster-id`- Aceita identificadores de cluster e clusters Amazon Resource Names (ARNs). A lista de resultados inclui somente as informações sobre as instâncias associadas aos clusters identificados por elas ARNs.
+  `db-instance-id`- Aceita identificadores de instância e instância ARNs. A lista de resultados inclui somente as informações sobre as instâncias identificadas por elas ARNs.
Tipo: matriz de objetos [Filter](API_Filter.md)  
Obrigatório: não

 ** Marker **   
Um token de paginação opcional fornecido por uma solicitação anterior. Se esse parâmetro for especificado, a resposta incluirá apenas os registros além do marcador, até o valor especificado por `MaxRecords`.  
Tipo: string  
Obrigatório: Não

 ** MaxRecords **   
 O número máximo de registros a serem incluídos na resposta. Se existirem mais registros que o valor `MaxRecords` especificado, um token de paginação (marcador) será incluído na resposta para que os resultados restantes possam ser recuperados.  
Padrão: 100  
Restrições: mínimo de 20, máximo de 100.  
Tipo: número inteiro  
Obrigatório: Não

## Elementos de Resposta
<a name="API_DescribeDBInstances_ResponseElements"></a>

Os seguintes elementos são retornados pelo serviço.

 **DBInstances. DBInstanceN.**   
: informações detalhadas sobre uma ou mais instâncias.   
Tipo: matriz de objetos [DBInstance](API_DBInstance.md)

 ** Marker **   
Um token de paginação opcional fornecido por uma solicitação anterior. Se esse parâmetro for especificado, a resposta incluirá apenas os registros além do marcador, até o valor especificado por `MaxRecords`.  
Tipo: string

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

Para obter informações sobre os erros comuns a todas as ações, consulte [Erros comuns](CommonErrors.md).

 ** DBInstanceNotFound **   
 `DBInstanceIdentifier` não se refere a uma instância existente.   
Código de status HTTP: 404

## Consulte Também
<a name="API_DescribeDBInstances_SeeAlso"></a>

Para obter mais informações sobre como usar essa API em uma das linguagens específicas AWS SDKs, consulte o seguinte:
+  [AWS Interface de linha de comando V2](https://docs.aws.amazon.com/goto/cli2/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeDBInstances) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeDBInstances)