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á.

# DescribeDBClusters
<a name="API_DescribeDBClusters"></a>

Retorna informações sobre clusters provisionados Amazon DocumentDB. A operação API oferece suporte à paginação. Para determinados atributos de gerenciamento, como o gerenciamento do ciclo de vida de clusters e instâncias, o Amazon DocumentDB aproveita a tecnologia operacional compartilhada com o Amazon RDS e Amazon Neptune. Use o parâmetro de filtro `filterName=engine,Values=docdb` para retornar somente clusters do Amazon DocumentDB.

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

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

 ** DBClusterIdentifier **   
O identificador de cluster fornecido pelo usuário. Se esse parâmetro for especificado, somente as informações do cluster especificado serão retornadas. Esse parâmetro não diferencia maiúsculas de minúsculas.  
Restrições:  
+ Se fornecido, deve corresponder a um `DBClusterIdentifier` existente.
Tipo: string  
Obrigatório: Não

 **Filters.Filter.N**   
Um filtro que especifica um ou mais clusters a serem descritos.  
Filtros com suporte:  
+  `db-cluster-id`- Aceita identificadores de cluster e clusters Amazon Resource Names (ARNs). A lista de resultados inclui apenas informações sobre os clusters identificados por eles 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_DescribeDBClusters_ResponseElements"></a>

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

 **DBClusters. DBClusterN.**   
Uma lista de clusters.  
Tipo: matriz de objetos [DBCluster](API_DBCluster.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_DescribeDBClusters_Errors"></a>

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

 ** DBClusterNotFoundFault **   
 `DBClusterIdentifier` não se refere a um cluster existente.   
Código de status HTTP: 404

## Consulte Também
<a name="API_DescribeDBClusters_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/DescribeDBClusters) 
+  [AWS SDK para .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/docdb-2014-10-31/DescribeDBClusters) 
+  [AWS SDK para C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/docdb-2014-10-31/DescribeDBClusters) 
+  [AWS SDK para Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/docdb-2014-10-31/DescribeDBClusters) 
+  [AWS SDK para Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/docdb-2014-10-31/DescribeDBClusters) 
+  [AWS SDK para JavaScript V3](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/docdb-2014-10-31/DescribeDBClusters) 
+  [AWS SDK para Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/docdb-2014-10-31/DescribeDBClusters) 
+  [AWS SDK para PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/docdb-2014-10-31/DescribeDBClusters) 
+  [AWS SDK para Python](https://docs.aws.amazon.com/goto/boto3/docdb-2014-10-31/DescribeDBClusters) 
+  [AWS SDK para Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/docdb-2014-10-31/DescribeDBClusters)